74 lines
2.8 KiB
Markdown
74 lines
2.8 KiB
Markdown
# Mobile Store Artifacts
|
|
|
|
The `Mobile Store Artifacts` workflow builds signed Android and iOS store artifacts from the Vue/Vite web app through Capacitor.
|
|
|
|
Use the Capacitor project under `android/` for the Google Play Store package. The Bubblewrap/TWA files at the repository root are not the path used by `mobile:android:bundle`.
|
|
|
|
## Triggers
|
|
|
|
- Manual: run `Mobile Store Artifacts` from GitHub Actions and optionally provide `version_name` and `version_code`.
|
|
- Tag: push a tag named `mobile-vX.Y.Z`; the workflow uses `X.Y.Z` as the store version name.
|
|
- Automatic Android Play Store artifact: after the `Automated Tests` workflow completes successfully on `master`, GitHub Actions builds and uploads a signed Android App Bundle from the tested commit.
|
|
|
|
## Required Secrets
|
|
|
|
Android:
|
|
|
|
- `ANDROID_KEYSTORE_BASE64`
|
|
- `ANDROID_KEYSTORE_PASSWORD`
|
|
- `ANDROID_KEY_ALIAS`
|
|
- `ANDROID_KEY_PASSWORD`
|
|
|
|
iOS:
|
|
|
|
- `IOS_CERTIFICATE_BASE64`
|
|
- `IOS_CERTIFICATE_PASSWORD`
|
|
- `IOS_PROVISION_PROFILE_BASE64`
|
|
- `IOS_KEYCHAIN_PASSWORD`
|
|
- `APPLE_TEAM_ID`
|
|
|
|
## Local Checks
|
|
|
|
Run the native permission validation after changing Capacitor, native manifests, or store metadata:
|
|
|
|
```sh
|
|
npm run mobile:permissions:check
|
|
```
|
|
|
|
Build a local unsigned Android App Bundle for packaging verification:
|
|
|
|
```sh
|
|
npm run mobile:android:bundle:unsigned
|
|
```
|
|
|
|
Build a signed Play Console upload bundle after exporting the Android upload-key variables:
|
|
|
|
```sh
|
|
export ANDROID_KEYSTORE_FILE=/path/to/upload-key.jks
|
|
export ANDROID_KEYSTORE_PASSWORD=...
|
|
export ANDROID_KEY_ALIAS=...
|
|
export ANDROID_KEY_PASSWORD=...
|
|
npm run mobile:android:bundle
|
|
```
|
|
|
|
The signed Android bundle is written to:
|
|
|
|
```text
|
|
android/app/build/outputs/bundle/release/app-release.aab
|
|
```
|
|
|
|
Android artifacts use package id `io.truckwash.twa`. iOS artifacts use bundle id `io.truckwash.app`.
|
|
|
|
The Android project currently targets SDK 36. Google Play requires new apps and updates to target Android 15/API 35 or higher starting August 31, 2025: https://developer.android.com/google/play/requirements/target-sdk
|
|
|
|
Play Store graphics are generated in the workspace-level `playstoregraphics/` folder:
|
|
|
|
- App icon: `playstoregraphics/universal/app-icon/truck-wash-icon-512.png`
|
|
- Feature graphic: `playstoregraphics/universal/feature-graphic/truck-wash-feature-1024x500.jpg`
|
|
- Phone screenshots: `playstoregraphics/phone/screenshots/`
|
|
- 7-inch tablet screenshots: `playstoregraphics/tablet-7/screenshots/`
|
|
- 10-inch tablet screenshots: `playstoregraphics/tablet-10/screenshots/`
|
|
- Chromebook screenshots: `playstoregraphics/chromebook/screenshots/`
|
|
|
|
The native manifests declare camera and foreground location access for the store binaries. Keep the App Store Connect and Play Console privacy questionnaires aligned with the app's actual camera and location data handling before submitting a release.
|