Skip to content

CI_CD.md

Latest commit

 

History

History
217 lines (162 loc) · 5.4 KB

CI_CD.md

File metadata and controls

217 lines (162 loc) · 5.4 KB
Raw

🚀 CI/CD - TableMaster Mobile

GitHub Actions Workflow

Ce repo utilise GitHub Actions pour compiler et builder l'app Flutter automatiquement.

📋 Workflow: .github/workflows/flutter.yml

Déclenché:

  • ✅ Chaque push sur main
  • ✅ Chaque pull_request vers main

Actions exécutées:

  1. 🔧 Setup Flutter 3.38.9
  2. 📦 Restaure les dépendances (flutter pub get)
  3. 🔍 Analyse Dart (flutter analyze)
  4. 📋 Produit le rapport flutter pub outdated
  5. 🧪 Lance les tests Flutter et le contrôle de format
  6. 🔎 Injecte la release et le DSN Sentry dans les builds production
  7. 📱 Build Web Release
  8. 🤖 Build APK signé avec une clé stable fournie par GitHub Secrets
  9. 🔐 Produit les sommes SHA-256
  10. 💾 Publie les artefacts et la GitHub Release versionnée

Durée: ~5-7 minutes

📦 Artefacts

Après chaque run, les artefacts sont disponibles dans Actions → [Run] → Artifacts:

flutter-builds/

build/web/
├── index.html
├── main.dart.js
├── main.dart.js.map
└── assets/
    ├── fonts/
    ├── packages/
    └── ...

Utilisation:

# Servir localement:
python -m http.server --directory build/web/

# Déployer sur Netlify/Vercel:
netlify deploy --prod --dir build/web/

La même archive de workflow contient :

tablemaster-prod.apk
tablemaster-web-prod.zip
SHA256SUMS
CHANGELOG.md
flutter-dependencies-report.txt

Utilisation:

  • 📱 Installer sur Android: adb install app-release.apk
  • 📤 Télécharger sur Firebase App Distribution
  • 🏪 Beta testing avant Google Play

La release GitHub contient également les résultats JSON/log des tests afin de relier l'APK au run CI qui l'a validé.

🔍 View Logs

  1. Aller à Actions sur GitHub
  2. Cliquer sur le workflow Flutter Build CI
  3. Cliquer sur le run
  4. Voir les logs complets de chaque step

🛠️ Troubleshooting

❌ Workflow ne s'exécute pas

Vérifier:

  • ✅ Workflow activé: Actions → ... → Enable workflows
  • ✅ Branches main et develop existent
  • ✅ Fichier .github/workflows/flutter.yml existe

❌ Flutter build échoue

Relancer localement:

flutter clean
flutter pub get
flutter build apk --release

Vérifier les dépendances:

flutter pub outdated
flutter pub upgrade

Voir les erreurs détaillées:

flutter build apk --release -v

❌ Build trop lent (timeout)

  • Le build APK peut prendre 200+ secondes
  • GitHub Actions timeout par défaut: 360 minutes (6h) - pas de problème
  • Si vraiment trop lent, augmenter timeout-minutes dans le workflow

🚀 Déploiement

Option 1: Firebase App Distribution (Beta Testing)

- name: Deploy to Firebase
  uses: wzieba/Firebase-Distribution-Github-Action@v1
  if: success()
  with:
    serviceCredentialsFile: ./credentials.json
    file: build/app/outputs/flutter-apk/app-release.apk
    groups: testers
    releaseNotes: "Build ${{ github.run_number }}"

Ajouter credentials.json dans Settings → Secrets → Actions

Option 2: Google Play Console (Production)

- name: Deploy to Google Play
  uses: r0adkll/upload-google-play@v1
  if: success()
  with:
    serviceAccountJsonPlainText: ${{ secrets.GOOGLE_PLAY_KEY }}
    packageName: com.tablemaster.app
    releaseFiles: build/app/outputs/bundle/release/app-release.aab
    track: beta  # ou 'production' après tests

Option 3: Netlify (Web App)

- name: Deploy Web to Netlify
  uses: nwtgck/actions-netlify@v2.1
  if: success()
  with:
    publish-dir: build/web/
    production-branch: main
  env:
    NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
    NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }}

📊 Build Sizes

Target Size Temps
Web ~50 MB (total avec assets) 63s
APK 58 MB 205s
AAB ~45 MB 200s
Linux ~100 MB 150s

📱 Platforms Actuellement Buildés

✅ Web (HTML5/JavaScript) ✅ Android (APK distribué directement)

⚠️ iOS - Non buildé sur Linux (nécessite macOS) ⚠️ AAB / Play Store - Non retenu pour la distribution actuelle ⚠️ Linux Desktop - Non généré par la CI actuelle ⚠️ Windows - Non buildé (nécessite Windows) ⚠️ macOS - Non buildé (nécessite macOS)

Pour iOS/Windows/macOS, créer des workflows séparés sur macOS/Windows runners.

🔐 Secrets Nécessaires

Pour le déploiement automatique, ajouter à Settings → Secrets and variables → Actions:

SENTRY_DSN_FLUTTER       # DSN du projet Sentry Flutter
ANDROID_KEYSTORE_BASE64  # Keystore stable encodé en base64
ANDROID_KEY_ALIAS        # Alias de la clé
ANDROID_STORE_PASSWORD   # Mot de passe du keystore
ANDROID_KEY_PASSWORD     # Mot de passe de la clé

Le DSN Sentry n'est pas stocké dans config/prod.json : le workflow .github/workflows/flutter.yml le passe à flutter build web et flutter build apk avec --dart-define=SENTRY_DSN=....

📚 Ressources

Mis à jour: 7 mai 2026