Firebase App Distribution : concepts clés, distribution d'APK et d'IPA et configuration
Firebase App Distribution est un service Google permettant de distribuer des versions préliminaires d'applications mobiles à des testeurs et des équipes internes sans avoir à les publier dans les magasins d'applications. App Distribution fournit une interface unifiée pour le téléchargement de fichiers APK et IPA, la gestion de groupes de testeurs et la collecte de commentaires. Selon Firebase Documentation, 2026, le service notifie automatiquement les testeurs des nouvelles versions par e-mail et notifications push, et l'intégration Fastlane permet de publier des builds directement depuis le pipeline CI/CD sans actions manuelles. App Distribution prend en charge Android (AAB/APK) et iOS (IPA), y compris la distribution ad-hoc et entreprise.
Points clés
- App Distribution — un service Firebase pour distribuer des versions bêta d'applications aux testeurs sans publier sur Google Play ou l'App Store.
- Groupes de testeurs — un système flexible de gestion d'accès : créez des groupes par rôles, projets ou étapes de test avec différentes permissions sur les builds.
- Notifications automatiques — les testeurs reçoivent des notifications par e-mail et push à chaque nouveau build avec un lien d'installation.
- Fastlane + Gradle — intégration complète avec les systèmes CI/CD pour la publication automatique de builds à chaque commit ou pull request.
- Commentaires — les testeurs peuvent envoyer des captures d'écran, des journaux et des commentaires via l'interface intégrée ou Firebase Crashlytics.
Qu'est-ce que Firebase App Distribution
Firebase App Distribution est un service Google permettant de distribuer des versions préliminaires d'applications mobiles aux testeurs et parties prenantes. Contrairement à la publication dans les magasins d'applications, App Distribution permet de livrer des builds à des participants sélectionnés instantanément, sans long processus de révision. Le service est intégré à Firebase Crashlytics, ce qui permet aux développeurs de recevoir des rapports de crash directement des testeurs et de corriger les problèmes avant la publication publique.
Pourquoi utiliser App Distribution
Le processus traditionnel de distribution de versions bêta implique l'envoi manuel de fichiers APK/IPA par e-mail, le téléchargement vers des services de partage de fichiers tiers ou la configuration d'un serveur dédié. Firebase App Distribution résout ces problèmes : un référentiel unifié de builds sur Google Cloud, des notifications automatiques aux testeurs, une gestion centralisée des accès et des commentaires intégrés via Firebase Crashlytics. Le service est indispensable pour les équipes pratiquant le CI/CD et les versions régulières : un nouveau build est disponible pour les testeurs dans la minute suivant le téléchargement.
Formats de build pris en charge
App Distribution prend en charge tous les formats de build standard pour les plateformes mobiles. Pour Android — APK et Android App Bundle (AAB) avec génération automatique d'APK à partir d'AAB lors de l'installation. Pour iOS — fichiers IPA pour distribution ad-hoc, développement et entreprise. Chaque build est accompagné de notes de version, d'un numéro de version et d'un code de build pour le suivi. La taille maximale du fichier téléchargé est de 500 Mo et les builds sont conservés pendant 150 jours.
Téléchargement de builds et gestion des versions
Le téléchargement de builds dans Firebase App Distribution s'effectue via la Firebase Console, la CLI (firebase appdistribution:distribute) ou des outils automatisés comme Fastlane et Gradle. Lors du téléchargement, vous spécifiez la version du build, les notes de version et la liste des testeurs ou groupes devant recevoir une notification. Firebase attribue automatiquement un identifiant unique au build et le rend disponible pour installation via un lien.
Gestion des versions via Firebase Console
Firebase Console fournit une interface web pour le téléchargement de builds et la gestion des versions. La console affiche l'historique de tous les builds téléchargés avec la date, la version, le statut et le nombre d'installations. Un développeur peut désactiver une version spécifique si un bug critique est découvert — cela bloquera l'installation de cette version pour tous les testeurs. La console affiche également un graphique des installations par jour, facilitant le suivi de l'activité de test.
Téléchargement automatique via Firebase CLI
La Firebase CLI permet de télécharger des builds en une seule commande, ce qui est pratique pour l'intégration dans les pipelines CI/CD. La commande distribute accepte un chemin de fichier, un jeton d'accès au projet, une liste de groupes de testeurs et des notes de version optionnelles. L'authentification utilise un compte de service Firebase avec le rôle Administrateur Firebase App Distribution. La CLI prend en charge les builds Android et iOS, détectant automatiquement la plateforme par l'extension du fichier.
bash
# Téléchargement d'un build via Firebase CLI
firebase appdistribution:distribute \
app-release.apk \
--app 1:123456789:android:abc123def456 \
--groups "qa-team,product-owners" \
--release-notes "Bug d'autorisation corrigé" \
--token "FIREBASE_TOKEN"Gestion des testeurs et des groupes
Firebase App Distribution fournit un système flexible de gestion des testeurs : vous pouvez ajouter des participants par e-mail, créer des groupes par rôles ou projets et attribuer différents builds à différents groupes. Lorsqu'un nouveau testeur est ajouté, le système lui envoie un e-mail d'invitation avec des instructions pour installer l'application. Les testeurs reçoivent des notifications automatiques pour chaque nouveau build attribué à leur groupe.
Création de groupes de testeurs
Les groupes permettent d'organiser les testeurs fonctionnellement. Exemples de groupes : Équipe QA (accès complet à tous les builds), Product Owners (accès aux builds stables), Testeurs Externes (accès limité pour les bêta-testeurs externes). Un même testeur peut appartenir à plusieurs groupes. Lors du téléchargement d'un build, le développeur sélectionne les groupes cibles — seuls les membres des groupes sélectionnés reçoivent des notifications, éliminant le bruit informationnel.
Ajout de testeurs via l'API
Pour ajouter des testeurs par programmation, l'API Firebase App Distribution est utilisée. L'API permet de créer des testeurs, de les ajouter à des groupes et de les supprimer si nécessaire. C'est pratique pour l'intégration avec les systèmes internes de gestion de tests et les suiveurs de bogues. Lorsqu'un testeur est ajouté via l'API, il reçoit également un e-mail d'invitation avec un lien pour installer la première application.
js
const admin = require("firebase-admin")
const serviceAccount = require("./serviceAccountKey.json")
admin.initializeApp({ credential: admin.credential.cert(serviceAccount) })
async function addTestersToGroup(email, groupAlias) {
try {
await admin.appDistribution().addTesters(email, [groupAlias])
console.log("Testeur ajouté au groupe")
} catch (error) {
console.error("Erreur :", error)
}
}
addTestersToGroup("tester@example.com", "qa-team")Distribution des builds Android
La distribution des builds Android via Firebase App Distribution prend en charge deux formats : APK et Android App Bundle (AAB). Lors du téléchargement d'un AAB, Firebase génère automatiquement un APK compatible avec l'appareil du testeur en utilisant Google Play App Signing. Les testeurs installent l'application via un lien direct — ils n'ont pas besoin d'accès à Google Play Console, ni d'être ajoutés comme testeurs dans Play Console. Cela simplifie considérablement le processus de test bêta pour Android.
Exigences pour les builds Android
Pour installer via App Distribution, les testeurs doivent activer l'installation depuis des sources inconnues sur leur appareil. Firebase génère automatiquement un lien vers une page web avec un bouton d'installation APK. Pour le format AAB, l'appareil doit prendre en charge Play Core Library et avoir Google Play Store installé. Firebase recommande d'utiliser AAB pour les versions finales et APK pour les itérations rapides.
Configuration Gradle pour App Distribution
Le plugin Firebase App Distribution pour Gradle permet d'envoyer des builds directement depuis une tâche Gradle. La configuration inclut l'ajout du plugin com.google.firebase.appdistribution, la configuration d'un compte de service et la définition des groupes cibles. Après configuration, la tâche assembleDistRelease compilera l'application et la téléchargera dans Firebase App Distribution en une seule commande.
groovy
// build.gradle (module: app)
plugins {
id 'com.android.application'
id 'com.google.firebase.appdistribution'
}
android { // standard config }
firebaseAppDistribution {
appId "1:123456789:android:abc123def456"
serviceCredentialsFile "firebase-sa.json"
groups "qa-team"
releaseNotes "Build automatique"
}Distribution des builds iOS
La distribution des builds iOS via Firebase App Distribution nécessite une configuration supplémentaire car Apple restreint l'installation d'applications en dehors de l'App Store. Pour distribuer des applications iOS, il est nécessaire d'utiliser des certificats ad-hoc ou entreprise du programme Apple Developer. Les testeurs doivent être ajoutés au portail développeur Apple en tant qu'appareils pour la distribution ad-hoc, ou utiliser la distribution entreprise sans limite d'appareils.
Configuration de la distribution ad-hoc
Pour la distribution ad-hoc, vous devez collecter les UDID de tous les appareils des testeurs et les ajouter au portail développeur Apple. Firebase App Distribution montre aux testeurs des instructions pour trouver leur UDID et enregistre automatiquement les appareils enregistrés. Après avoir ajouté l'UDID au profil de provisionnement et compilé l'IPA, les testeurs reçoivent un lien d'installation. Firebase recommande d'utiliser un certificat entreprise pour les projets avec un grand nombre de testeurs, car l'ad-hoc est limité à 100 appareils par compte.
Compilation IPA via Fastlane
Fastlane est l'outil recommandé pour automatiser la compilation d'applications iOS. La lane match gère les certificats et les profils de provisionnement, tandis que la lane sigh crée un IPA pour distribution. Firebase App Distribution s'intègre à Fastlane via le plugin firebase_app_distribution, qui télécharge l'IPA et notifie les testeurs. Fastlane prend également en charge la gestion des versions et les notes de version via des plugins supplémentaires.
ruby
# Fastfile
lane :beta do
match(type: :adhoc)
gym(scheme: "MyApp", export_method: "ad-hoc")
firebase_app_distribution(
app: "1:123456789:ios:abc123def456",
groups: "qa-team",
release_notes: "Build du #\{Time.now.strftime
('%Y-%m-%d %H:%M')}"
)
endIntégration avec CI/CD et Fastlane
L'intégration complète de Firebase App Distribution avec CI/CD permet de publier automatiquement de nouveaux builds à chaque commit dans le référentiel. En configurant un pipeline CI, l'équipe reçoit des commentaires instantanés des testeurs quelques minutes après un push de code. App Distribution prend en charge tous les systèmes CI populaires : GitHub Actions, GitLab CI, Jenkins, Bitrise et CircleCI. Chaque plateforme nécessite sa propre configuration, mais le principe général est le même : compiler → télécharger → notifier.
Configuration via GitHub Actions
GitHub Actions permet de configurer la distribution automatique de builds lors d'un push vers la branche develop ou lors de la création d'une pull request. Le workflow inclut l'installation de Java/Flutter/Node.js, la compilation de l'application, l'authentification via un compte de service Firebase et l'exécution de la Firebase CLI avec la commande distribute. Les secrets (jetons, comptes de service) sont stockés dans GitHub Secrets et ne sont pas exposés dans les journaux de build. Pour iOS, une configuration Xcode et une installation Fastlane dans le workflow sont supplémentaires requises.
yaml
# .github/workflows/distribute.yml
name: Distribute to Firebase
on:
push: { branches: [ develop ] }
jobs:
build-and-distribute:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Java
uses: actions/setup-java@v3
with: { distribution: "temurin", java-version: "17" }
- name: Build APK
run: ./gradlew assembleDebug
- name: Upload to Firebase
uses: wzieba/Firebase-Distribution-GitHub-Action@v1
with:
appId: "${{ secrets.FIREBASE_APP_ID }}"
serviceCredentialsFileContent: "${{ secrets.FIREBASE_SA_KEY }}"
groups: qa-team
file: app/build/outputs/apk/debug/app-debug.apkCollecte des commentaires
Firebase App Distribution s'intègre à Firebase Crashlytics pour la collecte automatique de rapports de crash des testeurs. Crashlytics lie automatiquement un crash à une version de build et un appareil spécifiques, ce qui aide à localiser et corriger rapidement le problème. Les testeurs peuvent également envoyer des captures d'écran et des commentaires via l'interface web d'App Distribution, recevant un lien vers le formulaire de commentaires après l'installation du build.
Foire aux questions
Quelle est la différence entre App Distribution et TestFlight ?
Firebase App Distribution est un service multiplateforme (Android + iOS), contrairement à TestFlight qui fonctionne uniquement pour iOS. App Distribution s'intègre également à Crashlytics et Firebase Analytics, offrant un écosystème unifié pour les tests bêta sur les deux plateformes.
Combien de temps les builds sont-ils conservés dans App Distribution ?
Les builds sont conservés pendant 150 jours à compter de la date de téléchargement. Passé ce délai, ils sont automatiquement supprimés. Il est recommandé de télécharger régulièrement de nouveaux builds et de supprimer manuellement les obsolètes via Firebase Console pour éviter que les testeurs n'installent d'anciennes versions.
Combien de testeurs peuvent être ajoutés ?
Il n'y a pas de limite sur le nombre de testeurs dans Firebase App Distribution. Pour la distribution ad-hoc iOS, la limite Apple de 100 appareils par compte s'applique. Pour la distribution entreprise Android et iOS, il n'y a pas de restrictions sur le nombre de testeurs.
Puis-je télécharger AAB au lieu d'APK pour Android ?
Oui, App Distribution prend en charge AAB (Android App Bundle). Firebase génère automatiquement un APK à partir de l'AAB pour chaque appareil du testeur via Google Play App Signing. C'est particulièrement pratique pour tester avant la publication sur le Play Store.
Firebase App Distribution est-il gratuit ?
Oui, App Distribution est inclus dans le plan Spark gratuit de Firebase. Limites du plan Spark : jusqu'à 500 testeurs et 25 000 installations par mois par projet. Le plan Blaze supprime ces limites et ajoute un support prioritaire.
Résumé
- Firebase App Distribution est un service de distribution de builds bêta d'applications mobiles prenant en charge Android (APK/AAB) et iOS (IPA) sans publication dans les magasins.
- Gestion des testeurs — un système de groupes flexible avec notifications automatiques par e-mail et push à chaque nouveau build.
- Téléchargement de builds via Firebase Console, CLI, plugin Gradle ou Fastlane avec notification automatique aux testeurs.
- Builds Android prennent en charge APK et AAB avec génération automatique d'APK à partir d'AAB, installation par lien direct sans Google Play Console.
- Builds iOS nécessitent un certificat ad-hoc ou entreprise Apple, avec enregistrement UDID et support Fastlane pour l'automatisation de build IPA.
- Intégration CI/CD — GitHub Actions, GitLab CI, Jenkins, Bitrise avec Firebase CLI ou Fastlane pour publication automatique à chaque push.
- Gratuit jusqu'à 500 testeurs et 25 000 installations par mois, builds conservés 150 jours, intégré avec Firebase Crashlytics pour la collecte de rapports de crash.
Nous développerons une application mobile clé en main
IT Sectr crée des applications iOS et Android pour les startups et les entreprises depuis 2017. Nous vous conseillerons et vous proposerons la meilleure solution.
Lisez aussi