feat(android): an App Bundle for Google Play, and the listing for Play and F-Droid #48

Merged
dawid merged 5 commits from google-play into main 2026-11-18 08:34:31 +00:00
Owner

The Android app made ready for Google Play and F-Droid.

Google Play

  • tools/build-android.sh builds the App Bundle (.aab) along with the APK. release.yml checks the bundle's certificate against the release key (with keytool, the same SHA-256 as the APK) and attaches wristmark-vX.Y.Z.aab to the release. CI's android job builds the debug bundle too.
  • docs/dev/google-play.md covers the account and the testing requirement (12 testers for 14 days, personal accounts created after 2023-11-13), creating the app, app signing (recommended: give Play a copy of our release key, so Play's app and our APK can update each other), the build requirements (target API 36 meets the Aug 31, 2026 rule), the listing, the App content answers (data safety: nothing collected; E2E-encrypted and on-device data are out of scope per Google's page), the closed test, and likely review findings.

Listing, shared by both stores: fastlane/metadata/android/en-US/

  • title.txt, short_description.txt, full_description.txt. A test checks the stores' limits and one line per paragraph. The texts name no watch maker.
  • images/icon.png: 512×512 RGBA, from tools/generate-icon.mjs, which can now write RGBA.
  • images/featureGraphic.jpg: 1024×500, the hero scaled, from viewer/tools/render-hero.mjs. The hero itself re-renders identically.
  • Kept out of LFS in .gitattributes, because F-Droid clones without it.
  • Phone screenshots are for the owner to take, into images/phoneScreenshots/.

F-Droid

  • WRISTMARK_HANDS=off tools/build-app-web.sh leaves MediaPipe's prebuilt WebAssembly and model out (3.2 MB instead of 25 MB) and adds a meta tag. The viewer then hides the hand button, and H and ?hands do nothing. A new end-to-end test checks this; it fails without the change.
  • The F-Droid section of docs/dev/android.md now has a table of what's ready and what's open (the public source, the review), and a recipe: Node.js 24 fetched and checksummed, since Capacitor's CLI needs 22 or later; MediaPipe deleted after npm ci; scandelete for node_modules.
  • Signatures: F-Droid's APK has F-Droid's key and no hand tracking, so the doc says people pick one source.
  • The fdroidserver self-hosting paragraph is dropped, as decided.

Checks: markdownlint, ESLint, shellcheck, generate-icon --check, the content tests, and both hand-tracking e2e tests in Playwright's image. The keytool fingerprint parsing was checked on a jar signed with a throwaway key. Not tested: a real bundleRelease (only on a tag), and the F-Droid recipe on F-Droid's servers.

The Android app made ready for Google Play and F-Droid. **Google Play** - `tools/build-android.sh` builds the App Bundle (`.aab`) along with the APK. `release.yml` checks the bundle's certificate against the release key (with `keytool`, the same SHA-256 as the APK) and attaches `wristmark-vX.Y.Z.aab` to the release. CI's android job builds the debug bundle too. - `docs/dev/google-play.md` covers the account and the testing requirement (12 testers for 14 days, personal accounts created after 2023-11-13), creating the app, app signing (recommended: give Play a copy of our release key, so Play's app and our APK can update each other), the build requirements (target API 36 meets the Aug 31, 2026 rule), the listing, the App content answers (data safety: nothing collected; E2E-encrypted and on-device data are out of scope per Google's page), the closed test, and likely review findings. **Listing, shared by both stores:** `fastlane/metadata/android/en-US/` - `title.txt`, `short_description.txt`, `full_description.txt`. A test checks the stores' limits and one line per paragraph. The texts name no watch maker. - `images/icon.png`: 512×512 RGBA, from `tools/generate-icon.mjs`, which can now write RGBA. - `images/featureGraphic.jpg`: 1024×500, the hero scaled, from `viewer/tools/render-hero.mjs`. The hero itself re-renders identically. - Kept out of LFS in `.gitattributes`, because F-Droid clones without it. - Phone screenshots are for the owner to take, into `images/phoneScreenshots/`. **F-Droid** - `WRISTMARK_HANDS=off tools/build-app-web.sh` leaves MediaPipe's prebuilt WebAssembly and model out (3.2 MB instead of 25 MB) and adds a meta tag. The viewer then hides the hand button, and H and `?hands` do nothing. A new end-to-end test checks this; it fails without the change. - The F-Droid section of `docs/dev/android.md` now has a table of what's ready and what's open (the public source, the review), and a recipe: Node.js 24 fetched and checksummed, since Capacitor's CLI needs 22 or later; MediaPipe deleted after `npm ci`; `scandelete` for `node_modules`. - Signatures: F-Droid's APK has F-Droid's key and no hand tracking, so the doc says people pick one source. - The `fdroidserver` self-hosting paragraph is dropped, as decided. Checks: markdownlint, ESLint, shellcheck, `generate-icon --check`, the content tests, and both hand-tracking e2e tests in Playwright's image. The `keytool` fingerprint parsing was checked on a jar signed with a throwaway key. Not tested: a real `bundleRelease` (only on a tag), and the F-Droid recipe on F-Droid's servers.
feat(android): an App Bundle for Google Play, and the listing for Play and F-Droid
Some checks failed
CI / checks (pull_request) Successful in 18s
CI / android (pull_request) Successful in 2m11s
CI / relay (pull_request) Successful in 1m32s
CI / e2e (pull_request) Successful in 1m59s
CI / image (pull_request) Successful in 55s
CI / watch (pull_request) Has been cancelled
76eec8f1e0
tools/build-android.sh builds the .aab with the APK; the release checks its certificate and
attaches wristmark-vX.Y.Z.aab. fastlane/metadata/android/en-US/ holds the listing both stores
read: texts (a test keeps them within the limits), the 512 px icon (generate-icon.mjs, RGBA)
and the feature graphic (render-hero.mjs, JPEG), outside LFS. WRISTMARK_HANDS=off builds the
app without MediaPipe's prebuilt files for F-Droid; the viewer then hides the hand button.
docs/dev/google-play.md: account, signing, listing, app content, closed test; the F-Droid
section of docs/dev/android.md: what is ready and the recipe.
docs(android): the Play Console's option for our own signing key, and the pepk command
Some checks failed
CI / checks (pull_request) Has been cancelled
CI / e2e (pull_request) Has been cancelled
CI / relay (pull_request) Has been cancelled
CI / image (pull_request) Has been cancelled
CI / watch (pull_request) Has been cancelled
CI / android (pull_request) Has been cancelled
33c9480228
docs(android): pepk as the console shows it, the password asked for
All checks were successful
CI / relay (pull_request) Successful in 1m33s
CI / checks (pull_request) Successful in 35s
CI / e2e (pull_request) Successful in 1m54s
CI / image (pull_request) Successful in 55s
CI / android (pull_request) Successful in 2m11s
CI / watch (pull_request) Successful in 2m51s
e60c80c2cc
docs(android): the F-Droid recipe's license is GPL-3.0-only, as package.json says
Some checks failed
CI / checks (pull_request) Has been cancelled
CI / e2e (pull_request) Has been cancelled
CI / relay (pull_request) Has been cancelled
CI / image (pull_request) Has been cancelled
CI / watch (pull_request) Has been cancelled
CI / android (pull_request) Has been cancelled
132511a022
fix(android): the app's license GPL-3.0-only, as the viewer's and the recipe's
All checks were successful
CI / checks (pull_request) Successful in 18s
CI / relay (pull_request) Successful in 48s
CI / image (pull_request) Successful in 56s
CI / e2e (pull_request) Successful in 4m9s
CI / watch (pull_request) Successful in 2m49s
CI / android (pull_request) Successful in 2m11s
be6743a3c2
dawid merged commit a36f97b2cc into main 2026-11-18 08:34:31 +00:00
dawid deleted branch google-play 2026-11-18 08:34:32 +00:00
Sign in to join this conversation.
No description provided.