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


Ce guide explique comment distribuer des APK aux testeurs à l'aide de la CLI Firebase. L'outil CLI vous permet de spécifier des testeurs et les notes de version d'un build, puis le distribue en conséquence.

Avant de commencer

Si vous ne l'avez pas déjà fait, ajoutez Firebase à votre projet.

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, assurez-vous d'effectuer toutes les étapes indiquées sur la page dont le lien figure ci-dessus.

Étape 1 : Créer votre application

Lorsque vous êtes prêt à distribuer une version préliminaire de votre application aux testeurs, Créez votre APK à l'aide du processus normal. 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 l'élément 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 binaire autonome pour la CLI spécifique à votre système d'exploitation). Assurez-vous de vous connecter et vérifiez que vous pouvez accéder à votre projets.
  2. Sur la page App Distribution de la console Firebase, sélectionnez l'application que vous souhaitez distribuer, puis cliquez sur Commencer.

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

    options appdistribution:distribute
    --app

    Obligatoire: ID de l'application Firebase de votre application. Vous trouverez l'application ID dans la console Firebase, sur le Généralités page des paramètres.

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

    Un jeton d'actualisation qui est affiché lorsque vous authentifiez votre CI. à l'aide de la CLI Firebase (lecture Utiliser la CLI avec l'intégration continue systèmes pour en savoir plus). 

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

    Notes de version de ce build

    Vous pouvez spécifier les notes de version directement:

    --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 la forme d'une liste d'adresses e-mail séparées par des virgules. adresses:

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

    Vous pouvez également spécifier le chemin d'accès à un fichier en 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 (voir Gérer les testeurs) Les groupes sont spécifiés à l'aide d'alias de groupe que vous pouvez consultez la console Firebase.

    Vous pouvez spécifier les groupes sous la forme d'une liste d'éléments séparés par une virgule:

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

    Vous pouvez également spécifier le chemin d'accès à un fichier en 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 imprimer la sortie détaillée du journal.
    --test-devices
    --test-devices-file

    Les types de distribution suivants font partie de la fonctionnalité bêta des testeurs automatisés.

    Les appareils de test sur lesquels vous souhaitez distribuer des builds (reportez-vous à Tests automatisés, par exemple).

    Vous pouvez spécifier les testeurs sous la forme d'une liste d'adresses e-mail séparées par des virgules. adresses:

    --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 d'appareils de test séparés par une virgule :

    --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 de 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 "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 l'utilisation de la connexion automatique lors des tests automatisés.
    --test-non-blocking

    Exécuter des tests automatisés de manière asynchrone. Accédez à la console Firebase pour consulter 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

    Une fois la version importée, la CLI Firebase génère les liens suivants. Ces liens vous permettent de gérer les binaires et de vous assurer que les testeurs et autres les développeurs ont la bonne version:

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

    Gérer les testeurs et les groupes

    En plus de distribuer des versions, vous pouvez 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 les ajouter à des versions individuelles. Lorsque vous supprimez 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 afin de spécifier un groupe pour le 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 que vous avez distribué votre build, il est disponible dans le tableau de bord App Distribution de la console Firebase pendant 150 jours (cinq mois). Lorsque 30 jours avant l'expiration du build, un avis d'expiration s'affiche dans la console et la liste des versions du 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 se lancer, et les testeurs existants reçoivent des notifications par e-mail qu'un nouveau build est prêt à être testé (consultez le guide de configuration pour les testeurs pour savoir comment installer le test application). 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'un délai de cinq jours avant l'expiration d'une invitation est écoulé, un avis d'expiration s'affiche dans la Console Firebase à côté du testeur sur une version. Une invitation peut être renouvelé en le renvoyant à l'aide du menu déroulant sur la ligne du testeur.

Étapes suivantes