Expand documentation for native-activity sample. #1157

DanAlbert · 2025-09-25T22:13:33Z

This expands the docs and comments in the native-activity sample to be something closer to a proper guide. There isn't a very clear flow to it since the documentation is necessarily spread out into multiple files, and sometimes the order of the code requires explaining things out of order, but it's better than nothing.

If we wanted to turn this into an actual guide that could be written in a clear order without duplicating code snippets into the docs, which would surely be quickly out of date, we could use something like sphinx (possibly through readthedocs) to generate something closer to a literate code sample.

This screenshot is no longer accurate, and I don't think it's useful anyway, so I'm deleting it rather than updating it.

native-activity/README.md

native-activity/app/src/main/AndroidManifest.xml

native-activity/app/src/main/cpp/CMakeLists.txt

This expands the docs and comments in the native-activity sample to be something closer to a proper guide. There isn't a very clear flow to it since the documentation is necessarily spread out into multiple files, and sometimes the order of the code requires explaining things out of order, but it's better than nothing. If we wanted to turn this into an actual guide that could be written in a clear order without duplicating code snippets into the docs, which would surely be quickly out of date, we could use something like sphinx (possibly through readthedocs) to generate something closer to a literate code sample.

Remove obsolete screenshot.

58be68a

This screenshot is no longer accurate, and I don't think it's useful anyway, so I'm deleting it rather than updating it.

DanAlbert requested a review from enh-google September 25, 2025 22:13

DanAlbert enabled auto-merge (rebase) September 25, 2025 22:13