syoul
43b733b439
- Script build-apk-simple.sh mis à jour avec auto-installation Java 21 + Android SDK - GUIDE_APK.md créé avec documentation complète - Instructions pour distribution aux bêta-testeurs - APK prêt: dist/compagnon-lagon-beta.apk (4,5 MB)
162 lines
3.9 KiB
Markdown
162 lines
3.9 KiB
Markdown
# 📱 Guide de génération de l'APK Android
|
|
|
|
Ce guide explique comment générer l'APK de **Compagnon du Lagon** pour la distribution aux bêta-testeurs.
|
|
|
|
## 🚀 Méthode rapide (Recommandée)
|
|
|
|
### 1. Lancer le script automatisé
|
|
|
|
```bash
|
|
cd "/home/syoul/Ccompagnon Marama"
|
|
./scripts/build-apk-simple.sh
|
|
```
|
|
|
|
Le script va :
|
|
- ✅ Installer automatiquement SDKMAN si nécessaire
|
|
- ✅ Installer Java 21 (requis par Capacitor)
|
|
- ✅ Installer Android SDK (cmdline-tools)
|
|
- ✅ Build Next.js en mode export statique
|
|
- ✅ Configurer Capacitor
|
|
- ✅ Générer l'APK Android
|
|
|
|
**⏱️ Durée :** ~15-20 minutes la première fois (téléchargement SDK), puis 2-3 minutes pour les builds suivants.
|
|
|
|
### 2. Récupérer l'APK
|
|
|
|
L'APK sera disponible dans :
|
|
```
|
|
dist/compagnon-lagon-beta.apk
|
|
```
|
|
|
|
**📊 Taille :** ~4,5 MB
|
|
|
|
## 📤 Distribution aux bêta-testeurs
|
|
|
|
### Option 1 : Envoi direct du fichier
|
|
|
|
1. **Envoyer par email/messagerie**
|
|
- Envoyez le fichier `dist/compagnon-lagon-beta.apk`
|
|
- Via Email, WhatsApp, Telegram, etc.
|
|
|
|
2. **Instructions pour les testeurs**
|
|
```
|
|
1. Télécharger le fichier APK
|
|
2. Ouvrir les Paramètres Android
|
|
3. Sécurité > Activer "Sources inconnues"
|
|
4. Ouvrir le fichier APK téléchargé
|
|
5. Appuyer sur "Installer"
|
|
```
|
|
|
|
### Option 2 : Hébergement web temporaire
|
|
|
|
1. **Via transfert.sh** (gratuit, temporaire)
|
|
```bash
|
|
curl --upload-file dist/compagnon-lagon-beta.apk https://transfer.sh/compagnon.apk
|
|
```
|
|
Vous recevrez un lien à partager (valide 14 jours).
|
|
|
|
2. **Via Google Drive/Dropbox**
|
|
- Upload `dist/compagnon-lagon-beta.apk`
|
|
- Partager le lien public
|
|
- Les testeurs téléchargent et installent
|
|
|
|
### Option 3 : Serveur local (testeurs sur même réseau)
|
|
|
|
```bash
|
|
cd dist
|
|
python3 -m http.server 8080
|
|
```
|
|
|
|
Les testeurs peuvent télécharger à l'adresse :
|
|
```
|
|
http://[VOTRE_IP]:8080/compagnon-lagon-beta.apk
|
|
```
|
|
|
|
## 🔄 Mettre à jour l'APK
|
|
|
|
Pour générer une nouvelle version après des modifications :
|
|
|
|
```bash
|
|
# 1. Modifier le code
|
|
# 2. Relancer le build
|
|
./scripts/build-apk-simple.sh
|
|
|
|
# 3. L'APK sera mis à jour dans dist/
|
|
```
|
|
|
|
## 🛠️ Configuration requise (Installation automatique)
|
|
|
|
Le script installe automatiquement :
|
|
- ✅ **SDKMAN** : Gestionnaire de SDK Java
|
|
- ✅ **Java 21** : Requis par Capacitor
|
|
- ✅ **Android SDK** : Platform-tools, Build-tools 34.0.0
|
|
- ✅ **Node.js packages** : Capacitor, dépendances
|
|
|
|
**Note :** Pas besoin de sudo, tout s'installe dans `~/.sdkman` et `~/Android/Sdk`.
|
|
|
|
## 📝 Notes importantes
|
|
|
|
### Données statiques
|
|
L'APK contient toutes les données en **statique** (JSON dans `public/data/`).
|
|
Pour mettre à jour les données :
|
|
1. Modifier les fichiers JSON
|
|
2. Rebuild l'APK
|
|
3. Redistribuer la nouvelle version
|
|
|
|
### Signature APK (Debug vs Release)
|
|
|
|
**APK Debug** (actuel) :
|
|
- ✅ Parfait pour les bêta-tests
|
|
- ✅ Signature automatique
|
|
- ❌ Ne peut pas être publié sur Play Store
|
|
|
|
**APK Release** (pour production) :
|
|
```bash
|
|
# Générer un keystore
|
|
keytool -genkey -v -keystore compagnon-release.keystore \
|
|
-alias compagnon -keyalg RSA -keysize 2048 -validity 10000
|
|
|
|
# Builder en mode release
|
|
cd android
|
|
./gradlew assembleRelease
|
|
```
|
|
|
|
## 🐛 Dépannage
|
|
|
|
### Erreur "Java not found"
|
|
```bash
|
|
source "$HOME/.sdkman/bin/sdkman-init.sh"
|
|
sdk use java 21.0.1-tem
|
|
```
|
|
|
|
### Erreur "ANDROID_HOME not set"
|
|
```bash
|
|
export ANDROID_HOME="$HOME/Android/Sdk"
|
|
```
|
|
|
|
### Erreur "Gradle daemon stopped"
|
|
```bash
|
|
cd android
|
|
./gradlew --stop
|
|
./gradlew clean assembleDebug
|
|
```
|
|
|
|
### APK vide / sans contenu
|
|
- Vérifier que `out/` contient les fichiers HTML
|
|
- Vérifier `public/data/*.json` sont présents
|
|
- Rebuild avec `npm run build` avant Capacitor
|
|
|
|
## 📞 Support
|
|
|
|
En cas de problème, vérifier :
|
|
1. Les logs du script : `./scripts/build-apk-simple.sh`
|
|
2. Les logs Gradle : `android/build/reports/`
|
|
3. Le contenu de `out/` après build Next.js
|
|
|
|
---
|
|
|
|
**Version** : 1.0.0 - Novembre 2025
|
|
**App ID** : `com.pensionmarama.app`
|
|
**Nom** : Compagnon du Lagon - Pension Marama
|
|
|