99 lines
2.3 KiB
Markdown
99 lines
2.3 KiB
Markdown
# Android App Installation Guide
|
|
|
|
This guide explains how to install the Android app on an emulator or physical device.
|
|
|
|
## Prerequisites
|
|
|
|
- Android emulator or physical device connected via ADB
|
|
- Java installed (for bundletool)
|
|
- ADB installed and configured
|
|
|
|
## Installation
|
|
|
|
### Using the Yarn Script
|
|
|
|
The easiest way to install the app is to use the provided yarn script:
|
|
|
|
```bash
|
|
# Set the device ID (emulator or physical device)
|
|
export DEVICE=emulator-5554
|
|
|
|
# Run the installation script
|
|
yarn install:android
|
|
```
|
|
|
|
### Manual Installation
|
|
|
|
If you need to install the app manually, follow these steps:
|
|
|
|
1. Navigate to the bundle release directory:
|
|
```bash
|
|
cd android/app/build/outputs/bundle/release
|
|
```
|
|
|
|
2. Build APKs with signing:
|
|
```bash
|
|
java -jar /opt/bundletool-all-1.17.1.jar build-apks \
|
|
--mode universal \
|
|
--bundle ./app-release.aab \
|
|
--output ./app.apks \
|
|
--ks /home/jo/lab/alerte-secours/as-app/android/app/debug.keystore \
|
|
--ks-pass pass:android \
|
|
--ks-key-alias androiddebugkey \
|
|
--key-pass pass:android
|
|
```
|
|
|
|
3. Convert .apks to .zip and extract:
|
|
```bash
|
|
mv app.apks app.zip
|
|
unzip -o app.zip
|
|
```
|
|
|
|
4. Install the APK on the device:
|
|
```bash
|
|
adb -s $DEVICE install universal.apk
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
### Finding Available Devices
|
|
|
|
To list all available devices:
|
|
|
|
```bash
|
|
adb devices
|
|
```
|
|
|
|
Example output:
|
|
```
|
|
List of devices attached
|
|
emulator-5554 device
|
|
```
|
|
|
|
### Common Issues
|
|
|
|
1. **No devices found**: Make sure your emulator is running or your physical device is connected and has USB debugging enabled.
|
|
|
|
2. **Installation fails**: Check if the app is already installed. You might need to uninstall it first:
|
|
```bash
|
|
adb -s $DEVICE uninstall com.alertesecours
|
|
```
|
|
|
|
3. **Signing issues**: If you encounter signing problems, make sure the keystore path is correct and the keystore passwords match.
|
|
|
|
## Custom Installation Script
|
|
|
|
A custom installation script (`install-android.sh`) has been created to simplify the installation process. This script:
|
|
|
|
1. Checks if the DEVICE environment variable is set
|
|
2. Navigates to the bundle release directory
|
|
3. Builds APKs with signing
|
|
4. Converts .apks to .zip and extracts it
|
|
5. Installs the APK on the device
|
|
|
|
You can run this script directly:
|
|
|
|
```bash
|
|
export DEVICE=emulator-5554
|
|
./install-android.sh
|
|
```
|