mirror of
https://github.com/tiennm99/loto.git
synced 2026-10-13 22:16:07 +00:00
tiennm99
7840aa419d
Replace the native Kotlin/Compose port with a Capacitor 8 wrapper around
the upstream loto SvelteKit PWA. Loto is consumed as a git submodule and
its static build is bundled into the APK at sync time. The wrapper has
no INTERNET permission, so fully offline is enforced rather than
conventional.
- loto/ submodule pinned to dfb1c1e
- android/ scaffolded by cap add android; signing wired via env vars
- All 184 voice MP3s + service worker bundled in assets/public/
- CI checkouts submodule, runs npm build, then Gradle inside android/
- Native port preserved in git history at e7fb3d0 and 8b8d46e
151 lines
4.1 KiB
Markdown
151 lines
4.1 KiB
Markdown
# Lô tô — Android (Capacitor wrapper)
|
|
|
|
|
|
|
|
Fully-offline Android wrapper around [tiennm99/loto](https://github.com/tiennm99/loto)
|
|
(SvelteKit PWA). All assets — HTML, JS, CSS, and 184 voice MP3s — are bundled
|
|
into the APK at build time. No network is required at runtime.
|
|
|
|
> **Note:** the previous native Kotlin/Compose port lives in git history at
|
|
> commit `9a35686` and earlier. This repo is now a thin wrapper; loto evolves
|
|
> upstream and we just rebuild + ship.
|
|
|
|
## How it works
|
|
|
|
```
|
|
loto/ (git submodule, pinned SHA)
|
|
└── npm run build → loto/build/ (SvelteKit static output)
|
|
↓
|
|
npx cap sync
|
|
↓
|
|
android/app/src/main/assets/public/ (bundled into APK)
|
|
↓
|
|
WebView serves https://localhost/* off-disk
|
|
```
|
|
|
|
Capacitor's bridge serves the bundled site from `https://localhost`, which is
|
|
loopback only (no INTERNET permission requested). Workbox precache, IndexedDB,
|
|
and the `<audio>` element all work offline.
|
|
|
|
## Stack
|
|
|
|
- Capacitor 8 (Android wrapper)
|
|
- Loto upstream: SvelteKit 2 + Vite 7 + `@sveltejs/adapter-static` + `@vite-pwa/sveltekit`
|
|
- minSdk 24 · targetSdk 36 · JDK 17 · Node 20
|
|
|
|
## Setup
|
|
|
|
```bash
|
|
git clone --recurse-submodules https://github.com/tiennm99/loto-android.git
|
|
cd loto-android
|
|
npm ci
|
|
npm run build # builds loto + cap sync into android/
|
|
```
|
|
|
|
If you cloned without `--recurse-submodules`:
|
|
|
|
```bash
|
|
git submodule update --init --recursive
|
|
```
|
|
|
|
## Build
|
|
|
|
### Debug APK
|
|
|
|
```bash
|
|
npm run build # build loto + cap sync (must run after any loto change)
|
|
npm run assemble:debug # → android/app/build/outputs/apk/debug/app-debug.apk
|
|
```
|
|
|
|
### Release AAB + APK (signed)
|
|
|
|
```bash
|
|
export LOTO_KEYSTORE_PATH=$HOME/.android/loto-release.jks
|
|
export LOTO_KEYSTORE_PASSWORD=<store-password>
|
|
export LOTO_KEY_ALIAS=<key-alias>
|
|
export LOTO_KEY_PASSWORD=<key-password>
|
|
|
|
npm run build
|
|
npm run assemble:release
|
|
# → android/app/build/outputs/{apk/release/*.apk, bundle/release/*.aab}
|
|
```
|
|
|
|
### Open in Android Studio
|
|
|
|
```bash
|
|
npx cap open android
|
|
```
|
|
|
|
## Updating loto
|
|
|
|
```bash
|
|
cd loto
|
|
git fetch origin
|
|
git checkout <new-sha>
|
|
cd ..
|
|
git add loto
|
|
npm run build # rebuild + re-sync
|
|
git commit -m "chore: bump loto submodule to <sha>"
|
|
```
|
|
|
|
## Why no INTERNET permission?
|
|
|
|
The whole loto build (HTML, JS, CSS, fonts, manifest, icons, all 184 MP3s)
|
|
ships inside the APK. The WebView loads from `https://localhost`, which is
|
|
loopback. No remote fetches happen at runtime, so the permission is omitted —
|
|
this makes "fully offline" a hard guarantee, not a convention.
|
|
|
|
If you ever add a remote feature (analytics, sync, etc.), add this back to
|
|
`android/app/src/main/AndroidManifest.xml`:
|
|
|
|
```xml
|
|
<uses-permission android:name="android.permission.INTERNET" />
|
|
```
|
|
|
|
## CI / CD
|
|
|
|
| Workflow | Trigger | Result |
|
|
|----------|---------|--------|
|
|
| `build-debug` | push to `main`, any PR | unsigned debug APK uploaded as artifact |
|
|
| `release` | tag `v*.*.*` | signed AAB + APK attached to GH Release |
|
|
|
|
Both workflows checkout the loto submodule, install npm deps, build loto,
|
|
`cap sync`, then run Gradle inside `android/`.
|
|
|
|
### GitHub Secrets (release only)
|
|
|
|
| Secret | Description |
|
|
|--------|-------------|
|
|
| `KEYSTORE_BASE64` | `base64 -w0 loto-release.jks` |
|
|
| `KEYSTORE_PASSWORD` | Keystore password |
|
|
| `KEY_ALIAS` | Key alias |
|
|
| `KEY_PASSWORD` | Key password |
|
|
|
|
**Never commit `*.jks`, `*.keystore`, or `.env`.**
|
|
|
|
Tag a release:
|
|
|
|
```bash
|
|
git tag v1.0.0
|
|
git push origin v1.0.0
|
|
```
|
|
|
|
## Version bump
|
|
|
|
1. Edit `versionCode` and `versionName` in `android/app/build.gradle`.
|
|
2. Commit, tag, push.
|
|
|
|
## App ID
|
|
|
|
`com.miti99.loto` — set in `capacitor.config.json` and `android/app/build.gradle`.
|
|
|
|
## Audio
|
|
|
|
Bundled by upstream loto under `loto/static/audio/{hoai-my,nam-minh}/{1..90,cho,kinh}.mp3`,
|
|
served by the wrapper from `https://localhost/audio/...`. No audio post-processing
|
|
on the Android side.
|
|
|
|
## License
|
|
|
|
Same license as upstream [`tiennm99/loto`](https://github.com/tiennm99/loto).
|