Two separate documentation/packaging defects, both hit by non-developer testers this week.
1. Debug-key signing blocks first launch on OEM ROMs
The Android APK is self-signed with Chromium's checked-in debug keystore (stated in the release notes: "A release keystore is not wired up yet"). On a ZTE/Nubia ROM this produces the vendor App Center refusing the app outright:
DisplayXR Browser has stopped — Can't launch "DisplayXR Browser" due to its own reason, please update the app in App Center or clear app data
A tester hit this on first launch (retrying got past it, but the dialog names neither the real cause nor a real remedy — "update in App Center" is impossible for a sideloaded preview). Ask: wire up a release keystore for the Android lane. Note the release notes already flag that a future release-signed build will not be upgrade-compatible with these debug-signed installs, so the sooner this lands the fewer testers need a manual uninstall.
2. "Requires runtime ≥ v2.14.12" is misleading — the gate is an exact match
preview-0.1.23's notes say:
⚠ Requires runtime ≥ v2.14.12
That reads as a compatibility floor — any newer runtime works. The actual check in the runtime (ipc_client_connection.c::ipc_client_check_git_tag) is strncmp on the git tag: an exact string match. A mismatched pair fails every xrCreateInstance and blacks out all inline-3D while the rest of the browser works normally:
DisplayXR client library version <A> does not match service version <B>
Two testers were sent runtime v2.14.10 with browser preview-0.1.22 and both reported black 3D; the "≥" phrasing is part of why that pairing looked acceptable.
Ask: state the exact runtime version each Android preview is built against, e.g. "Android: requires runtime v2.15.2 exactly — the runtime↔browser IPC check is an exact version match, not a minimum."
Tracking the install-instructions half in DisplayXR/displayxr-runtime#1302.
Two separate documentation/packaging defects, both hit by non-developer testers this week.
1. Debug-key signing blocks first launch on OEM ROMs
The Android APK is self-signed with Chromium's checked-in debug keystore (stated in the release notes: "A release keystore is not wired up yet"). On a ZTE/Nubia ROM this produces the vendor App Center refusing the app outright:
A tester hit this on first launch (retrying got past it, but the dialog names neither the real cause nor a real remedy — "update in App Center" is impossible for a sideloaded preview). Ask: wire up a release keystore for the Android lane. Note the release notes already flag that a future release-signed build will not be upgrade-compatible with these debug-signed installs, so the sooner this lands the fewer testers need a manual uninstall.
2. "Requires runtime ≥ v2.14.12" is misleading — the gate is an exact match
preview-0.1.23's notes say:
That reads as a compatibility floor — any newer runtime works. The actual check in the runtime (
ipc_client_connection.c::ipc_client_check_git_tag) isstrncmpon the git tag: an exact string match. A mismatched pair fails everyxrCreateInstanceand blacks out all inline-3D while the rest of the browser works normally:Two testers were sent runtime v2.14.10 with browser preview-0.1.22 and both reported black 3D; the "≥" phrasing is part of why that pairing looked acceptable.
Ask: state the exact runtime version each Android preview is built against, e.g. "Android: requires runtime v2.15.2 exactly — the runtime↔browser IPC check is an exact version match, not a minimum."
Tracking the install-instructions half in DisplayXR/displayxr-runtime#1302.