Enregistrer 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. Un build ad hoc est un build qui n'est pas signé avec un profil d'entreprise. Un appareil ne peut installer une version ad hoc que si son identifiant d'appareil unique (UDID) est inclus dans le profil de configuration de la version.

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 un build 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 de manière programmatique à l'aide de fastlane.

Exporter manuellement les UDID

  1. Ajoutez les appareils à votre portail des développeurs Apple.
    • Option 1 : Importez les UDID des appareils au format 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. Importez ensuite le fichier dans votre compte de développeur Apple à l'aide de l'option Register Multiple Devices (Enregistrer plusieurs appareils). Pour en savoir plus, consultez la section Distribuer votre application sur les appareils enregistrés.

      Notez que votre compte de développeur Apple ne vous permet peut-être d'importer qu'un nombre limité d'appareils par an.

    • Option 2 : Collectez et saisissez les UDID par e-mail.

      Sur la page Add Devices (Ajouter des appareils) du portail Apple Developer, enregistrez le nouvel UDID spécifié dans l'e-mail que vous avez reçu.

  2. Ajoutez les appareils enregistrés à votre profil de configuration.
  3. Téléchargez le profil de provisionnement et utilisez-le pour recompiler votre application. Si vous ne recompilez que pour mettre à jour les appareils enregistrés, ne mettez pas à jour le numéro de build ni la version.
  4. Rédistribuez votre application à partir de la console Firebase ou de la CLI. Si vous ne modifiez pas votre version, votre numéro de build ni 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é un 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 des UDID par programmation à l'aide de Fastlane

  1. Exportez tous les UDID de vos appareils de test au format 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 Register Multiple Devices(Enregistrer plusieurs appareils). Pour en savoir plus, consultez la documentation Apple. Notez que votre compte de développeur Apple ne vous permet peut-être d'importer qu'un nombre limité d'appareils par an.

  3. Ajoutez les appareils enregistrés à votre profil de configuration.

  4. Téléchargez le profil de provisionnement et utilisez-le pour recompiler votre application. Si vous ne recompilez votre application que pour mettre à jour les appareils enregistrés, ne mettez pas à jour le numéro de build ni la version.

  5. Rédistribuez votre application. Si vous ne modifiez pas votre version, votre numéro de build ni 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 version avec le même numéro de build et la même version, seuls les utilisateurs des appareils nouvellement enregistrés recevront des e-mails de notification.

Recevoir des alertes

Recevoir 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, un e-mail est envoyé à chaque membre du projet (qui dispose des autorisations requises pour recevoir des alertes) 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 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:

  1. Dans la console Firebase, en haut à droite, accédez à Alertes Firebase.
  2. Accédez ensuite à Paramètres et définissez vos préférences de 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 for Firebase. Par exemple, vous pouvez écrire une fonction qui capture un événement d'alerte pour l'enregistrement d'un nouvel appareil iOS et publie les informations d'alerte sur un service tiers, comme Discord, Slack ou Jira.

Pour automatiser complètement 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, la recompile et la redistribue avec le profil de provisionnement 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, ce 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 for Firebase à l'aide de la CLI 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 sur les alertes App Distribution.

Étapes suivantes