anton/cardy
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

capgo and adk autoupdates. card tags

Browse Source
This commit is contained in:
azykov@mail.ru
2026-09-29 19:36:08 +03:00
parent 1981d976eb
commit b6fb2fe40f
43 changed files with 1329 additions and 54 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+38
View File
@@ -45,6 +45,44 @@ pnpm --filter @cardy/mobile-client build:android # web build for Capacitor + c
Then open `mobile-client/android` in Android Studio (or `gradlew assembleDebug` there) to build the APK.
The app registers `cardy://login?...` links (key QR codes) and asks for camera access when scanning.
### Live updates (no APK reinstall)
The APK contains the web build and works fully offline. Newer web builds are delivered over the air
(`@capgo/capacitor-updater` in manual mode, no Capgo cloud, telemetry disabled):
```bash
pnpm --filter @cardy/mobile-client publish:android # build + zip into mobile-client/updates/android
```
The mobile-client server on :10003 serves it at `https://dev.aggtaa.com/m/android/version.json`.
On launch and on every return to the foreground (when online) the app checks it, downloads a newer
bundle in the background and reloads into it on the card list; on a card or in the editor it waits
(`next()`: applied on backgrounding). A bundle that fails to start is rolled back automatically.
Versions come from the build time (`2026.929.151230` = 2026-09-29 15:12:30 UTC).
### APK self-update (native part changed)
Changes to the native part (plugins, `AndroidManifest.xml`, Java code) need a new APK:
```bash
pnpm --filter @cardy/mobile-client publish:android-apk # signed release APK into mobile-client/updates/android
```
It needs `mobile-client/android/keystore.properties` (copy `keystore.properties.example`, not committed)
with the release key. `versionCode` is the build time (`yyDDDHHmm`, UTC), `versionName` the web version.
Installed apps show "A new version of the app is available" on the card list; Install downloads the
APK and hands it to Android's installer (first time: allow "Install unknown apps" for Cardy, then
confirm the system dialog). Web updates published after an APK release require that APK or newer.
All builds (also Android Studio debug builds) are signed with the release key, so they can replace
each other. An app signed with another key (e.g. the old debug key) must be uninstalled once.
### Live reload during development
`pnpm --filter @cardy/mobile-client android:dev` (with `pnpm --filter @cardy/mobile-client dev` running
and a device connected via adb) installs an app that loads the dev server through `adb reverse`.
Run `build:android` again before building an APK for real use.
`server-be` listens on `127.0.0.1` by default because `/admin/*` trusts `Remote-Email`.
If the proxy runs on another machine, set `HOST` and `ADMIN_PROXY_SECRET`, and make the proxy add
`X-Cardy-Proxy-Secret` on the `/api/admin` route.