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

1.8 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 (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):

589d1627df72ec84e56a85dbfe257c123ded094b6708997da6b9bd18a2d7fbaf

Physical validation remains pending. No phone or 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.