diff --git a/.gitignore b/.gitignore index 8a25feaf..c421cb41 100644 --- a/.gitignore +++ b/.gitignore @@ -51,6 +51,7 @@ faceclaw_settings*.json # Developer configs .devenv* .direnv/ +.android/ devenv.local.nix local.properties build_paths.sh diff --git a/docs/validation-device-preferences.md b/docs/validation-device-preferences.md new file mode 100644 index 00000000..ba348433 --- /dev/null +++ b/docs/validation-device-preferences.md @@ -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.