Approvisionnement manuel pour les applications iOS

L’approvisionnement manuel est une approche pour le déploiement d’une application iOS .NET Multi-platform App UI(.NET MAUI) sur un appareil, où vous avez un contrôle total sur les données d’approvisionnement créées. Avec cette approche, vous créez et gérez manuellement des identités de signature, des ID d’application et des profils de provisionnement dans votre compte Apple Developer, puis vous devez télécharger ces données dans Visual Studio. Avant de commencer le processus d’approvisionnement manuel, vous devez vous assurer que vous avez ajouté votre compte Apple Dveloper à Visual Studio. Pour plus d’informations, consultez Gestion des comptes Apple.

Les équipe, les certificats et les profils de développement peuvent être gérés en accédant à la section Certificates, Identifiers & Profiles de votre compte Apple Developer.

Créer un certificat de signature

Avec l’approvisionnement manuel, la première étape de la configuration d’un appareil de développement consiste à créer un certificat de signature, qui se compose d’un certificat de développement et d’une clé privée.

Les certificats de développement et leurs clés associées établissent votre identité avec Apple et vous associent à des appareils et profils spécifiques pour le développement. Cela est similaire à l’ajout de votre signature numérique à vos applications. Apple utilise ces certificats pour s’assurer que vous ne pouvez déployer vos applications que sur des appareils spécifiques.

Une fois que vous avez ajouté votre compte Apple Developer à Visual Studio, vous devez générer un certificat de signature :

1. Dans Visual Studio, accédez à Outils > Options > Xamarin > Comptes Apple.
2. Dans la boîte de dialogue Comptes Apple Developer, sélectionnez une équipe, puis Afficher les détails….
3. Dans la boîte de dialogue Détails, sélectionnez Créer un certificat>Développement iOS. Une nouvelle identité de signature sera créée et synchronisée avec Apple si vous disposez des autorisations appropriées.

Présentation des paires clé/certificat

Un profil de développement contient des certificats, leurs clés associées et tous les profils de provisionnement associés à votre compte de Apple Developer. Il existe deux versions d’un profil de développement : l’une existe dans votre compte Apple Developer et l’autre réside sur un ordinateur local. La différence entre les deux est le type de clés qu’elles contiennent : le profil dans votre compte de développeur Apple contient toutes les clés publiques associées à vos certificats, tandis que la copie sur votre ordinateur local contient toutes les clés privées. Pour que les certificats soient valides, les paires de clés doivent correspondre.

Approvisionner un appareil iOS pour le développement

Après avoir créé un certificat de signature, vous devez configurer un profil de provisionnement de développement afin qu’il soit possible de déployer votre application sur un appareil. L’appareil doit exécuter une version d’iOS prise en charge par Xcode.

Ajout d’un appareil

Lorsque vous créez un profil de provisionnement pour le développement, il doit inclure quels appareils peuvent exécuter l’application. Avant de sélectionner un appareil à ajouter à un profil de provisionnement, vous devez d’abord ajouter l’appareil à votre compte Apple Developer. Vous pouvez ajouter l’appareil en suivant ces étapes :

1. Connectez l’appareil à approvisionner à votre Mac local avec un câble USB.

2. Ouvrez Xcode, puis accédez à Window > Devices and Simulators.

3. Dans Xcode, sélectionnez l’onglet Devices, puis sélectionnez l’appareil dans la liste des appareils connectés.

4. Dans Xcode, copiez la valeur de Identifier dans le presse-papiers :

   

5. Dans un navigateur web, accédez à la section Devices de votre Apple Developer, puis cliquez sur le bouton +.

6. Dans la page Register à New Device, définissez la plateforme appropriée et fournissez un nom pour le nouvel appareil. Collez ensuite l’identificateur du presse-papiers dans le champ Device ID (UDID), puis cliquez sur Continue :

   

7. Dans la page Register a New Device, passez en revue les informations, puis cliquez sur Register.

Répétez les étapes précédentes pour tout appareil iOS sur lequel vous souhaitez déployer une application iOS MAUI .NET.

Créer un ID d’application

Après avoir ajouté un appareil à votre compte de développeur Apple, vous devez créer un ID d’application. Un ID d’application est similaire à une chaîne DNS inversée, qui identifie de façon unique une application et doit être identique à l’identificateur de bundle pour votre application.

Il existe deux types d’ID d’application :

• Caractère générique. Un ID d’application générique vous permet d’utiliser un ID d’application unique pour correspondre à plusieurs applications et prend généralement la forme com.domainname.*. Un ID d’application générique peut être utilisé pour installer la plupart des applications sur un appareil et vous devez l’utiliser pour les applications qui n’activent pas des fonctionnalités spécifiques à l’application.
• Explicite. Un ID d’application explicite est unique à une seule application et prend généralement la forme com.domainname.myid. Un ID d’application explicite permet l’installation d’une application, avec un identificateur de bundle correspondant, sur un appareil. Les ID d’application explicites sont généralement utilisés pour les applications qui activent des fonctionnalités spécifiques à l’application telles qu’Apple Pay ou Game Center.

L’approche recommandée consiste à créer un ID d’application générique, sauf si votre application utilise des fonctionnalités spécifiques à l’application. Pour plus d’informations sur les fonctionnalités, consultez Fonctionnalités.

Un ID d’application générique peut être créé en procédant comme suit :

1. Dans un navigateur web, accédez à la section Identifiers de votre compte de développeur Apple, puis cliquez sur le bouton +.

2. Sur la page Register a new identifier, sélectionnez App IDs, puis cliquez sur le bouton Continue.

3. Sur la page Register a new identifier, sélectionnez le type App, puis cliquez sur le bouton Continue.

4. Sur la page Register an App ID, fournissez une Description et définissez le Bundle ID sur Wildcard. Entrez ensuite un ID d’application au format com.domainname.*, puis cliquez sur le bouton Continue :

   

5. Sur la page Confirm your App ID, passez en revue les informations, puis cliquez sur le bouton Register.

Créer un profil d’approvisionnement de développement

Une fois l’ID d’application créé, vous devez créer un profil d’approvisionnement de développement. Ce profil d’approvisionnement indique à quelle application (ou quelles applications, s’il s’agit d’un ID d’application générique) il se réfère, qui peut l’utiliser (en fonction des certificats de développeur ajoutés) et quels appareils peuvent installer l’application.

Un profil d’approvisionnement de développement peut être créé en procédant comme suit :

1. Dans un navigateur web, accédez à la section Profiles de votre compte de développeur Apple, puis cliquez sur le bouton +.

2. Sur la page Register a New Provisioning Profile, dans la section Development, sélectionnez iOS App Development, puis cliquez sur le bouton Continue :

   

3. Sur la page Generate a Provisioning Profile, sélectionnez le App ID à utiliser, puis cliquez sur le bouton Continue.

   

4. Sur la page Generate a Provisioning Profile, sélectionnez les certificats à inclure dans le profil d’approvisionnement, puis cliquez sur le bouton Continue.

   

5. Sur la page Generate a Provisioning Profile, sélectionnez les appareils sur lesquels l’application sera installée, puis cliquez sur le bouton Continue.

   

6. Sur la page Generate a Provisioning Profile, entrez un nom pour le profil d’approvisionnement, puis cliquez sur le bouton Generate.

   

7. Sur la page Generate a Provisioning Profile, cliquez éventuellement sur le bouton Download pour télécharger votre profil d’approvisionnement.

Télécharger le profil de provisionnement

Activer l’approvisionnement manuel

Après avoir créé manuellement le profil d’approvisionnement de développement et l’avoir installé dans Visual Studio, votre projet d’application .NET MAUI doit être configuré pour utiliser l’approvisionnement manuel :

1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur votre projet d’application .NET MAUI et sélectionnez Propriétés. Ensuite, accédez à l’onglet MAUI partagé > Général et vérifiez que la valeur du champ ID d’application correspond au format de l’ID d’application que vous avez créé précédemment.

2. Dans les propriétés du projet, accédez à l’onglet Signature de bundle iOS et vérifiez que l’option Approvisionnement manuel est sélectionnée dans la liste déroulante Schéma :

   

3. Dans les propriétés Signature de bundle, sélectionnez votre Identité de signature et votre Profil d’approvisionnement, ou définissez-les sur Automatique. Lorsqu’Identité de signature et Profil d’approvisionnement sont définis sur Automatique, Visual Studio sélectionne l’identité de signature et le profil d’approvisionnement en fonction de l’Identificateur de bundle dans Info.plist (qui est identique à la valeur de la propriété ID d’application dans votre fichier projet).

Déployer sur un appareil

Après avoir configuré l’approvisionnement dans votre projet d’application .NET MAUI, l’application peut être déployée sur un appareil avec Visual Studio :

1. Dans Visual Studio, vérifiez que l’IDE est associé à un hôte de build Mac. Pour plus d’informations, consultez Appairer avec un Mac pour le développement iOS.

2. Vérifiez que votre appareil iOS est connecté à votre hôte de build Mac via USB ou Wi-Fi. Pour plus d’informations sur le déploiement sans film, consultez Déploiement sans fil pour les applications .NET MAUI iOS.

3. Dans la barre d’outils Visual Studio, utilisez la liste déroulante Cible de débogage pour sélectionner Appareils distants iOS, puis l’appareil qui est connecté à votre hôte de build Mac :

   

4. Dans la barre d’outils Visual Studio, appuyez sur le bouton Démarrer pour lancer l’application sur votre distant :

   

Provisionnement des services d’application

Apple propose une sélection de services d’application, également appelés fonctionnalités, que vous pouvez activer pour une application iOS .NET MAUI. Ces fonctionnalités doivent être configurées dans votre profil d’approvisionnement, lorsque l’ID d’application est créé, et dans le fichier Entitlements.plist qui doit être ajouté au projet d’application .NET MAUI. Pour plus d’informations sur les fonctionnalités, consultez Droits et Fonctionnalités.