| .. | ||
| app | ||
| gradle/wrapper | ||
| .gitignore | ||
| app-version.properties | ||
| build.gradle.kts | ||
| capacitor.settings.gradle | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| README.md | ||
| settings.gradle.kts | ||
| variables.gradle.kts | ||
stage-pocket — Android
AIRI mobile app for Android, built with Capacitor.
- Min SDK: 24 (Android 7.0)
- Target SDK: 36 (Android 16)
Prerequisites
- Node.js 18+
- Android Studio (includes JDK and Android SDK)
- Android SDK Platform 36 (install via Android Studio → SDK Manager)
- Android SDK Build-Tools (install via Android Studio → SDK Manager)
Set the following environment variables:
ANDROID_HOME=C:/Users/<you>/AppData/Local/Android/Sdk
JAVA_HOME=C:/Program Files/Android/Android Studio/jbr
Gradle requires Java 21. The JBR bundled with Android Studio works. Without
JAVA_HOMEset, Gradle may fall back to an older system Java and fail withinvalid source release: 21.
Development
First-time setup
Install dependencies from the repo root:
pnpm install
Run on a device / emulator
Open the project in Android Studio:
pnpm dev:android -- target <CAPACITOR_DEVICE_ID>
# Or
CAPACITOR_DEVICE_ID_ANDROID=<CAPACITOR_DEVICE_ID> pnpm dev:android
Updating app icons and splash screens
Source assets live in ../resources/:
| File | Purpose |
|---|---|
icon-only.png |
App icon, 1024×1024, no background |
icon-foreground.png |
Adaptive icon foreground layer, 1024×1024 |
splash.png |
Splash screen, 2732×2732 |
The icon background color is white (#FFFFFF), defined in app/src/main/res/values/ic_launcher_background.xml.
To regenerate all Android icon and splash sizes after updating the source assets:
# from apps/stage-pocket/
npx @capacitor/assets@3.0.5 generate --android \
--iconBackgroundColor "#FFFFFF" \
--iconBackgroundColorDark "#000000" \
--splashBackgroundColor "#FFFFFF" \
--splashBackgroundColorDark "#000000"
This overwrites all files under app/src/main/res/mipmap-*/ and app/src/main/res/drawable-*/.
After running, verify that
mipmap-anydpi-v26/ic_launcher.xmlandic_launcher_round.xmlstill reference@color/ic_launcher_background(not@mipmap/ic_launcher_background). The tool sometimes writes an incorrect reference — restore withgit checkoutif needed.
Notes
app/src/main/assets/public/andapp/src/main/assets/capacitor.config.jsonare generated bycap syncand gitignored.local.properties(SDK path) is machine-specific and gitignored.org.gradle.java.homeshould not be added togradle.properties— remove it if Android Studio adds it automatically.