Catch up on everthing we announced at this year's Firebase Summit. Learn more

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 des notes de version pour une version, puis distribue la version en conséquence.

Avant que tu commences

Si vous avez pas déjà, 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. Cependant, si vous décidez d'utiliser des produits supplémentaires à l'avenir, assurez-vous de suivre toutes les étapes de la page liée ci-dessus.

Étape 1. Créez votre application

Lorsque vous êtes prêt à distribuer une version préliminaire de votre application aux testeurs, créez votre APK en suivant votre processus normal. Vous devez signer l'APK avec votre clé de débogage ou votre clé de signature d'application.

Étape 2. Distribuez votre application aux testeurs

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

  1. Installer ou mettre à jour à la dernière version de la CLI Firebase (nous vous recommandons de télécharger le fichier 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 à vos projets.
  2. Dans la page de distribution App de la console Firebase, sélectionnez l'application que vous souhaitez distribuer, puis cliquez sur démarrer.
  3. Exécutez le appdistribution:distribute commande pour télécharger votre application et le distribuer aux testeurs. Utilisez les paramètres suivants pour configurer la distribution :

    distribution d'applications:options de distribution
    --app

    Requis: Votre application de Firebase ID App. Vous pouvez trouver l'ID App dans la console Firebase, sur la page Paramètres généraux .

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

    Un rafraîchissement jeton qui est imprimé lorsque vous authentifiez votre environnement de CI avec le CLI Firebase (lire Utilisez le CLI avec les systèmes CI pour plus d' informations).

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

    Notes de version pour cette version.

    Vous pouvez soit spécifier les notes de version directement :

    --release-notes "Text of release notes"

    Ou, spécifiez le chemin d'accès à un fichier texte brut :

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

    Les 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 :

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

    Ou, vous pouvez spécifier le chemin d'accès à un fichier texte contenant une liste d'adresses e-mail séparées par des virgules :

    --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 de 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 des virgules :

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

    Ou, vous pouvez spécifier le chemin d'accès à un fichier texte contenant une liste de noms de groupes séparés par des virgules :

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

    Un indicateur que vous pouvez inclure pour imprimer une sortie de journal détaillée.

    Par exemple:

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

    Outre la distribution de presse, vous pouvez également utiliser appdistribution:testers:add et appdistribution:testers:remove d'inviter de nouveaux testeurs ou supprimer les 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'aura plus accès aux versions de votre projet. Notez que les testeurs qui ont été récemment supprimés peuvent toujours conserver l'accès à vos versions pendant un certain temps.

    Par exemple:

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

    Les e-mails des testeurs doivent être séparés par un espace. Vous pouvez également spécifier les testeurs utilisant --file /path/to/testers.txt .

Une fois que vous distribuez votre build, il devient disponible dans le tableau de bord App Distribution de la console Firebase pendant 150 jours (cinq mois). Lorsque la version expire dans 30 jours, un avis d'expiration apparaît à la fois dans la console et dans la liste des versions 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 courriel pour commencer, et les testeurs existants reçoivent des notifications par courriel qu'une nouvelle version est prêt à tester (lire le jeu testeur en manuel pour obtenir des instructions sur la façon d'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 ont 30 jours pour accepter une invitation à tester l'application avant qu'elle n'expire. Lorsqu'une invitation expire dans 5 jours, un avis d'expiration apparaît dans la console Firebase à côté du testeur sur une version. Une invitation peut être renouvelée en la renvoyant à l'aide du menu déroulant sur la ligne du testeur.