✅ Checklist Installation Android - Becik¶

Utilisez cette checklist pour vérifier que tout est correctement installé et configuré.

📦 Installation des Packages¶

[x] Capacitor core installé (@capacitor/core)
[x] Capacitor CLI installé (@capacitor/cli)
[x] Plateforme Android ajoutée (@capacitor/android)
[x] Plugin App installé (@capacitor/app)
[x] Plugin Splash Screen installé (@capacitor/splash-screen)
[x] Plugin Status Bar installé (@capacitor/status-bar)

# Vérifier les packages installés
pnpm list @capacitor/core @capacitor/cli @capacitor/android @capacitor/app @capacitor/splash-screen @capacitor/status-bar

⚙️ Configuration du Projet¶

[x] capacitor.config.ts créé et configuré
[x] next.config.ts mis à jour avec output: 'export'
[x] Scripts npm ajoutés dans package.json:
android:build
android:open
android:run
[x] Dossier android/ versionné dans Git (non ignoré)
[x] Fichier capacitor.assets.json créé

# Vérifier la configuration
ls -la capacitor.config.ts android/ .gitignore

🔒 Checklist sécurité (humains + Copilot)¶

À vérifier avant chaque commit/push (surtout depuis Android Studio):

[ ] Ne jamais committer android/local.properties (chemin SDK local)
[ ] Ne jamais committer un keystore (*.jks, *.keystore, becik-release-key.keystore)
[ ] Vérifier android/gradle.properties : pas de secrets (tokens/mots de passe)
[ ] google-services.json : commit uniquement si on le veut explicitement (Firebase)
[ ] Les dossiers android/**/build/ et android/.gradle/ doivent rester ignorés

🛠️ Outils Système¶

[ ] Java JDK 11+ installé
[ ] Android Studio installé
[ ] Android SDK installé
[ ] Variable ANDROID_HOME configurée
[ ] Variables PATH configurées

# Vérifier Java
java -version

# Vérifier Android Home
echo $ANDROID_HOME

# Vérifier les outils Android
which adb
which sdkmanager

Installation des outils système¶

Si non installés, exécutez:

./scripts/setup-android.sh

📱 Premier Build¶

[ ] Build Next.js réussi
[ ] Dossier out/ créé
[ ] Sync Capacitor réussi
[ ] Dossier android/ existe
[ ] Projet ouvre dans Android Studio

# Test complet
pnpm android:run

📄 Documentation¶

[x] Guide complet créé (ANDROID_BUILD.md)
[x] Quick Start créé (ANDROID_QUICKSTART.md)
[x] Documentation plugins (CAPACITOR_PLUGINS.md)
[x] TODO Android créé (TODO_ANDROID.md)
[x] Script de setup créé (scripts/setup-android.sh)
[x] Script de build créé (scripts/build-android.sh)
[x] GitHub Actions workflow créé (.github/workflows/android-build.yml)
[x] Exemple d'initialisation Capacitor (src/lib/capacitor-init.ts)
[x] Composant exemple (src/components/capacitor-example.tsx)

🎨 Assets (À faire avant release)¶

[ ] Icône app 512x512 créée (public/icon-512.png)
[ ] Splash screen créé (public/splash.png)
[ ] Génération des assets: pnpm exec cap-assets generate --android

🔐 Configuration Release (À faire avant publication)¶

[ ] Keystore créé (becik-release-key.keystore)
[ ] Fichier android/key.properties configuré
[ ] Mots de passe sauvegardés en lieu sûr
[ ] Version incrémentée dans android/app/build.gradle

✨ Test de Fonctionnement¶

Test 1: Build Debug APK¶

cd android
./gradlew assembleDebug
ls -lh app/build/outputs/apk/debug/app-debug.apk

Test 2: Lancer sur émulateur¶

# Lister les émulateurs
emulator -list-avds

# Lancer un émulateur
emulator -avd Pixel_5_API_30 &

# Attendre le démarrage, puis:
pnpm android:run

Test 3: Installer APK sur appareil¶

# Connecter un appareil en USB (mode développeur activé)
adb devices

# Installer l'APK
adb install android/app/build/outputs/apk/debug/app-debug.apk

🐛 Dépannage¶

Erreur "ANDROID_HOME not set"¶

export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools

Erreur "Java version"¶

# Installer Java 17
sudo apt install openjdk-17-jdk  # Linux
brew install openjdk@17          # macOS

Erreur "Gradle sync failed"¶

cd android
./gradlew --stop
./gradlew clean
cd ..
pnpm cap sync android

Dossier "out" manquant¶

pnpm build

📊 Status du Projet¶

Date d'installation: $(date +%Y-%m-%d)

Composant	Status	Notes
Capacitor Core	✅ Installé	v8.0.1
Plateforme Android	✅ Configurée	-
Outils système	⏳ À installer	Voir scripts/setup-android.sh
Premier build	⏳ À tester	pnpm android:run
Documentation	✅ Complète	Voir ANDROID_*.md

📚 Prochaines Étapes¶

Installer les outils système
Exécuter ./scripts/setup-android.sh
Installer Android Studio manuellement
Faire le premier build
Exécuter pnpm android:run
Tester dans Android Studio
Personnaliser l'app
Créer les icônes et splash screen
Configurer les couleurs et le thème
Préparer la publication
Créer le keystore
Tester sur plusieurs appareils
Préparer les assets du Play Store

🎯 Commandes de Référence Rapide¶

# Development
pnpm dev                          # Développement web
pnpm build                        # Build Next.js
pnpm android:run                  # Build + ouvrir Android Studio

# Build
pnpm android:build                # Build + sync
cd android && ./gradlew assembleDebug      # APK debug
cd android && ./gradlew bundleRelease      # AAB release

# Synchronisation
pnpm cap sync android             # Sync après changements
pnpm cap copy android             # Copier assets web seulement

# Scripts
./scripts/setup-android.sh        # Installer outils système
./scripts/build-android.sh debug  # Build automatique debug
./scripts/build-android.sh release # Build automatique release

# Debug
adb devices                       # Lister appareils connectés
adb logcat | grep Becik          # Voir les logs
chrome://inspect                  # Debugger web dans Chrome

Support: Voir ANDROID_BUILD.md pour la documentation complète

Issues: Pour tout problème, consultez ANDROID_QUICKSTART.md section dépannage