Approvisionnement automatique pour les applications iOS

L’approvisionnement automatique est l’approche recommandée pour déployer une application iOS .NET Multiplateforme (.NET MAUI) sur un appareil. Avec cette approche, Visual Studio crée et gère automatiquement les identifiants de signature, les ID d’application et les profils d’approvisionnement. Avant de commencer le processus d’approvisionnement automatique, vous devez vous assurer que vous avez ajouté votre compte développeur Apple à Visual Studio. Pour plus d’informations, consultez la gestion des comptes Apple.

Une fois que vous avez ajouté votre compte développeur Apple à Visual Studio, vous pouvez utiliser n’importe quelle équipe associée. Les certificats, les ID d’application et les profils peuvent ensuite être créés sur l’équipe. L’ID d’équipe est également utilisé pour créer un préfixe pour l’ID d’application qui sera inclus dans le profil d’approvisionnement, ce qui permet à Apple de vérifier qu’une application peut être déployée sur un appareil.

Important

Avant de commencer, vérifiez que vous avez accepté tous les contrats de licence utilisateur dans votre compte de développeur Apple et l’App Store Connecter.

Activer l’approvisionnement automatique

Une fois que vous avez ajouté votre compte développeur Apple à Visual Studio, vous devez activer l’approvisionnement automatique pour le projet d’application .NET MAUI.

Visual Studio

1. Dans Explorateur de solutions, cliquez avec le bouton droit sur votre projet d’application .NET MAUI, puis sélectionnez Propriétés. Ensuite, accédez à l’onglet Signature de bundle iOS > et vérifiez que l’approvisionnement automatique est sélectionné dans la liste déroulante Schéma :

   

2. Dans les paramètres de signature de bundle, cliquez sur le lien hypertexte Configurer l’approvisionnement automatique.

3. Dans la boîte de dialogue Configurer l’approvisionnement automatique, sélectionnez votre équipe. Visual Studio tente de provisionner automatiquement votre projet et indique si le processus s’est terminé correctement :

   

   Si l’approvisionnement automatique échoue, la boîte de dialogue Configurer l’approvisionnement automatique affiche la raison de l’erreur.

4. Dans la boîte de dialogue Configurer l’approvisionnement automatique, cliquez sur le bouton Ok pour ignorer la boîte de dialogue.

Visual Studio pour Mac

Remarque

Visual Studio pour Mac est prévue pour la retraite d’août 31 2024 conformément à Politique de cycle de vie moderne de Microsoft. Visual Studio pour Mac 17.6 continuera d’être pris en charge jusqu’au 31 août 2024, avec des mises à jour de maintenance pour les problèmes de sécurité et les plateformes mises à jour d’Apple. Pour plus d’informations, notamment des options alternatives pour le développement sur un Mac, consultez Ce qui se passe pour Visual Studio pour Mac ?.

1. Dans la fenêtre Solution, double-cliquez sur le fichier Info.plist à partir du dossier Plateformes > iOS de votre projet d’application .NET MAUI pour l’ouvrir dans l’éditeur.

2. Dans l’éditeur Info.plist , passez de la vue Source à la vue Application :

   

3. Dans la section Signature de la vue Application , sélectionnez Provisionnement automatique, puis sélectionnez votre équipe dans la liste déroulante Équipe . Visual Studio pour Mac tentera de provisionner automatiquement votre projet et indiquera si le processus s’est terminé avec succès :

   

   Si l’approvisionnement automatique échoue, la fenêtre de signature automatique affiche la raison de l’erreur.

4. Fermez le fichier Info.plist .

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.

Visual Studio

1. Dans Visual Studio, vérifiez que l’IDE est associé à un hôte de build Mac. Pour plus d’informations, consultez Pair to 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 fil, consultez Déploiement sans fil pour les applications iOS .NET MAUI.

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

   

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

   

Remarque

Une autre approche du déploiement d’une application iOS .NET MAUI sur un appareil consiste à utiliser le redémarrage à chaud. Le redémarrage à chaud vous permet de déployer une application .NET MAUI sur un appareil iOS local 64 bits, à partir de Visual Studio, sans nécessiter d’hôte de build Mac. Pour plus d’informations, consultez Déployer une application iOS à l’aide du redémarrage à chaud.

Visual Studio pour Mac

Remarque

Visual Studio pour Mac est prévue pour la retraite d’août 31 2024 conformément à Politique de cycle de vie moderne de Microsoft. Visual Studio pour Mac 17.6 continuera d’être pris en charge jusqu’au 31 août 2024, avec des mises à jour de maintenance pour les problèmes de sécurité et les plateformes mises à jour d’Apple. Pour plus d’informations, notamment des options alternatives pour le développement sur un Mac, consultez Ce qui se passe pour Visual Studio pour Mac ?.

1. Dans la fenêtre Solution, double-cliquez sur le fichier Info.plist à partir du dossier Plateformes > iOS de votre projet d’application .NET MAUI pour l’ouvrir dans l’éditeur.

2. Dans l’éditeur Info.plist , passez de la vue Source à la vue Application :

   

3. Dans la section Informations de déploiement de la vue Application , définissez la cible de déploiement sur la version minimale prise en charge d’iOS pour votre application, à l’aide de la liste déroulante Cible de déploiement :

   

   Important

   La valeur cible de déploiement doit être identique à la valeur de version minimale iOS définie dans la boîte de dialogue Propriétés du projet sous l’onglet Plateformes cibles de build>.

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

5. Dans la barre d’outils Visual Studio pour Mac, vérifiez que la cible de débogage est définie sur votre appareil iOS connecté, puis appuyez sur le bouton Lecture pour lancer l’application sur votre appareil.

Exécuter l’approvisionnement automatique

Lorsque l’approvisionnement automatique est activé, Visual Studio réexécute le processus d’approvisionnement automatique si nécessaire lorsque l’une des opérations suivantes se produit :

• Un appareil iOS est connecté à votre Mac. Cela case activée automatiquement pour voir si l’appareil est inscrit dans votre compte de développeur Apple. Si ce n’est pas le cas, il l’ajoute et génère un nouveau profil d’approvisionnement qui le contient.
• L’ID de bundle de votre application est modifié. Cela met à jour l’ID d’application et donc un nouveau profil d’approvisionnement contenant cet ID d’application est créé.
• Une fonctionnalité prise en charge est activée dans le fichier Entitlements.plist . Cette fonctionnalité sera ajoutée à l’ID d’application et un nouveau profil d’approvisionnement avec l’ID d’application mis à jour est généré. Certaines fonctionnalités ne sont actuellement pas prises en charge. Pour plus d’informations sur les fonctionnalités, consultez Fonctionnalités.

ID d’applications génériques

Par défaut, l’approvisionnement automatique tente de créer et d’utiliser un id d’application et un profil d’approvisionnement génériques carte au lieu d’un ID d’application explicite basé sur l’identificateur de bundle de l’application. Les ID d’application wild carte réduisent le nombre de profils et d’ID à conserver dans votre compte de développeur Apple. Pour plus d’informations sur les ID d’application génériques carte, consultez Créer un profil d’approvisionnement de développement.

Dans certains cas, les droits d’une application nécessitent un ID d’application explicite. Les droits suivants ne prennent pas en charge les ID d’applications génériques :

• App Groups
• Domaines associés
• Apple Pay
• Centre de jeux
• HealthKit
• HomeKit
• Zone réactive
• Achat dans l’application
• Multipath
• NFC
• VPN personnel
• Notifications Push
• Configuration d’accessoires sans fil

Si votre application utilise l’un de ces droits, Visual Studio tente de créer un ID d’application explicite.

Résoudre les problèmes

L’approbation d’un nouveau compte développeur Apple peut prendre plusieurs heures. Vous ne pourrez pas activer l’approvisionnement automatique tant que le compte n’a pas été approuvé.

Si le processus d’approvisionnement automatique échoue avec le message Authentication Service Is Unavailabled’erreur, connectez-vous à app Store Connecter ou à votre compte développeur Apple pour case activée que vous avez accepté les derniers contrats de service.

Le certificat est introuvable dans le trousseau local

Si vous utilisez plusieurs ordinateurs pour le développement, vous pouvez recevoir le message d’erreur suivant lors de la tentative de configuration de l’approvisionnement automatique sur une machine : « Une erreur s’est produite lors de la tentative d’approvisionnement automatique du projet : « Certificat : Développement Apple : Créer via l’API (ID de clé) » existe déjà, mais elle est introuvable dans le trousseau local. Elle a peut-être été créée sur un autre ordinateur de développement. Importez le certificat et la clé privée à partir de cette machine ou révoquez-le et réessayez de créer automatiquement un nouveau certificat.' » :

Cela peut se produire, car l’approvisionnement automatique ne supprime pas la nécessité de copier manuellement des certificats entre les machines, lorsque vous utilisez plusieurs machines pour le développement. Cela est dû au fait que la clé privée qui crée un certificat existe uniquement sur l’ordinateur qui a créé le certificat.

Pour découvrir si un certificat requis est manquant dans votre ordinateur de développement, dans Visual Studio, accédez aux > outils Options > Xamarin > Apple Accounts. Ensuite, dans la boîte de dialogue Comptes de développeur Apple, sélectionnez une équipe, puis cliquez sur le bouton Afficher les détails... :

Si le certificat requis n’est pas installé sur l’ordinateur, la fenêtre Détails affiche un état « Pas dans le trousseau » pour le certificat. Dans ce scénario, le certificat spécifique doit être exporté à partir de l’ordinateur qui l’a créé, au format .p12, puis importé dans Visual Studio avec le bouton Importer le certificat .

Remarque

• Pour copier un certificat d’un Mac vers un autre Mac, exportez le certificat à partir de Keychain Access sur le Mac qui a créé le certificat, puis importez-le dans Keychain Access sur l’autre Mac.
• Pour copier un certificat d’un Mac vers une machine Windows, exportez le certificat à partir de Keychain Access sur mac, puis sur l’ordinateur Windows l’importez dans Visual Studio avec le bouton Importer le certificat .
• Il n’est pas possible de copier un certificat créé par Visual Studio sur un ordinateur Windows, sur un autre ordinateur, car il est protégé par mot de passe.

Une fois le certificat importé, Visual Studio affiche son état « Valide » :

Il doit ensuite être possible pour Visual Studio de provisionner automatiquement votre projet.