Publier une application iOS pour la distribution ad hoc
La distribution ad hoc est principalement utilisée pour tester des applications au sein d’un large groupe de personnes, et est disponible pour les programmes Apple Developer Program et Apple Developer Enterprise Program. Un autre cas d’usage pour la distribution ad hoc est celui d’une distribution en entreprise sans iTunes Connect.
La distribution ad hoc présente l’avantage de ne pas exiger l’approbation de l’App Store, avec des applications installées avec Apple Configurator. Toutefois, une limite de 100 appareils par année d’adhésion s’applique, pour le développement et la distribution, et les appareils doivent être ajoutés à votre compte Apple Developer.
La distribution d’une application iOS nécessite que l’application soit approvisionnée à l’aide d’un profil de provisionnement. Les profils de provisionnement sont des fichiers qui contiennent des informations de signature de code, ainsi que l’identité de l’application et son mécanisme de distribution prévu.
Pour distribuer une application iOS .NET multiplateforme (.NET MAUI), vous devez créer un profil de provisionnement de distribution spécifique à celui-ci. Ce profil permet à l’application d’être signée numériquement pour publication afin qu’elle puisse être installée sur un appareil iOS. Un profil de provisionnement de distribution ad hoc contient un ID d’application, un certificat de distribution et une liste des appareils pouvant installer l’application. Vous pouvez utiliser le même ID d’application que celui que vous avez utilisé lors du déploiement de votre application sur un appareil à des fins de test. Toutefois, vous devez créer un certificat de distribution pour vous identifier, vous ou votre organisation, si vous n’en avez pas déjà un.
Le processus de création d’un profil de provisionnement de distribution ad hoc est le suivant :
- Créez un certificat de distribution. Pour plus d’informations, consultez Créer un certificat de distribution.
- Ajoutez des appareils à votre compte Apple Developer. Pour plus d’informations, consultez Ajouter un appareil.
- Créez un ID d’application. Pour plus d’informations, consultez Créer un ID d’application.
- Créez un profil de provisionnement. Pour plus d’informations, consultez Créer un profil de provisionnement.
Créer un certificat de distribution
Un certificat de distribution est utilisé pour confirmer votre identité. Avant de créer un certificat de distribution, vous devez vous assurer que vous avez ajouté votre compte de développeur Apple à Visual Studio. Pour plus d’informations, consultez Gestion des comptes Apple.
Vous devez uniquement créer un certificat de distribution si vous n’en avez pas déjà un. Vous devez créer le certificat de distribution avec l’ID Apple de votre compte de développeur Apple.
Pour créer un certificat de distribution dans Visual Studio :
- Dans Visual Studio, accédez à Outils > Options > Xamarin > Comptes Apple.
- Dans la boîte de dialogue Comptes de développeur Apple, sélectionnez une équipe, puis cliquez sur le bouton Afficher les détails....
- Dans la boîte de dialogue Détails, cliquez sur Créer un certificat et sélectionnez Distribution iOS. Une nouvelle identité de signature sera créée et synchronisée avec Apple, à condition que vous disposiez des autorisations appropriées.
Important
La clé privée et le certificat qui composent votre identité de signature sont également exportés vers Keychain Access sur votre hôte de build Mac, à condition que l’IDE soit associé à celui-ci. Pour plus d’informations, consultez Appairer avec un Mac pour le développement iOS.
Présentation des paires clé/certificat
Un profil de distribution contient des certificats, leurs clés associées et tous les profils de provisionnement associés à votre compte de développeur Apple. Il existe deux versions d’un profil de distribution : l’une existe dans votre compte de développeur Apple 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.
Avertissement
La perte du certificat et des clés associées peut être extrêmement perturbatrice, car elle nécessite la révocation des certificats existants et la recréation de profils de provisionnement.
Créer un profil de distribution
Un profil de provisionnement de distribution permet à votre application iOS .NET MAUI d’être signée numériquement pour publication, afin qu’elle puisse être installée sur un appareil iOS. Un profil de provisionnement de distribution ad hoc contient un ID d’application, un certificat de distribution et une liste des appareils pouvant installer l’application. Les appareils que vous souhaitez prendre en charge doivent 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 :
Connectez l’appareil à approvisionner à votre Mac local avec un câble USB.
Ouvrez Xcode, puis accédez à Window > Devices and Simulators.
Dans Xcode, sélectionnez l’onglet Devices, puis sélectionnez l’appareil dans la liste des appareils connectés.
Dans Xcode, copiez la valeur de Identifier dans le presse-papiers :
Dans un navigateur web, accédez à la section Devices de votre Apple Developer, puis cliquez sur le bouton +.
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 :
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
Un ID d’application est requis pour identifier l’application que vous distribuez. 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. Vous pouvez utiliser le même ID d’application que celui que vous avez utilisé lors du déploiement de votre application sur un appareil à des fins de test.
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.*. Vous pouvez utiliser un ID d’application générique pour distribuer plusieurs applications. Vous devez l’utiliser dans le cas d’applications qui n’activent pas les 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 la distribution d’une application, avec un identificateur de bundle correspondant. 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. Pour plus d’informations sur les fonctionnalités, consultez Fonctionnalités.
Pour créer un ID d’application :
Dans votre compte de développeur Apple, accédez à Certificates, IDs & Profiles (Certificats, ID et profils).
Dans la page Certificats, identificateurs et profils, sélectionnez l’onglet Identificateurs.
Sur la page Identifiers (Identificateurs), cliquez sur le bouton + pour créer un ID d’application.
Sur la page Register a new identifier (Inscrire un nouvel identificateur), sélectionnez la case d’option App IDs (ID d’application) avant de cliquer sur le bouton Continue (Continuer) :
Sur la page Register a new identifier (Inscrire un nouvel identificateur), sélectionnez App (Application) avant de cliquer sur le bouton Continue (Continuer) :
Sur la page Register an App ID (Inscrire un ID d’application), entrez une description, puis sélectionnez la case d’option d’ID de bundle Explicit (Explicite) ou Wildcard (Générique). Entrez ensuite l’ID de bundle de votre application au format DS inverse :
Important
L’ID de bundle que vous entrez doit correspondre au Bundle identifier (Identificateur de bundle) dans le fichier Info.plist de votre projet d’application.
L’identificateur de bundle d’une application .NET MAUI est stocké dans le fichier projet en tant que propriété ID d’application : Dans Visual Studio, dans l’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 MAUI partagé > Général. Le champ ID d’application répertorie l’identificateur de bundle.
Lorsque la valeur du champ ID d’application est mise à jour, la valeur de l’Identificateur de bundle dans Info.plist sera automatiquement mise à jour.
Sur la page Inscrire un ID d’application, sélectionnez les fonctionnalités que l’application utilise. Toutes les fonctionnalités doivent être configurées à la fois sur cette page et dans le fichier Entitlements.plist dans votre projet d’application. Pour plus d’informations, consultez Fonctionnalités et Droits.
Sur la page Inscrire un ID d’application, cliquez sur le bouton Continuer.
Sur la page Confirmer votre ID d’application, cliquez sur le bouton Inscrire.
Créer un profil de provisionnement
Une fois l’ID d’application créé, vous devez créer un profil de provisionnement de distribution. Ce profil permet à l’application d’être signée numériquement pour publication afin qu’elle puisse être installée sur un appareil iOS.
Pour créer un profil d’approvisionnement pour la distribution ad hoc :
Sur la page Certificates, Identifiers & Profiles (Certificats, identificateurs et profils) de votre compte de développeur Apple, sélectionnez l’onglet Profiles (Profils).
Sous l’onglet Profiles (Profils), cliquez sur le bouton + pour créer un profil.
Sur la page Register a New Provisioning Profile, sélectionnez la case d’option Ad Hoc avant de cliquer sur le bouton Continue :
Sur la page Generate a Provisioning Profile, dans la liste déroulante App ID, sélectionnez l’ID d’application que vous avez créé précédemment et choisissez si vous souhaitez créer un profil hors connexion avant de cliquer sur le bouton Continue :
Sur la page Generate a Provisioning Profile (Générer un profil de provisionnement), sélectionnez la case d’option correspondant à votre certificat de distribution avant de cliquer sur le bouton Continue (Continuer) :
Sur la page Generate a Provisioning Profile, sélectionnez les appareils sur lesquels l’application sera installée, puis cliquez sur le bouton Continue.
Sur la page Generate a Provisioning Profile (Générer un profil de provisionnement), entrez un nom pour le profil de provisionnement avant de cliquer sur le bouton Generate (Générer) :
Remarque
Notez le nom du profil de provisionnement, car il sera nécessaire lors de la signature de votre application.
Sur la page Generate a Provisioning Profile (Générer un profil de provisionnement), cliquez éventuellement sur le bouton Download (Télécharger) pour télécharger votre profil de provisionnement.
Remarque
Il n’est pas nécessaire de télécharger votre profil de provisionnement maintenant. Au lieu de cela, vous allez le faire dans Visual Studio.
Télécharger des profils de provisionnement dans Visual Studio
Après avoir créé un profil d’approvisionnement de distribution dans votre compte de développeur Apple, Visual Studio peut le télécharger afin qu’il soit disponible pour la signature de votre application.
- Dans Visual Studio, accédez à Outils > Options > Xamarin > Comptes Apple.
- Dans la boîte de dialogue Comptes de développeur Apple, sélectionnez votre équipe, puis cliquez sur Afficher les détails.
- Dans la boîte de dialogue Détails, vérifiez que le nouveau profil apparaît dans la liste Profils de provisionnement. Vous devrez peut-être redémarrer Visual Studio pour actualiser la liste.
- Dans la boîte de dialogue Détails, cliquez sur Télécharger tous les profils.
Les profils de provisionnement sont téléchargés sur Windows et exportés vers votre hôte de build Mac si l’IDE est associé à celui-ci. Pour plus d’informations, consultez Appairer avec un Mac pour le développement iOS.
Publier l’application
Visual Studio peut publier une application iOS .NET MAUI pour la distribution ad hoc :
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.
Dans la barre d’outils Visual Studio, utilisez la liste déroulante Cible de débogage pour sélectionner Appareils distants iOS, puis Appareil distant :
Dans la barre d’outils Visual Studio, utilisez la liste déroulante Configuration de solutions pour passer de la configuration de débogage à la configuration de mise en production :
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 Signature de bundle iOS et vérifiez que Schéma est défini sur Provisionnement manuel, qu’Identité de signature est défini sur Distribution (automatique) et que Profil de provisionnement est défini sur Automatique :
Ces paramètres garantissent que Visual Studio sélectionne le profil de provisionnement correct 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). Vous pouvez également définir Identité de signature sur le certificat de distribution approprié et Profil de provisionnement sur le profil que vous avez créé dans votre compte de développeur Apple.
Dans l’Explorateur de solutions, cliquez avec le bouton droit sur votre projet d’application .NET MAUI et sélectionnez Publier... :
Le Gestionnaire d’archivage s’ouvre et Visual Studio commence à archiver votre ensemble d’applications :
Le processus d’archivage signe l’application avec le certificat et les profils de provisionnement que vous avez spécifiés dans l’onglet Signature d’offre groupée iOS, pour la configuration de la solution sélectionnée.
Dans le Gestionnaire d’archivage, une fois l’archivage terminé, vérifiez que votre archive est sélectionnée, puis sélectionnez le bouton Distribuer... pour commencer le processus d’empaquetage de votre application pour la distribution :
La boîte de dialogue Distribuer – Sélectionnez un canal s’affiche.
Dans la boîte de dialogue Distribuer – Sélectionnez un canal, sélectionnez le bouton App Hoc :
Dans la boîte de dialogue Distribuer – Identité de signature, sélectionnez votre identité de signature et votre profil de provisionnement :
Remarque
Vous devez utiliser l’identité de signature et le profil de provisionnement créés pour votre application et le canal de distribution sélectionné.
Dans la boîte de dialogue Distribuer - Identité de signature, sélectionnez le bouton Enregistrer sous et entrez un nom de fichier. Votre application sera ensuite signée à nouveau et publiée dans un fichier .ipa sur votre système de fichiers.
L’application peut ensuite être distribuée en utilisant Apple Configurator. Pour plus d’informations, consultez le guide d’utilisation d’Apple Configurator sur support.apple.com.
Pour plus d’informations sur la publication d’une application iOS à l’aide de l’interface de ligne de commande (CLI), consultez Publier une application iOS à l’aide de la ligne de commande.
