docs: record integrated APK build and software validation

This commit is contained in:
Blendman974 committed 2026-11-06 00:29:41 +01:00
1 parent 61c017a0b0
commit 40cd9eb5ba
2 files changed
+48

No files matched your search

+1
View File
@@ -51,6 +51,7 @@ faceclaw_settings*.json
# Developer configs
.devenv*
.direnv/
.android/
devenv.local.nix
local.properties
build_paths.sh
+47
View File
@@ -0,0 +1,47 @@
# Integrated device preferences
Branch: `integration/device-preferences`. Separate implementation branches are
`feat/notification-filter-default`, `feat/calendar-selection` and
`feat/head-up-wake`. No pull requests were created.
Software validation on Linux/NixOS, 2026-11-06:
- JavaScript/TypeScript suite: 1,059 passed, 3 skipped, 0 failed.
- Shared Kotlin Android host suite: 269 passed, 0 failures/errors.
- TypeScript: `tsc --noEmit` passes.
- oxlint: passes with existing warnings outside the changes.
- Nix tools: Node 22, Java 21, Android SDK 35, both build-tools versions,
adb, host CMake/Ninja and NDK verified. Tested using devenv 2.4.0.
Reproduce with `devenv shell`, then:
```sh
npm ci
npm test
npm run test:kotlin
npx tsc --noEmit
bash lint.sh
bash scripts/check-devenv.sh
bash build.sh
```
The build produces a debug APK for arm64 Android phones. It does not install
the APK or flash firmware. Build output and machine-local signing/SDK files
are ignored by Git.
Final artifact: `dist/faceclaw-device-preferences-debug.apk` (110,299,294 bytes),
package `com.faceclaw.app`, version 0.8.6 (806). Build completed successfully;
APK v2 signature verified with `apksigner`. The packaged JavaScript contains all
three controls, and the DEX contains the new calendar and head-up native APIs.
SHA-256 (also saved alongside the APK):
```text
589d1627df72ec84e56a85dbfe257c123ded094b6708997da6b9bd18a2d7fbaf
```
Physical validation remains pending. No phone or glasses were used. See the
manual procedures for [notifications](validation-notifications.md),
[Android calendars](validation-calendars.md) and [head-up wake](validation-head-up.md).
In particular, successful BLE encoding and simulated ACK/reconnect tests do
not establish physical wake/angle behavior on a target Faceclaw firmware.
The iOS calendar-selection port is deferred.