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
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
and the plugin runs monolith. Either rebuild with the property, or add
`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.debuggableRelease` | | `false` | Make the release build debuggable |
Prefer the `-P` form for `mobilegl.buildDisaggregated`: the plugin's two Gradle scripts read the
environment fallback differently.
A `-P` property wins over its environment variable. The plugin's Gradle scripts and the library's script
all read the `MOBILEGL_BUILD_DISAGGREGATED` and `MOBILEGL_BUILD_DISAGGREGATED_INPROC` fallbacks.
## 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
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
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
editor.