🚀 Quick Start - Build Android pour Becik¶

Guide ultra-rapide pour builder et tester l'app Android.

⚡ En 5 Minutes¶

1. Prérequis (à faire une seule fois)¶

# Installer les outils système (Linux/macOS)
./scripts/setup-android.sh

# Ou manuellement:
# - Installer JDK 17
# - Installer Android Studio
# - Configurer ANDROID_HOME

2. Build & Test¶

# Build complet et ouvrir dans Android Studio
pnpm android:run

# Dans Android Studio:
# 1. Attendre la fin de la synchronisation Gradle
# 2. Sélectionner un émulateur ou appareil
# 3. Cliquer sur Run ▶️

📱 Commandes Essentielles¶

# Development
pnpm android:build      # Build web + sync Android
pnpm android:open       # Ouvrir Android Studio
pnpm android:run        # Build + Open (tout-en-un)

# Build APK Debug (pour tests)
cd android
./gradlew assembleDebug
# APK: android/app/build/outputs/apk/debug/app-debug.apk

# Build AAB Release (pour Play Store)
cd android
./gradlew bundleRelease
# AAB: android/app/build/outputs/bundle/release/app-release.aab

🔑 Première Fois Seulement¶

Créer le Keystore (pour release)¶

keytool -genkey -v -keystore becik-release-key.keystore \
  -alias becik -keyalg RSA -keysize 2048 -validity 10000

Configurer key.properties¶

Créer android/key.properties:

storePassword=VOTRE_STORE_PASSWORD
keyPassword=VOTRE_KEY_PASSWORD
keyAlias=becik
storeFile=../becik-release-key.keystore

🎨 Personnaliser l'App¶

Icône¶

Créer public/icon-512.png (512x512)
Installer: pnpm add -D @capacitor/assets
Générer: pnpm exec cap-assets generate --android

Nom & ID¶

Éditer capacitor.config.ts:

{
  appId: 'com.becik.app',     // ID unique sur Play Store
  appName: 'Becik',            // Nom affiché
}

Version¶

Éditer android/app/build.gradle:

versionCode 1        // Incrémenter pour chaque release
versionName "1.0.0"  // Version affichée aux users

🐛 Problèmes Courants¶

Gradle sync failed¶

cd android
./gradlew --stop
./gradlew clean

App blanche au démarrage¶

Vérifier que pnpm build a créé le dossier out/
Lancer pnpm cap sync android

Java version error¶

# Vérifier version Java
java -version  # Doit être 11+

# Changer de version (Ubuntu)
sudo update-alternatives --config java

📖 Documentation Complète¶

Pour plus de détails: ANDROID_BUILD.md

🎯 Workflow Quotidien¶

# 1. Développer dans le navigateur
pnpm dev

# 2. Tester sur Android quand prêt
pnpm android:run

# 3. Debugger si besoin
# Chrome: chrome://inspect
# Logs: adb logcat | grep Becik

✅ Checklist Release¶

[ ] Version incrémentée dans build.gradle
[ ] Tests sur plusieurs appareils/versions Android
[ ] APK testé en dehors d'Android Studio
[ ] Screenshots et descriptions à jour
[ ] Keystore sauvegardé en lieu sûr
[ ] Build AAB release généré
[ ] Upload sur Play Console

Besoin d'aide? Voir ANDROID_BUILD.md ou la doc Capacitor