Distribuez des applications iOS aux testeurs à l'aide de la CLI Firebase

Vous pouvez distribuer des versions 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 publication pour une version, et distribue la version en conséquence.

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

  1. Installez ou mettez à jour la dernière version de la CLI Firebase (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 de tester que vous pouvez accéder à vos projets.
  2. Sur la page App Distribution de la console Firebase, sélectionnez l'application que vous souhaitez distribuer, puis cliquez sur Get started .

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

    appdistribution:options de distribution
    --app

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

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

    Un jeton d'actualisation imprimé lorsque vous authentifiez votre environnement CI avec la CLI Firebase (consultez Utiliser la 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 directement les notes de version :

    --release-notes "Text of release notes"

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

    --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"

    Vous pouvez également 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.ipa  \
    --app 1:1234567890:ios:0a1b2c3d4e5f67890  \
    --release-notes "Bug fixes and improvements" --testers-file testers.txt

    La CLI Firebase génère les liens suivants après le téléchargement de la version. Ces liens vous aident à gérer les fichiers binaires et à vous assurer que les testeurs et autres développeurs disposent de la bonne version :

    • firebase_console_uri - Un lien vers la console Firebase affichant une seule version. Vous pouvez partager ce lien avec d'autres développeurs de votre organisation.
    • testing_uri - Un lien vers la version dans l'expérience du testeur (clip Web iOS) qui permet aux testeurs d'afficher les notes de version et d'installer l'application sur leur appareil. Le testeur doit avoir accès à la version pour utiliser le lien.
    • binary_download_uri - Un lien signé qui télécharge et installe directement le binaire de l'application (fichier IPA). Le lien expire après 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'aura plus accès aux versions de votre projet. Notez que les testeurs récemment supprimés peuvent toujours accéder à 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 des testeurs en utilisant --file /path/to/testers.txt .

    Si vous avez un grand nombre de testeurs, vous devriez envisager 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 appdistribution:testers:add et appdistribution:testers:remove .

    Par 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 devient disponible dans le tableau de bord App Distribution de la console Firebase pendant 150 jours (cinq mois). Lorsque la version arrive à expiration dans 30 jours, un avis d'expiration s'affiche à 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 e-mail pour commencer, et les testeurs existants reçoivent des notifications par e-mail indiquant qu'une nouvelle version est prête à être testée. Pour savoir comment installer l'application de test, consultez Se configurer en tant que testeur . 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 son expiration. Lorsqu'une invitation est à 5 jours de l'expiration, 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.

Prochaines étapes