Enregistrer des appareils iOS supplémentaires

Si vous souhaitez distribuer des versions ad hoc d'iOS à l'aide de App Distribution, vous devez suivre ce guide pour enregistrer les appareils de vos testeurs. Une compilation ad hoc est une compilation qui n'est pas signée avec un profil d'entreprise. Un appareil ne peut installer une version ad hoc que si son identifiant unique (UDID) est inclus dans le profil de provisionnement 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 vous pouvez les exporter 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 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 Register Multiple Devices (Enregistrer plusieurs appareils). Pour en savoir plus, consultez Distribuer votre application sur des 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 provisionnement.
  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 modifiez pas le numéro ni la version de compilation.
  4. Redistribuez votre application depuis la console Firebase ou la CLI. Si vous ne modifiez pas la version, le numéro de build ni le code de votre application, App Distribution ne crée pas de version et n'envoie pas de notification aux 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 recevront des notifications par e-mail.

Exporter les UDID par programmation à l'aide de fastlane

  1. Exportez tous les UDID de vos appareils de testeurs 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 d'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 provisionnement.

  4. 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 modifiez pas le numéro de build ni la version.

  5. Redistribuez votre application. Si vous ne modifiez pas la version, le numéro de build ni le code de votre application, App Distribution ne crée pas de version et n'envoie pas de notification aux testeurs. Si vous avez déjà distribué une version avec le même numéro de version et de compilation, seuls les utilisateurs des appareils nouvellement enregistrés recevront des e-mails de notification.

Recevoir des alertes

Recevoir les alertes par défaut

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

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 (disposant 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 ou désactiver les alertes App Distribution sans affecter les autres membres du projet. Notez que vous devez toujours disposer des autorisations requises pour recevoir des alertes.

Pour activer ou désactiver les alertes App Distribution :

  1. Dans la console Firebase, en haut à droite, accédez à Alertes Firebase.
  2. Ensuite, accédez à Paramètres et définissez la préférence 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 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 publier 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 inclut les tâches suivantes :

    1. Configurez un environnement de développement pour Node.js ou Python.
    2. Installez la CLI Firebase et connectez-vous.
    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, en publiant les informations de l'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