Partager via

Inscription de l’appareil et nouvelle signature d’application

  • Article

Important

Visual Studio App Center est prévu pour la mise hors service le 31 mars 2025. Bien que vous puissiez continuer à utiliser Visual Studio App Center jusqu’à ce qu’il soit entièrement mis hors service, il existe plusieurs alternatives recommandées que vous pouvez envisager de migrer vers.

En savoir plus sur les chronologies de support et les alternatives.

Dans cette page, vous pouvez lire les étapes à suivre lors de la distribution d’une application iOS à des testeurs spécifiques. Découvrez l’inscription des appareils, l’approvisionnement et la nouvelle signature d’application. Vous pouvez également apprendre à utiliser la fonctionnalité App Center pour rendre ce processus aussi indolore que possible. Enfin, il existe des solutions à certains problèmes courants que vous pouvez rencontrer.

Signature d’application, nouvelle signature et approvisionnement d’appareils

Les développeurs signent des applications pour la sécurité selon les besoins d’Apple lors de la distribution. L’exigence est la même pour la distribution via Xcode, App Center ou iTunes Store. La signature de code est une précaution pour vous assurer que personne n’a falsifié votre application. Vous pouvez en savoir plus dans la documentation Apple sur la signature d’application.

Le diagramme suivant affiche l’ensemble du flux de réinscriture de l’application dans App Center. Passons en détail à ces étapes.

Flux d’inscription d’appareils et de réinscription d’application App Center

La nouvelle signature d’application s’applique uniquement lorsque vous souhaitez distribuer une application iOS à des appareils de test spécifiques. Dans le diagramme, vous souhaitez distribuer une version d’application sur les appareils du testeur 1 et du testeur 2. Pour ce faire, vous signez votre application avec un profil d’approvisionnement ad hoc . Ce profil d’approvisionnement contient une liste d’identificateurs d’appareil uniques (UDID). Seuls les appareils figurant dans cette liste sont « provisionnés » ou peuvent installer .ipa. App Center peut détecter si un appareil est approvisionné, car nous connaissons l’UDID de l’appareil à partir duquel le testeur a inscrit son appareil auprès d’App Center pour la première fois. Si nous détectons que l’appareil que le testeur utilise ne figure pas dans la liste des appareils provisionnés pour le fichier .ipa qu’il souhaite télécharger, nous affichons le message « Les développeurs travaillent sur une version pour votre appareil ».

Une fois que vous connaissez les appareils que vous souhaitez utiliser pour les tests :

  1. Inscrivez les appareils dans votre compte de développeur Apple.
  2. Ajoutez-les à votre profil d’approvisionnement.
  3. Générez un nouveau profil d’approvisionnement.
  4. Téléchargez le profil d’approvisionnement.
  5. Générez votre application avec ce profil.

Quand un autre nouvel appareil apparaît, tel que l’appareil avec UDID 3 dans le diagramme, répétez ces étapes. Cela peut être gênant et vous ne souhaitez pas modifier votre système d’intégration continue ou demander au développeur de toujours ajouter de nouveaux appareils au profil et de libérer de nouvelles builds. C’est là que la nouvelle connexion est entrée. Cela signifie prendre une build d’application existante et la signer à nouveau (re-signature) avec un autre profil d’approvisionnement, de sorte que vous n’avez pas besoin de créer une nouvelle build.

App Center vous aide à utiliser ce processus et peut également l’automatiser. Il s’agit des étapes manuelles et automatiques indiquées dans le diagramme, en approvisionnant l’appareil avec UDID 3. App Center vous aide à inscrire des ID d’appareil testeurs dans votre compte de développeur Apple, à créer un profil d’approvisionnement et à reconnecter l’application à partir du portail App Center. App Center nécessite l’accès à votre compte de développeur Apple pour l’inscription des appareils.

Pour ajouter manuellement des appareils à une version existante, vous pouvez utiliser Inscrire des appareils sur la page d’un groupe de distribution. Consultez l’inscription de l’appareil.

Pour ajouter automatiquement des appareils, activez la gestion automatique des appareils sous les paramètres du groupe de distribution. Cette option est accessible uniquement via un groupe de distribution au niveau de l’application et n’est pas disponible via un groupe global. Vous pouvez accéder à un groupe de distribution au niveau de l’application en sélectionnant l’application dans App Center, puis en cliquant sur Distribuer. Sous Distribuer, cliquez sur Groupes , puis sur le groupe spécifique que vous souhaitez gérer. Vous pouvez également choisir d’ajouter automatiquement des appareils lorsque vous distribuez une nouvelle version. Cette option se trouve dans l’étape Appareils de l’Assistant pour la distribution d’une nouvelle version.

App Center ajoute le nouvel appareil à la liste dans le profil d’approvisionnement et signe à nouveau votre application avec ce profil d’approvisionnement. À présent, le nouvel appareil peut également installer l’application. Il s’agit des étapes inférieures du diagramme.

Fonctionnalités de nouvelle signature

Voici quelques points à noter lorsque vous utilisez la réinscrire dans App Center :

  • La gestion automatique des appareils dans les groupes fonctionne uniquement pour la distribution à des groupes non publics et non partagés.
  • Si vous distribuez des utilisateurs individuels, inscrivez leurs appareils manuellement et reconnectez l’application. Pour utiliser les outils mentionnés dans cet article, vous devez d’abord ajouter les testeurs à un groupe.
  • Si vous ajoutez plusieurs groupes à votre version, configurez chaque groupe séparément à l’aide de la gestion automatique des appareils sous les paramètres du groupe.
  • La gestion des appareils est requise uniquement pour les applications iOS signées avec un profil développeur ou ad hoc.

Prérequis

Avant de pouvoir utiliser les fonctionnalités d’appareil d’App Center, vous devez :

  1. Disposer du certificat de production utilisé pour la signature d’application d’origine.
  2. Disposez des informations d’identification de votre compte de développeur Apple qui possède le rôle Titulaire du compte, Administrateur ou App Manager.
  3. Utilisez la gestion manuelle de la connexion au lieu de gérer automatiquement la signature lors de la distribution de l’application à partir de Xcode.

Enregistrement de l’appareil

L’inscription d’un appareil signifie qu’il fait partie de la liste des appareils sur le portail des développeurs Apple qui peuvent ensuite être inclus dans un profil d’approvisionnement. Pour inscrire un appareil, sélectionnez un groupe de distribution avec au moins un appareil qui n’est pas encore configuré et accédez à l’onglet Appareils . Vous verrez un appareil ici avec l’état « non approvisionné » et un message en haut indiquant qu’il existe des appareils non approvisionnés. Procédez comme suit pour inscrire les appareils :

  1. Sélectionnez le bouton Inscrire des appareils .
  2. Une boîte de dialogue vous invite à entrer votre nom d’utilisateur et votre mot de passe utilisés dans le portail des développeurs Apple.
  3. Une fois que vous vous connectez avec votre nom d’utilisateur et mot de passe Apple, App Center ajoute les appareils non approvisionnés à votre compte développeur Apple et au profil d’approvisionnement des versions.
  4. Si vous le souhaitez, vous pouvez charger un fichier .p12 pour signer à nouveau l’application et la distribuer aux appareils nouvellement ajoutés. En savoir plus sur la génération d’un fichier .p12.

Si vous préférez gérer la recréation de votre application avec le profil d’approvisionnement mis à jour séparément, vous pouvez toujours utiliser App Center pour inscrire automatiquement les appareils de votre testeur dans le portail des développeurs Apple sans l’étape de nouvelle signature. Pour ce faire, laissez ma nouvelle application désactivée et téléchargez le profil d’approvisionnement mis à jour avec le bouton sur l’écran de révision. Vous pouvez également télécharger le profil d’approvisionnement via Xcode ou le portail des développeurs Apple.

Distribuer une nouvelle version

Lorsque vous distribuez une nouvelle version à un groupe dont la gestion automatique des appareils n’est pas activée, une étape Appareils fait partie de l’Assistant. L’étape vérifie si vous avez des appareils non approvisionnés dans le groupe de distribution ; si cela se produit, vous pouvez cocher la case Inscrire des appareils et reconnecter l’application . App Center exécute ensuite trois opérations pour vous :

  1. Inscrivez de nouveaux ID d’appareil dans le portail des développeurs Apple.
  2. Ajoutez les appareils au profil d’approvisionnement et téléchargez-le.
  3. Reconnectez le fichier binaire chargé afin que tous les testeurs puissent l’installer.

Le flux nécessite le nom d’utilisateur et le mot de passe pour le portail des développeurs Apple et le certificat utilisé pour signer l’application au moment de la génération. Vous fournissez le certificat en tant que fichier .p12 exporté. En savoir plus sur la génération d’un fichier .p12. Si vous disposez déjà de votre ID Apple et de votre certificat enregistrés dans App Center, vous pouvez le choisir dans les menus déroulants.

Problèmes de confidentialité sur le nom d’utilisateur et le mot de passe

Lorsque vous ajoutez vos informations d’identification Apple et un certificat de signature à App Center, nous utilisons une connexion sécurisée. App Center stocke les informations dans un coffre chiffré. Il n’est pas possible pour un utilisateur de télécharger ou de récupérer des informations sensibles à partir du coffre.

Si vous fournissez cet ensemble d’informations d’identification et un certificat, il est automatiquement disponible pour les collaborateurs d’application, mais uniquement pour ce service spécifique. Par exemple, supposons que le développeur X ajoute des informations d’identification et des certificats au groupe de distribution « Testeur ». Ensuite, lorsque le développeur Y distribue une nouvelle version au groupe « Testeur », le nom d’utilisateur, le mot de passe et le certificat de X sont sélectionnés par défaut. App Center les utilisera pour le développeur Y. App Center utilise uniquement votre ID Apple pendant la transaction et ne l’utilise pas pour autre chose.

Limite d’inscription des appareils Apple

Chaque compte de développeur Apple a un nombre fini de taches pour les appareils par type d’appareil. Apple fonctionne avec cinq types d’appareils : iPad, iPhone, iPod, Apple TV et Apple Watch. Chacun d’eux a une limitation de 100 appareils. Imaginez que vous inscrivez six appareils, qui sont tous des iPhones. Vous avez ensuite 94 ID d’appareil laissés pour les iPhones et avez toujours 100 laissés pour chacun des quatre autres types d’appareils. Vous ne pouvez annuler l’inscription des appareils qu’une seule fois par an pour récupérer ces emplacements.

Comment générer un fichier .p12

Vous pouvez stocker un certificat de distribution Apple et une clé privée dans un fichier Private Information Exchange (.p12). Pour ce faire, vous avez besoin d’un certificat de production Apple stocké sur votre ordinateur local. Si ce n’est pas le cas, vous n’aurez pas la clé privée.

  1. Ouvrez l’application Keychain Access sur votre Mac et sélectionnez la catégorie Mes certificats sur la gauche.
  2. Recherchez le bon certificat de distribution et développez-le pour afficher la clé privée correspondante. a. Si la clé privée n’est pas là, vous devez créer un certificat ou exécuter ces étapes sur l’ordinateur sur lequel vous avez créé le certificat.
  3. Sélectionnez le certificat ou la clé privée ou les deux. Cliquez ensuite avec le bouton droit sur le ou les éléments sélectionnés pour obtenir le menu contextuel et sélectionnez l’action qui commence par Exporter.
  4. Sélectionnez un emplacement sur le disque pour enregistrer le fichier sous la forme d’un fichier .p12. Choisissez un mot de passe fort pour le fichier.

Comment supprimer des certificats et des ID Apple d’App Center

Vous pouvez supprimer les certificats et les ID Apple d’App Center dans les comptes de développeur.

  1. Sélectionnez Paramètres du compte sous votre image de profil dans le coin supérieur droit.
  2. Sélectionnez Comptes de développeur.
  3. Supprimez le secret à l’aide des trois points verticaux sur le côté droit de la table, puis supprimez le certificat.
  4. Vérifiez le nom du certificat et confirmez votre action irréversible en sélectionnant Supprimer une fois de plus.

En savoir plus sur la gestion de vos certificats et id Apple.

Inscrire manuellement des appareils auprès d’Apple

Si vous essayez de distribuer directement aux utilisateurs en dehors d’App Center, vous pouvez suivre les étapes du site web du développeur Apple sur la façon de distribuer aux appareils inscrits. Les étapes décrivent comment ajouter manuellement des appareils à votre compte et reconnecter votre application.

Erreurs connues

Profil introuvable

Lors de la connexion à Apple via App Center, nous vérifions le ou les profils d’approvisionnement inclus dans votre application par rapport à ceux de votre compte de développeur. Si un profil utilisé dans un fichier binaire n’est pas trouvé dans votre compte de développeur Apple, App Center ne peut pas réinscrire votre application. Pour résoudre ce problème, vérifiez que votre compte de développeur Apple contient tous les profils d’approvisionnement utilisés dans votre application. Vous pouvez vérifier les profils d’application sous l’onglet Général de vos propriétés de projet Xcode ou les options de signature de bundle iOS dans Visual Studio pour Mac.

Remarque

Lorsque vous tentez d’approvisionner automatiquement un fichier binaire via App Center, dans certains cas, les profils d’approvisionnement générés automatiquement par Xcode entraînent l’échec de l’approvisionnement automatique avec l’erreur suivante : Profil nommé « iOS Team ... » est introuvable dans le compte. Pour résoudre le problème, créez et utilisez le profil d’approvisionnement créé manuellement.

Équipe introuvable

Lors de la connexion à Apple via App Center, les équipes incluses dans vos applications sont vérifiées par rapport à celles de votre compte de développeur. Si une équipe utilisée dans le fichier binaire n’est pas trouvée dans votre compte de développeur Apple, App Center ne peut pas signer à nouveau votre application. Pour résoudre ce problème, vérifiez que votre compte de développeur Apple contient l’équipe utilisée dans votre application. Vous pouvez vérifier l’équipe des applications sous l’onglet Général de vos propriétés de projet Xcode ou les options de signature de bundle iOS dans Visual Studio pour Mac.

Contrat de licence mis à jour

Apple met régulièrement à jour son contrat de licence. Pour continuer à utiliser le portail des développeurs Apple, vous devez lire et accepter la licence mise à jour.

  1. Connectez-vous au portail des développeurs Apple.
  2. Suivez les instructions fournies pour accepter le contrat de licence.

App Center ne peut pas vous aider avec du contenu dans la licence ou le flux du contrat de licence.

Notre testeur n’a pas inscrit son ID d’appareil

Si un testeur a sélectionné accidentellement je l’ai déjà inscrit, procédez comme suit pour inscrire un appareil manuellement :

  1. Accédez à https://install.appcenter.ms/register-device votre appareil mobile.
  2. Sélectionnez Inscrire et suivez les instructions à l’écran.