User guide: env fallback now read consistently.

This commit is contained in:
2026-10-09 14:29:53 -04:00
parent 0b536de3fb
commit 0650608ddc
3 changed files with 5 additions and 4 deletions
+2 -1
View File
@@ -74,7 +74,8 @@ latency.
The plugin's launcher environment includes `MOBILEGL_TRANSPORT=inproc` **only if** the APK was built The plugin's launcher environment includes `MOBILEGL_TRANSPORT=inproc` **only if** the APK was built
with `-Pmobilegl.buildDisaggregated=ON` or `-Pmobilegl.buildDisaggregatedInproc=ON` passed explicitly with `-Pmobilegl.buildDisaggregated=ON` or `-Pmobilegl.buildDisaggregatedInproc=ON` passed explicitly
(the CI build of `feat/disaggregated` does this). A plain `gradle :app:assemblePluginRelease` (or the matching `MOBILEGL_BUILD_DISAGGREGATED` / `MOBILEGL_BUILD_DISAGGREGATED_INPROC` environment
variable set to `ON`; the CI build of `feat/disaggregated` does this). A plain `gradle :app:assemblePluginRelease`
still builds the split layer into the library, but the launcher environment then omits the transport still builds the split layer into the library, but the launcher environment then omits the transport
and the plugin runs monolith. Either rebuild with the property, or add and the plugin runs monolith. Either rebuild with the property, or add
`MOBILEGL_TRANSPORT=inproc` in the launcher's environment editor. `MOBILEGL_TRANSPORT=inproc` in the launcher's environment editor.
+2 -2
View File
@@ -168,8 +168,8 @@ Pass with `-P<name>=<value>`. Some can also come from an environment variable.
| `mobilegl.apkSuffix` | `MOBILEGL_APK_SUFFIX` | git short hash | Suffix in the APK file name | | `mobilegl.apkSuffix` | `MOBILEGL_APK_SUFFIX` | git short hash | Suffix in the APK file name |
| `mobilegl.debuggableRelease` | | `false` | Make the release build debuggable | | `mobilegl.debuggableRelease` | | `false` | Make the release build debuggable |
Prefer the `-P` form for `mobilegl.buildDisaggregated`: the plugin's two Gradle scripts read the A `-P` property wins over its environment variable. The plugin's Gradle scripts and the library's script
environment fallback differently. all read the `MOBILEGL_BUILD_DISAGGREGATED` and `MOBILEGL_BUILD_DISAGGREGATED_INPROC` fallbacks.
## CMake options ## CMake options
+1 -1
View File
@@ -51,7 +51,7 @@ The renderer string does not mention Espryt or Magma.
- `Config: MOBILEGL_TRANSPORT='unix:...' names a transport ... staying on monolith`: put the endpoint - `Config: MOBILEGL_TRANSPORT='unix:...' names a transport ... staying on monolith`: put the endpoint
in `MOBILEGL_IPC_CONTROL` and set `MOBILEGL_TRANSPORT=spawn`. in `MOBILEGL_IPC_CONTROL` and set `MOBILEGL_TRANSPORT=spawn`.
- The plugin runs monolith in the launcher although you expected `inproc`: the APK was built without - The plugin runs monolith in the launcher although you expected `inproc`: the APK was built without
an explicit `-Pmobilegl.buildDisaggregated=ON`, so its launcher environment has no an explicit `-Pmobilegl.buildDisaggregated=ON` (or `MOBILEGL_BUILD_DISAGGREGATED=ON` in the environment), so its launcher environment has no
`MOBILEGL_TRANSPORT`. Rebuild, or add `MOBILEGL_TRANSPORT=inproc` in the launcher's environment `MOBILEGL_TRANSPORT`. Rebuild, or add `MOBILEGL_TRANSPORT=inproc` in the launcher's environment
editor. editor.