Google 致力于为黑人社区推动种族平等。查看具体举措

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

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

Avant que tu commences

Si vous avez pas déjà, ajoutez Firebase à votre projet iOS .

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 une archive de distribution signée. Vous pouvez utiliser votre processus de génération normal tant que vous remplissez les conditions suivantes :

  • Pour distribuer votre application au-delà de votre équipe de développement, vous devez utiliser un profil de distribution ad hoc ou votre profil de distribution d'entreprise.
  • Si votre application utilise Game Center, APNs (et par extension, messagerie cloud ), ou iCloud, assurez - vous que votre profil d' approvisionnement utilise un code d'application explicite, et non un identifiant générique.
  • Si vous utilisez un profil de distribution Ad Hoc, incluez les ID d'appareil uniques (UDID) des appareils de vos testeurs. Au fur et à mesure que les nouveaux testeurs iOS s'inscrivent à votre programme de test, vous devrez mettre à jour le profil de provisionnement avec les UDID de leurs appareils. Voir d' enregistrement des périphériques de testeur supplémentaires .
  • Si vous avez apporté des modifications de code depuis la dernière construction (qui est, vous n'êtes pas en train de reconstruire seulement de mettre à jour les appareils enregistrés), mettez à jour le numéro de version cible build visible par l' utilisateur (Version) et le numéro de build unique (construction).

Une fois la construction terminée, elle enregistre un fichier IPA et des fichiers journaux dans le dossier que vous spécifiez. Vous distribuez le fichier IPA à vos testeurs au cours des étapes suivantes.

Étape 2. Distribuez votre application aux testeurs

Pour distribuer votre application aux testeurs, importez le fichier IPA à 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:ios: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 example:

    firebase appdistribution:distribute test.ipa  \
        --app 1:1234567890:ios:0a1b2c3d4e5f67890  \
        --release-notes "Bug fixes and improvements" --testers-file 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.

Étape 3. Enregistrer des appareils supplémentaires

Lorsque les testeurs acceptent une invitation à tester une version non signée avec un profil d'entreprise, on leur demande la permission de partager l'identifiant de leur appareil avec vous. S'ils sont d'accord, App Distribution collecte l'UDID de l'appareil et vous en informe par e-mail.

Lorsque vous recevez l'un de ces e-mails, mettez à jour votre profil d'approvisionnement avec l'UDID et distribuez une nouvelle version à vos testeurs en procédant comme suit :

  1. Ajoutez les appareils à votre portail développeur Apple.
    • Option 1: importer l'appareil UDID en tant que fichier CSV.

      Dans l'onglet Groupes et testeurs du tableau de bord de distribution App, sélectionnez Tous les testeurs, puis cliquez sur Exporter d' Apple UDID pour télécharger un fichier CSV. Ensuite, importez le fichier dans votre compte développeur d' Apple en utilisant l'option Enregistrer des périphériques multiples. Reportez - vous à la documentation d'Apple pour en savoir plus.

      Notez que votre compte développeur Apple peut ne vous permettre d'importer qu'un nombre limité d'appareils par an.

    • Option 2: Collect et entrez les UDID par e - mail.

      Sur la Ajouter des périphériques page du portail développeur Apple, enregistrer le nouveau UDID spécifié dans l'e - mail que vous avez reçu.

  2. Ajoutez les périphériques enregistrés à votre profil d' approvisionnement .
  3. Téléchargez le profil d'approvisionnement et utilisez-le pour reconstruire votre application. Si vous reconstruisez uniquement pour mettre à jour les appareils enregistrés, ne mettez pas à jour le numéro de build ou la version.
  4. Redistribuer votre application à partir de la console Firebase ou CLI. Si vous avez déjà distribué une build avec le même numéro de build et la même version, seuls les utilisateurs des appareils nouvellement enregistrés reçoivent des e-mails de notification.