Files

T

Unit Tests / test (push) Successful in 11s

Details

Ship Android app by wrapping the web build with Capacitor (#20 ) (#28 )

## Summary
- Closes #20
- Add Capacitor 7 to `llm-fe/` (`capacitor.config.ts`, appId `com.aimloperations.chat`, `webDir: build`) and commit the generated `android/` project
- npm scripts: `build:mobile` (`.env.mobile` + CRA build + `cap sync`), `android:open`, `android:sync`, `assets:generate`
- `.env.mobile` defaults to prod backend; override independently of web deploys
- Native chrome: Android back button (history / exit at root), status bar + keyboard resize, safe-area CSS; Preferences registered for JWT mirror (#22)
- Icons/splash via `@capacitor/assets`; signing via optional `keystore.properties`; docs in `llm-fe/ANDROID.md` + root README

Blockers #22 / #23 / #24 already on master.

## Test plan
- [x] `npm run test:ci` (79 tests)
- [x] `npm run build` + `npx cap add android` / `cap sync`
- [ ] `npm run build:mobile` + open in Android Studio on a machine with SDK
- [ ] Emulator/device QA: login, chat stream, theme, back button, keyboard/safe-area, WS resume
- [ ] Generate upload keystore outside repo; `./gradlew bundleRelease` for internal testing trackReviewed-on: #28

2026-07-26 17:12:48 -07:00

3.2 KiB

Raw Blame History

Hesychia — Android

Native Capacitor project for com.aimloperations.chat. Web UI comes from the CRA build/ output in the parent llm-fe/ package (synced with npx cap sync).

Broader Capacitor notes (env files, icons, QA): ../ANDROID.md.

Prerequisites

Node.js 20
JDK 17+
Android Studio with SDK Platform 35
ANDROID_HOME set, or open this folder once in Android Studio (writes local.properties)

Build the web bundle and sync

From the npm root (llm-fe/, one level up):

cd ..
npm ci
npm run build:mobile    # .env.mobile → react-scripts build → cap sync android

Open this project in Android Studio:

npm run android:open
# or: npx cap open android

Re-sync after changing web code (with an existing build/):

npm run android:sync

Backend URLs are baked in at web-build time via ../.env.mobile (prod by default).

Run on a device / emulator

Android Studio

Sync Gradle when prompted.
Pick an emulator or USB device (enable USB debugging).
Run app.

CLI (debug APK)

./gradlew assembleDebug
adb install -r app/build/outputs/apk/debug/app-debug.apk

Version before a store release

Edit app/build.gradle → defaultConfig:

Field	Rule
`versionName`	User-visible string; keep in sync with `../package.json` `version`
`versionCode`	Integer; must increase for every Play upload

Sign a release build

Do not commit keystores or passwords.

Create an upload keystore (once), outside the repo:

keytool -genkey -v -keystore ~/Documents/secrets/aiml-chat-upload.jks \
  -keyalg RSA -keysize 2048 -validity 10000 \
  -alias aiml-chat-upload

Create keystore.properties in this directory (android/, gitignored):

storeFile=/absolute/path/to/aiml-chat-upload.jks
storePassword=REPLACE_ME
keyAlias=aiml-chat-upload
keyPassword=REPLACE_ME

Build a signed App Bundle:

./gradlew bundleRelease

Output:

app/build/outputs/bundle/release/app-release.aab

Signed APK (if needed):

./gradlew assembleRelease
# → app/build/outputs/apk/release/app-release.apk

Without keystore.properties, release builds are unsigned; debug builds do not need it.

Deploy to Google Play

Play Console → app Hesychia (com.aimloperations.chat).
Complete store listing: privacy policy URL, data-safety form, screenshots.
Testing → Internal testing → create release → upload app-release.aab.
Add testers, roll out internal track, verify on devices.
Promote to closed / open / production only after internal QA passes.

Each new upload needs a higher versionCode.

Useful Gradle tasks

Task	Purpose
`./gradlew assembleDebug`	Debug APK
`./gradlew assembleRelease`	Release APK (signed if props present)
`./gradlew bundleRelease`	Play Store `.aab`
`./gradlew clean`	Clean build outputs

App identity


Application ID	`com.aimloperations.chat`
Display name	Hesychia
Min / target SDK	23 / 35 (see `variables.gradle`)

3.2 KiB Raw Blame History