Enregistrer des appareils iOS supplémentaires

Si vous souhaitez distribuer des versions iOS ad hoc à l'aide de App Distribution, vous devez suivre ce guide pour enregistrer les appareils de vos testeurs. Une version ad hoc est une version non 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 configuration de la version.

Lorsqu'un testeur accepte une invitation à tester votre application, App Distribution demande l'autorisation de partager l'identifiant de son appareil 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 envoie une notification par e-mail.

Lorsque vous recevez un e-mail contenant un UDID, mettez à jour votre profil de configuration avec l'UDID et distribuez une nouvelle version à vos testeurs. Vous pouvez exporter manuellement les UDID à l'aide de la Firebase console ou de l'interface CLI Firebase, ou de manière programmatique à l'aide de fastlane.

Exporter manuellement les UDID

  1. Ajoutez les appareils à votre portail Apple Developer.
    • 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 Apple Developer à 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 Apple Developer ne vous autorise peut-être à importer qu'un nombre limité de 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 configuration et utilisez-le pour recréer votre application. Si vous ne recréez l'application que pour mettre à jour les appareils enregistrés, ne modifiez pas le numéro de version ni la version.
  4. Redistribuez votre application depuis la Firebase console ou l'interface CLI. Si vous ne modifiez pas votre version, votre numéro de version ni le code de votre application, App Distribution ne crée pas de nouvelle 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 la même version, seuls les utilisateurs des appareils nouvellement enregistrés recevront des e-mails de notification.

Exporter de manière programmatique les UDID à l'aide de fastlane

  1. Exportez tous les UDID des appareils de vos testeurs sous forme de fichier CSV à partir de 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 Apple Developer à l'aide de l'option Register Multiple Devices(Enregistrer plusieurs appareils). Pour en savoir plus, consultez la documentation d'Apple. Notez que votre compte Apple Developer ne vous autorise peut-être à 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 configuration et utilisez-le pour recréer votre application. Si vous ne recréez l'application que pour mettre à jour les appareils enregistrés, ne modifiez pas le numéro de version ni la version.

  5. Redistribuez votre application. Si vous ne modifiez pas votre version, votre numéro de version ni le code de votre application, App Distribution ne crée pas de nouvelle 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 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, propriétaire du projet ou éditeur.

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 devez toujours disposer 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 aux Alertes Firebase.
  2. Accédez ensuite à Paramètres et définissez vos préférences de compte pour les App Distribution alertes.

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, tel que 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 configuration de votre application, recrée l'application et la redistribue avec le profil de configuration 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 l'interface Firebase et connectez-vous.
    3. Initialisez Cloud Functions for Firebase à l'aide de l'interface 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 App Distribution alertes.

Étapes suivantes