Catch up on highlights from Firebase at Google I/O 2023. Learn more

Enregistrez des appareils iOS supplémentaires

Si vous souhaitez distribuer des builds iOS ad hoc à l'aide de App Distribution, vous devez suivre ce guide pour enregistrer les appareils de vos testeurs. Une build ad hoc est une build non signée avec un profil Enterprise. Un appareil ne peut installer une build ad hoc que si l'identifiant d'appareil unique (UDID) de l'appareil est inclus dans le profil d'approvisionnement de la build.

Lorsqu'un testeur accepte une invitation à tester votre application, App Distribution demande l'autorisation de partager l'identifiant d'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 d'approvisionnement 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 par programme les UDID à l'aide de Fastlane .

Exporter manuellement les UDID

  1. Ajoutez les appareils à votre portail des développeurs 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 de 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 e-mail.

      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.

  2. Ajoutez les appareils 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. Redistribuez votre application à partir de la console Firebase ou de 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'informe 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 reçoivent des e-mails de notification.

Exporter par programmation des UDID à l'aide de Fastlane

  1. 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

  2. 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 de développeur Apple ne peut vous permettre d'importer qu'un nombre limité d'appareils par an.

  3. Ajoutez les appareils enregistrés à votre profil d'approvisionnement .

  4. Téléchargez le profil d'approvisionnement et utilisez-le pour reconstruire votre application. Si vous reconstruisez uniquement dans le but de mettre à jour les appareils enregistrés, ne mettez pas à jour le numéro de build ou la version.

  5. 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'informe 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.

Recevez des alertes

Obtenir des alertes par défaut

Par défaut, Firebase peut envoyer des alertes de distribution d'applications pour les nouveaux enregistrements d'appareils iOS par e-mail.

Pour recevoir des alertes de distribution d'applications 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 est enregistré.

Activer/désactiver les alertes pour votre propre compte

Pour votre propre compte, vous pouvez activer/désactiver les alertes de distribution d'applications 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 de distribution d'applications, procédez comme suit :

  1. Dans la console Firebase, dans le coin supérieur droit, accédez aux Alertes Firebase .
  2. Ensuite, accédez aux paramètres et définissez les préférences de votre compte pour les alertes de distribution d'applications.

Configurer des alertes avancées vers des services tiers

Vous pouvez également envoyer des alertes de distribution d'applications 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 d'approvisionnement de votre application, reconstruit l'application et redistribue l'application avec le profil d'approvisionnement mis à jour.

Pour configurer des fonctionnalités d'alerte avancées à l'aide de Cloud Functions for Firebase, procédez comme suit :

  1. Configurez Cloud Functions pour Firebase , qui comprend les tâches suivantes :

    1. Configurez un environnement de développement pour Node.js ou Python.
    2. Installez et connectez-vous à la CLI Firebase.
    3. Initialisez Cloud Functions pour Firebase à l'aide de l'interface de ligne de commande Firebase.

  2. Écrivez et déployez une fonction qui capture un événement d'alerte à partir de 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, consultez la documentation de référence pour les alertes de distribution d'applications .

Prochaines étapes