Utilisation des fonctionnalités dans Xamarin.iOS

L’ajout de fonctionnalités à une application nécessite souvent une configuration plus poussée du provisionnement. Ce guide explique les paramètres requis par les différentes fonctionnalités.

Apple fournit aux développeurs diverses fonctionnalités, souvent appelées services d’application, qui leur permettent de proposer des applications iOS plus complètes et dotées de capacités étendues. Les développeurs peuvent mieux intégrer les fonctionnalités de la plateforme à leurs applications, par exemple, des transactions monétaires lancées à partir de l’application, des services d’appareil supplémentaires comme Siri, et bien plus encore. Ces fonctionnalités sont compatibles avec les projets Xamarin.iOS. Voici la liste complète des services :

• App Groups
• Domaines associés
• Protection des données
• Centre de jeux
• HealthKit
• HomeKit
• Configuration d’accessoires sans fil
• iCloud
• In-App Purchase
• Inter-App Audio
• Apple Pay
• Portefeuille
• Notification Push
• VPN personnel
• Siri
• Maps
• Background Modes
• Keychain Sharing
• Extensions réseau
• Hotspot Configuration
• Multipath
• Lecture d’étiquettes NFC

Vous pouvez activer ces fonctionnalités à partir de Visual Studio pour Mac et Visual Studio 2019, ou manuellement dans le portail des développeurs d’Apple. Certaines fonctionnalités, telles que Wallet, Apple Pay et iCloud, nécessitent une configuration supplémentaire des ID d’application.

Ce guide décrit comment activer chacun de ces services d’application automatiquement dans votre application dans Visual Studio ou manuellement par le biais du Developer Center. Il précise également la configuration supplémentaire nécessaire, s’il y a lieu.

Ajout de services d’application

Pour utiliser des fonctionnalités, l’application doit avoir un profil de provisionnement valide contenant un ID d’application pour lequel le service approprié est activé. Ce profil de provisionnement peut être créé automatiquement dans Visual Studio pour Mac et Visual Studio 2019, ou manuellement dans Apple Developer Center.

Cette section décrit comment utiliser le provisionnement automatique de Visual Studio ou le Developer Center pour activer la plupart des fonctionnalités. Certaines fonctionnalités telles que Wallet, iCloud, Apple Pay et App Groups nécessitent une configuration supplémentaire. Celles-ci sont décrites en détail dans les guides correspondants.

Important

Toutes les fonctionnalités ne peuvent pas être ajoutées et gérées avec le provisionnement automatique. La liste suivante répertorie les fonctionnalités prises en charge :

• HealthKit
• HomeKit
• VPN personnel
• Configuration d’accessoires sans fil
• Inter-App Audio
• SiriKit
• Zone réactive
• Extensions réseau
• Lecture d’étiquettes NFC
• Multipath

Les fonctionnalités Push Notifications, Game Center, In-App Purchase, Maps, Keychain Sharing, Associated Domains et Data Protection ne sont pas prises en charge. Pour ajouter ces fonctionnalités, utilisez le provisionnement manuel et suivez les étapes décrites dans la section Developer center.

Utilisation de l'IDE

Visual Studio pour Mac

Les fonctionnalités sont ajoutées au fichier Entitlements.plist dans Visual Studio pour Mac. Pour ajouter des fonctionnalités, utilisez les étapes suivantes :

1. Ouvrez le fichier Info.plist de votre application iOS, puis sélectionnez le schéma Provisionnement automatique et votre Équipe dans la zone de liste modifiable. Si vous avez besoin d’aide, suivez les étapes décrites dans le guide Provisionnement automatique :

   

2. Ouvrez le fichier Entitlements.plist et sélectionnez la fonctionnalité que vous souhaitez ajouter :

   

   La sélection d’une fonctionnalité a deux actions :

   • Elle ajoute cette fonctionnalité à votre ID d’application.
   • Elle ajoute la paire clé-valeur du droit dans votre fichier Entitlements.plist.

   Visual Studio pour Mac vous signale la réussite de ces opérations par le message suivant :

   

Visual Studio

Les fonctionnalités sont ajoutées à Entitlements.plist. Pour ajouter des fonctionnalités dans Visual Studio 2019, effectuez les étapes suivantes :

1. Appairez Visual Studio 2019 avec un Mac comme décrit dans le guide Appairer avec un Mac.

2. Ouvrez les options d’approvisionnement en sélectionnant Propriétés d’approvisionnement de projet > ...

3. Sélectionnez le schéma Provisionnement automatique et votre Équipe dans la zone de liste modifiable. Si vous avez besoin d’aide, suivez les étapes décrites dans le guide Provisionnement automatique :

   

4. Ouvrez le fichier Entitlements.plist et sélectionnez la fonctionnalité à ajouter. Enregistrez le fichier.

   L’enregistrement du fichier Entitlement.plist a deux actions :

   • Elle ajoute cette fonctionnalité à votre ID d’application.
   • Elle ajoute la paire clé-valeur du droit dans votre fichier Entitlements.plist.

Utilisation du Developer Center

Pour accéder au developer center, vous devez effectuer deux étapes : créer un ID d’application, puis créer un profil de provisionnement à l’aide de ce nouvel ID d’application. Ces étapes sont détaillées ci-dessous.

Création d’un ID d’application avec un service d’application

1. Accédez au developer center d’Apple sur un Mac (l’hôte de build Mac si vous utilisez une machine Windows) et ouvrez une session.

2. Sélectionnez Certificates, Identifiers & Profiles :

   

3. Sous Identifiers, sélectionnez App IDs :

   

4. Appuyez sur le bouton + dans le coin supérieur droit pour créer un ID d’application.

5. Entrez une description de l’ID d’application, sélectionnez Explicit App ID et entrez un ID de bundle au format com.domain.appname. Cet ID de bundle doit correspondre à l’ID de bundle défini dans votre projet :

   

6. Sous App Services, sélectionnez le ou les services souhaités dans votre application :

   

7. Appuyez sur Continue.

8. Confirmez votre ID d’application. Chaque service peut avoir l’un des états suivants : Enabled, Disabled ou Configurable, comme illustré ci-dessous. S’il a l’état Enabled, il est prêt à être utilisé dans un profil de provisionnement. S’il a l’état Configurable, une configuration supplémentaire est requise pour cette fonctionnalité. Ces étapes supplémentaires seront décrites plus en détail dans des sections ultérieures.

   

9. Cliquez sur Register, puis sur Done. Le nouvel ID d’application s’affiche normalement dans la liste des ID d’application iOS.

Création d’un profil de provisionnement

Maintenant, créez un profil de provisionnement qui contient cet ID d’application. Procédez comme suit :

1. Dans le Centre de développement Apple, accédez à Tous les profils >d’approvisionnement :

   

2. Appuyez sur le bouton + dans le coin supérieur droit pour créer un profil de provisionnement.

3. Sélectionnez le type de profil de provisionnement souhaité, puis cliquez sur Continue :

   

4. Dans la liste déroulante, sélectionnez l’ID d’application que vous avez créé plus haut, puis appuyez sur Continue :

   

5. Sélectionnez les certificats utilisés pour signer l’application et appuyez sur Continue :

   

6. Sélectionnez les appareils à inclure dans ce profil et appuyez sur Continue :

   

7. Nommez le profil afin qu’il soit facilement identifiable et appuyez sur Continue pour générer le profil :

   

8. Appuyez sur le bouton Download pour télécharger le profil, puis double-cliquez sur le fichier dans le Finder pour installer le profil de provisionnement.

9. Si vous utilisez Visual Studio, vérifiez que l’option Provisionnement manuel est sélectionnée.

10. Dans Visual Studio pour Mac /Visual Studio, accédez à La signature groupée des options > de projet et définissez le profil d’approvisionnement sur celui qui vient d’être créé :

    

Important

Vous devrez peut-être aussi définir des clés de droit dans le fichier Entitlement.plist et des clés de confidentialité dans le fichier Info.plist. Pour plus d’informations sur ces droits, consultez le guide Utilisation de droits.

Étapes suivantes

Une fois que vous avez ajouté une fonctionnalité côté serveur, il vous reste quelques étapes à effectuer pour permettre à votre application d’utiliser la fonctionnalité. S’il y a lieu, effectuez les étapes supplémentaires décrites ci-après :

• Utilisez l’espace de noms de framework dans votre application.
• Ajoutez les droits requis à votre application. Pour obtenir des informations détaillées sur les droits requis et leur ajout, consultez le guide Utilisation de droits.

Dépannage

La liste ci-dessous décrit quelques-uns des problèmes les plus courants susceptibles d’entraver le développement d’une application avec un service d’application activé.

• Assurez-vous que l’ID correct a été créé et enregistré de manière appropriée dans la section Certificates, Identifiers & Profiles du portail des développeurs d’Apple.
• Assurez-vous que le service a été ajouté à l’ID d’application (ou d’extension) et qu’il est configuré pour utiliser l’identificateur App Group/Merchant ID/Container créé précédemment dans la section Certificates, Identifiers & Profiles du portail des développeurs d’Apple.
• Assurez-vous que les profils de provisionnement et les ID d’application ont été installés, et que le fichier d’application Info.plist (dans le projet Xamarin) utilise l’un des ID d’application configurés plus haut.
• Assurez-vous que le service approprié est activé dans le fichier d’application Entitlements.plist (dans le projet Xamarin).
• Assurez-vous que les clés de confidentialité appropriées sont définies dans le fichier Info.plist
• Assurez-vous que, dans la section Signature du bundle iOS de l’application, le paramètre Droits personnalisés est défini sur Entitlements.plist. Ce n’est pas le paramètre par défaut pour les builds Debug et iOS Simulator.

Résumé

Ce guide a présenté les différentes fonctionnalités, ou services d’application, puis a expliqué comment les activer dans Visual Studio et dans le developer center d’Apple. Il a également détaillé comment configurer des services plus complexes tels que les services Wallet, iCloud, Apple Pay et App Groups. Enfin, il a indiqué les étapes suivantes à effectuer pour la configuration ainsi que des options de dépannage simples.