Files
faceclaw/docs/validation-device-preferences.md
T

2.0 KiB

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:

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 (115,876,494 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):

091ced145d499ec00aa03cbea60f5cec7a2167e459896c4b5b45211e1c9a7e8a

The updated APK also passes ELF LOAD/RELRO and ZIP alignment checks for 16 KiB pages; see 16 KiB validation.

Glasses validation remains pending. The APK was installed on a Pixel 10 Pro Fold, which currently reports 4096-byte pages. No glasses were used. See the manual procedures for notifications, Android calendars and head-up wake. 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.