Compagnon-du-Lagon---Marama/GUIDE_APK.md

📱 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é

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)

   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)

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 :

# 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) :

# 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"

source "$HOME/.sdkman/bin/sdkman-init.sh"
sdk use java 21.0.1-tem

Erreur "ANDROID_HOME not set"

export ANDROID_HOME="$HOME/Android/Sdk"

Erreur "Gradle daemon stopped"

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