solstone-android

Android observers and clients for solstone: watch, phone, and Android accessory surfaces that help the owner's journal receive local, owner-controlled context.

Status

Public beta and hardware-validation repo. The phone observer has a beta distribution path; watch and glasses are installable hardware-validation surfaces over the shared observer harness. The Rogbid Model X validation app remains as a hardware probe target.

Layout

apps/
  validation-rogbid/   Android 9 watch validation app for camera, mic, GPS, QR, PL linking, upload, and battery trials
  watch/               Watch observer app
  phone/               Phone observer app and beta distribution target
  glasses/             Smart-glasses observer app for RV203 hardware validation
core/                  Shared observer/link/domain modules as they graduate from the validation app
platform/              Android framework adapters: camera, audio, location, foreground service, permissions, power
formfactor/            Watch/phone/glasses UI and policy helpers
testing/               Fake sensors, fixtures, and link harnesses
tools/rogbid/          ADB validation scripts for the Rogbid Model X

Install

Prerequisites:

• JDK 17
• Android SDK with API 35
• Android build tools usable by Gradle
• adb on PATH for hardware validation

On the Android build host, load the existing Android environment first:

source ~/android-dev/env.sh
make install

From a development machine with SSH access to an Android build host, the root Makefile can sync the tree and run the same gate remotely:

ANDROID_REMOTE_HOST=host.local make android-host-ci

Build

make assemble-validation-rogbid

The general CI gate also assembles the watch, phone, and glasses debug variants:

make ci

To build on a remote Android host from this checkout:

ANDROID_REMOTE_HOST=host.local make android-host-assemble-validation-rogbid

The APK is produced at:

apps/validation-rogbid/build/outputs/apk/debug/validation-rogbid-debug.apk

Test

make test
make ci

The validation target is intentionally hardware-heavy, so most confidence still comes from the tools/rogbid/* scripts against the physical watch.

Hardware Validation

Default serial is the Rogbid Model X used during the spike:

make validate-rogbid-adb
make validate-rogbid-media
make validate-rogbid-qr
PAIR_LINK='https://link.solpbc.org/p#...' make validate-rogbid-pl

The validation app package is app.solstone.validation.rogbid. Future installable solstone Android artifacts should use the same app.solstone.* namespace.

Hardware Milestones

• RV203 glasses HOME observer milestone

License

AGPL-3.0-only. See LICENSE.