Distribuer des applications Android aux testeurs à l'aide de la CLI Firebase


Ce guide explique comment distribuer des APK aux testeurs à l'aide de l'interface de ligne de commande Firebase. L'outil CLI vous permet de spécifier des testeurs et des notes de version pour une compilation, puis de distribuer la compilation en conséquence.

Avant de commencer

Si ce n'est pas déjà fait, ajoutez Firebase à votre projet Android.

Si vous n'utilisez aucun autre produit Firebase, il vous suffit de créer un projet et d'enregistrer votre application. Toutefois, si vous décidez d'utiliser d'autres produits à l'avenir, veillez à suivre toutes les étapes de la page indiquée ci-dessus.

Étape 1 : Créer votre application

Lorsque vous êtes prêt à distribuer une version préliminaire de votre application à des testeurs, compilez votre APK en suivant votre procédure habituelle. Vous devez signer l'APK avec votre clé de débogage ou votre clé de signature d'application.

Étape 2 : Distribuer votre application aux testeurs

Pour distribuer votre application aux testeurs, importez le fichier de votre application à l'aide de la CLI Firebase :

  1. Installez la dernière version de la CLI Firebase ou appliquez la mise à jour correspondante (nous vous recommandons de télécharger le fichier binaire autonome de la CLI spécifique à votre OS). Assurez-vous de vous connecter et de vérifier que vous pouvez accéder à vos projets.

  2. Exécutez la commande appdistribution:distribute pour importer votre application et la distribuer aux testeurs. Utilisez les paramètres suivants pour configurer la distribution :

    Options de appdistribution:distribute
    --app

    Obligatoire : ID d'application Firebase de votre application. Vous trouverez l'ID de l'application dans la console Firebase, sur la page Paramètres généraux.

    --app 1:1234567890:android:0a1b2c3d4e5f67890
    --token

    Jeton d'actualisation affiché lorsque vous authentifiez votre environnement d'intégration continue avec la CLI Firebase (pour en savoir plus, consultez Utiliser la CLI avec les systèmes d'intégration continue ). 

    --token "$FIREBASE_TOKEN"
    --release-notes
    --release-notes-file

    Notes de version pour ce build.

    Vous pouvez spécifier directement les notes de version :

    --release-notes "Text of release notes"

    Vous pouvez également spécifier le chemin d'accès à un fichier en texte brut :

    --release-notes-file "/path/to/release-notes.txt"
    --testers
    --testers-file

    Adresses e-mail des testeurs que vous souhaitez inviter.

    Vous pouvez spécifier les testeurs sous forme de liste d'adresses e-mail séparées par une virgule :

    --testers "ali@example.com, bri@example.com, cal@example.com"

    Vous pouvez également spécifier le chemin d'accès à un fichier texte brut contenant une liste d'adresses e-mail séparées par une virgule :

    --testers-file "/path/to/testers.txt"
    --groups
    --groups-file

    Les groupes de testeurs que vous souhaitez inviter (consultez Gérer les testeurs). Les groupes sont spécifiés à l'aide d'alias de groupe, que vous pouvez rechercher dans la console Firebase.

    Vous pouvez spécifier les groupes sous forme de liste séparée par une virgule :

    --groups "qa-team, trusted-testers"

    Vous pouvez également spécifier le chemin d'accès à un fichier texte brut contenant une liste de noms de groupes séparés par une virgule :

    --groups-file "/path/to/groups.txt"
    --debug

    Indicateur que vous pouvez inclure pour afficher une sortie de journal détaillée.
    --test-devices
    --test-devices-file

    Les types de distribution suivants font partie de la fonctionnalité bêta du testeur automatique.

    Les appareils de test sur lesquels vous souhaitez distribuer les builds (consultez Tests automatisés).

    Vous pouvez spécifier les testeurs sous forme de liste d'adresses e-mail séparées par une virgule :

    --test-devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait"

    Vous pouvez également spécifier le chemin d'accès à un fichier texte brut contenant une liste de dispositifs de test séparés par des points-virgules :

    --test-devices-file: "/path/to/test-devices.txt"
    --test-username

    Nom d'utilisateur pour la connexion automatique à utiliser lors des tests automatisés.
    --test-password
    --test-password-file

    Mot de passe pour la connexion automatique à utiliser lors des tests automatisés.

    Vous pouvez également spécifier le chemin d'accès à un fichier en texte brut contenant un mot de passe :

    --test-password-file: "/path/to/test-password.txt"
    --test-username-resource

    Nom de ressource du champ de nom d'utilisateur pour la connexion automatique à utiliser lors des tests automatisés.
    --test-password-resource

    Nom de ressource du champ de mot de passe pour la connexion automatique à utiliser lors des tests automatisés.
    --test-non-blocking

    Exécutez des tests automatisés de manière asynchrone. Consultez la console Firebase pour obtenir les résultats des tests automatiques.

    Exemple :

    firebase appdistribution:distribute test.apk  \
    --app 1:1234567890:android:0a1b2c3d4e5f67890  \
    --release-notes "Bug fixes and improvements" --testers-file testers.txt

    La CLI Firebase génère les liens suivants après l'importation de la version. Ces liens vous aident à gérer les binaires et à vous assurer que les testeurs et autres développeurs disposent de la version appropriée :

    • firebase_console_uri : lien vers la console Firebase affichant une seule version. Vous pouvez partager ce lien avec d'autres développeurs de votre organisation.
    • testing_uri : lien vers la version dans l'expérience de testeur (application Android native) qui permet aux testeurs de consulter les notes de version et d'installer l'application sur leur appareil. Le testeur doit avoir accès à la version pour pouvoir utiliser le lien.
    • binary_download_uri : lien signé qui télécharge et installe directement le binaire de l'application (fichier APK ou AAB). Le lien expire au bout d'une heure.

    Gérer les testeurs et les groupes

    En plus de distribuer des versions, vous pouvez également utiliser appdistribution:testers:add et appdistribution:testers:remove pour inviter de nouveaux testeurs ou supprimer des testeurs existants de votre projet Firebase.

    Une fois qu'un testeur a été ajouté à votre projet Firebase, vous pouvez l'ajouter à des versions individuelles. Une fois que vous avez supprimé un testeur, il n'a plus accès aux versions de votre projet. Notez que les testeurs récemment supprimés peuvent conserver l'accès à vos versions pendant un certain temps.

    Exemple :

    firebase appdistribution:testers:add anothertester@email.com moretesters@email.com

firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com

    Les adresses e-mail des testeurs doivent être séparées par un espace. Vous pouvez également spécifier des testeurs à l'aide de --file /path/to/testers.txt.

    Si vous avez un grand nombre de testeurs, envisagez d'utiliser des groupes : Vous pouvez utiliser appdistribution:group:create et appdistribution:group:delete pour créer ou supprimer des groupes dans votre projet Firebase.

    Utilisez --group-alias pour spécifier un groupe pour les commandes appdistribution:testers:add et appdistribution:testers:remove.

    Exemple :

    firebase appdistribution:group:create "QA team" qa-team

firebase appdistribution:testers:add --group-alias=qa-team anothertester@email.com moretesters@email.com

firebase appdistribution:testers:remove --group-alias=qa-team anothertester@email.com moretesters@email.com

firebase appdistribution:group:delete qa-team

Une fois votre build distribué, il devient disponible dans le tableau de bord App Distribution de la console Firebase pendant 150 jours (cinq mois). Lorsque la compilation arrive à 30 jours de son expiration, un avis d'expiration s'affiche à la fois dans la console et dans la liste des compilations de votre testeur sur son appareil de test.

Les testeurs qui n'ont pas été invités à tester l'application reçoivent des invitations par e-mail pour commencer. Les testeurs existants reçoivent des notifications par e-mail lorsqu'une nouvelle version est prête à être testée (consultez le guide de configuration des testeurs pour savoir comment installer l'application de test). Vous pouvez surveiller l'état de chaque testeur (s'il a accepté l'invitation et s'il a téléchargé l'application) dans la console Firebase.

Les testeurs disposent de 30 jours pour accepter une invitation à tester l'application avant qu'elle n'expire. Lorsqu'une invitation expire dans cinq jours, un avis d'expiration s'affiche dans la console Firebase à côté du testeur sur une version. Vous pouvez renouveler une invitation en la renvoyant à l'aide du menu déroulant sur la ligne du testeur.

Étapes suivantes