Si vous souhaitez distribuer des builds iOS ad hoc à l'aide d'App Distribution, vous devez suivre ce guide pour enregistrer les appareils de vos testeurs. Un build ad hoc est un build non signé avec un profil Entreprise. Un appareil ne peut installer une build ad hoc que si l'identifiant unique de l'appareil (UDID) est inclus dans le profil de provisionnement de la build.
Lorsqu'un testeur accepte une invitation à tester votre application, App Distribution demande l'autorisation de partager l'identifiant de l'appareil du testeur avec vous, le développeur. Avant de télécharger une version ad hoc, App Distribution demande au testeur d'enregistrer son appareil. Si le testeur enregistre son appareil, App Distribution collecte l'UDID de l'appareil et vous en informe par e-mail.
Lorsque vous recevez un e-mail contenant un UDID, mettez à jour votre profil de provisionnement avec l'UDID et distribuez une nouvelle version à vos testeurs. Vous pouvez exporter manuellement les UDID à l'aide de la console Firebase ou de la CLI Firebase , ou vous pouvez exporter les UDID par programme à l'aide de fastlane .
Exporter manuellement les UDID
- Ajoutez les appareils à votre portail de développeur Apple.
- Option 1 : importez les UDID de l'appareil sous forme de fichier CSV.
Dans l'onglet Testeurs et groupes du tableau de bord App Distribution, sélectionnez Tous les testeurs , puis cliquez sur Exporter les UDID Apple pour télécharger un fichier CSV. Ensuite, importez le fichier dans votre compte de développeur Apple à l'aide de l'option Enregistrer plusieurs appareils . Pour en savoir plus, consultez Distribution de votre application sur les appareils enregistrés .
Notez que votre compte développeur Apple ne peut vous permettre d'importer qu'un nombre limité d'appareils par an.
- Option 2 : Collectez et saisissez les UDID par email.
Sur la page Ajouter des appareils du portail des développeurs Apple, enregistrez le nouvel UDID spécifié dans l'e-mail que vous avez reçu.
- Option 1 : importez les UDID de l'appareil sous forme de fichier CSV.
- Ajoutez les appareils enregistrés à votre profil de provisionnement .
- Téléchargez le profil de provisionnement et utilisez-le pour reconstruire votre application. Si vous effectuez une reconstruction uniquement pour mettre à jour les appareils enregistrés, ne mettez pas à jour le numéro de build ou la version.
- Redistribuez votre application depuis la console Firebase ou la CLI . Si vous ne modifiez pas votre version, votre numéro de build ou le code de votre application, App Distribution ne crée pas de nouvelle version et n'en informera pas les testeurs. 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.
Exporter par programme les UDID à l'aide de Fastlane
Exportez tous les UDID de votre appareil de test sous forme de fichier CSV depuis Fastlane. Par exemple, créez et exécutez une nouvelle voie
download_udids
:lane :download_udids do firebase_app_distribution_get_udids( app: "<your Firebase app ID>", output_file: "<path to output file>", ) end
Importez le ou les UDID dans votre compte de développeur Apple à l'aide de l'option Enregistrer plusieurs appareils . Pour en savoir plus, consultez la documentation d'Apple . Notez que votre compte développeur Apple ne peut vous permettre d'importer qu'un nombre limité d'appareils par an.
Ajoutez les appareils enregistrés à votre profil de provisionnement .
Téléchargez le profil de provisionnement et utilisez-le pour reconstruire votre application. Si vous effectuez une reconstruction uniquement dans le but de mettre à jour les appareils enregistrés, ne mettez pas à jour le numéro de build ou la version.
Redistribuez votre application . Si vous ne modifiez pas votre version, votre numéro de build ou le code de votre application, App Distribution ne crée pas de nouvelle version et n'en informera pas les testeurs. Si vous avez déjà distribué une build avec le même numéro de build et la même version, seuls les utilisateurs d'appareils nouvellement enregistrés recevront des e-mails de notification.
Recevoir des alertes
Recevez des alertes par défaut
Par défaut, Firebase peut envoyer des alertes App Distribution pour les nouveaux enregistrements d'appareils iOS par e-mail.
Pour recevoir des alertes App Distribution via ce mécanisme par défaut, vous devez disposer de l'autorisation firebase.projects.update
. Les rôles suivants incluent cette autorisation requise par défaut : Administrateur Firebase ou Propriétaire ou Éditeur du projet.
Par défaut, chaque membre du projet (qui dispose des autorisations requises pour recevoir des alertes) recevra un e-mail lorsqu'un nouvel appareil iOS sera enregistré.
Activer/désactiver les alertes pour votre propre compte
Pour votre propre compte, vous pouvez activer/désactiver les alertes App Distribution sans affecter les autres membres du projet. Notez que vous avez toujours besoin des autorisations requises pour recevoir des alertes.
Pour activer ou désactiver les alertes App Distribution, procédez comme suit :
- Dans la console Firebase, dans le coin supérieur droit, accédez à
- Ensuite aller à
paramètres Paramètres définissez les préférences de votre compte pour les alertes App Distribution.
Configurer des alertes avancées pour les services tiers
Vous pouvez également envoyer des alertes App Distribution au canal de notification préféré de votre équipe à l'aide de Cloud Functions pour Firebase. Par exemple, vous pouvez écrire une fonction qui capture un événement d'alerte pour l'enregistrement d'un nouvel appareil iOS et publier les informations d'alerte sur un service tiers, comme Discord, Slack ou Jira.
Pour automatiser entièrement l'intégration de nouveaux testeurs iOS, vous pouvez écrire une fonction qui ajoute l'UDID d'un nouvel appareil iOS au profil de provisionnement de votre application, reconstruit l'application et redistribue l'application avec le profil de provisionnement mis à jour.
Pour configurer des fonctionnalités d'alerte avancées à l'aide de Cloud Functions pour Firebase, procédez comme suit :
Configurez Cloud Functions pour Firebase , qui comprend les tâches suivantes :
- Configurez un environnement de développement pour Node.js ou Python.
- Installez et connectez-vous à la CLI Firebase.
- Initialisez Cloud Functions pour Firebase à l'aide de la CLI Firebase.
Écrivez et déployez une fonction qui capture un événement d'alerte d'App Distribution et gère la charge utile de l'événement (par exemple, publie les informations d'alerte dans un message sur Discord).
Pour en savoir plus sur tous les événements d'alerte que vous pouvez capturer, accédez à la documentation de référence pour les alertes App Distribution .
Prochaines étapes
Pour savoir comment augmenter votre base de tests internes, consultez Créer des liens d'invitation .