Publier une application Mac Catalyst pour la distribution ad hoc

Lors de la distribution d’applications Mac Catalyst en dehors du Mac App Store, vous pouvez également choisir de distribuer votre application à un nombre limité d’utilisateurs sur des appareils enregistrés. Il s’agit d’une distribution ad hoc, qui est principalement utilisée pour tester des applications au sein d’un groupe de personnes. Toutefois, une limite de 100 appareils par année d’adhésion s’applique, et les appareils doivent être ajoutés à votre compte Apple Developer. Les membres du programme des développeurs Apple et du programme Developer Enterprise d’Apple peuvent utiliser cette approche de distribution.

La distribution d’une application Mac Catalyst nécessite que l’application soit approvisionnée à l’aide d’un profil d’approvisionnement. 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 Mac Catalyst .NET Multi-platform App UI (.NET MAUI) en dehors du Mac App Store avec la distribution ad hoc, vous devez créer un profil de provisionnement de développement spécifique à celle-ci. Ce profil permet à l’application d’être signée numériquement pour publication afin qu’elle puisse être installée sur des Mac. Un profil d’approvisionnement de développement ad hoc contient un ID d’application, un certificat de développement et une liste des appareils pouvant installer l’application. 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 d’approvisionnement d’une application ac Catalyst .NET MAUI pour la distribution ad hoc est le suivant :

1. Créez une requête de signature de certificat. Pour plus d’informations, consultez Créer une demande de signature de certificat.
2. Créez un certificat de développement. Pour plus d’informations, consultez Créer un certificat de développement.
3. Créez un ID d’application. Pour plus d’informations, consultez Créer un ID d’application.
4. Ajoutez des appareils à votre compte Apple Developer. Pour plus d’informations, consultez Ajouter des appareils.
5. Créez un profil de provisionnement. Pour plus d’informations, consultez Créer un profil de provisionnement.
6. Téléchargez votre profil d’approvisionnement. Pour plus d’informations, consultez Télécharger votre profil d’approvisionnement dans Xcode.

Une fois l’approvisionnement terminé, vous devez préparer votre application pour la publication, puis la publier en suivant ce processus :

1. Si vous le souhaitez, ajoutez des droits à votre application. Pour plus d’informations, consultez Ajouter des droits.
2. Mettez à jour le fichier Info.plist de l’application. Pour plus d’informations, consultez Mettre à jour Info.plist.
3. Publiez votre application à l’aide de la ligne de commande. Pour plus d’informations, consultez Publier à l’aide de la ligne de commande.

Créer une demande de signature de certificat

Avant de créer un certificat de distribution, vous devez d’abord créer une demande de signature de certificat (RSC) dans Trousseau d’accès sur un Mac :

1. Sur votre Mac, démarrez Trousseau d’accès.

2. Dans Trousseau d’accès, sélectionnez l’élément de menu Trousseau d’accès > Assistant de certification > Demander un certificat auprès d’une autorité de certification....

3. Dans la boîte de dialogue Assistant de certification, entrez une adresse e-mail dans le champ Adresse e-mail de l’utilisateur.

4. Dans la boîte de dialogue Assistant de certification, entrez un nom pour la clé dans le champ Nom commun.

5. Dans la boîte de dialogue Assistant de certification, laissez le champ Adresse e-mail de l’autorité de certification vide.

6. Dans la boîte de dialogue Assistant de certification, choisissez la case d’option Enregistré sur disque, puis sélectionnez Continuer :

   

7. Enregistrez la demande de signature de certificat à un emplacement connu.

8. Dans la boîte de dialogue Assistant de certification, sélectionnez le bouton Terminé.

9. Fermez Trousseaux d’accès.

Créer un certificat de développement

La demande de signature de certificat vous permet de générer un certificat de développement, qui confirme votre identité. Le certificat de développement doit être créé avec l’ID Apple de votre compte de développeur Apple.

1. Dans un navigateur web, connectez-vous à votre compte Apple Developer.

2. Dans votre compte Apple Developer, accédez à l’onglet Certificates, IDs & Profiles.

3. Sur la page Certificates, Identifiers & Profiles, sélectionnez le bouton + pour créer un certificat.

4. Sur la page Create a New Certificate, sélectionnez la case d’option Apple Development avant de sélectionner le bouton Continue :

   

5. Sur la page Create a New Certificate, sélectionnez Choose File :

   

6. Dans la boîte de dialogue Choose Files to Upload, sélectionnez le fichier de demande de certificat que vous avez créé précédemment (un fichier avec une extension de fichier .certSigningRequest), puis sélectionnez Upload.

7. Sur la page Create a New Certificate, sélectionnez le bouton Continue :

   

8. Sur la page Download Your Certificate, sélectionnez le bouton Download :

   

   Le fichier de certificat (un fichier avec une extension .cer) sera téléchargé à l’emplacement de votre choix.

9. Sur votre Mac, double-cliquez sur le fichier de certificat téléchargé pour installer le certificat dans votre keychain. Le certificat apparaît dans la catégorie Mes certificats dans Trousseau d’accès et commence par Apple Development :

   

   Remarque

   Notez le nom complet du certificat dans Trousseaux d’accès. Il sera nécessaire lors de la signature de votre application.

Créer un profil de développement

Un profil d’approvisionnement de développement ad hoc permet à votre application Mac Catalyst .NET MAUI d’être signée numériquement, afin qu’elle puisse être installée sur des Mac spécifiques. Un profil d’approvisionnement de développement ad hoc contient un ID d’application, un certificat de développement et une liste des appareils pouvant installer l’application.

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 :

1. Dans votre compte de développeur Apple, accédez à Certificates, IDs & Profiles (Certificats, ID et profils).

2. Dans la page Certificats, identificateurs et profils, sélectionnez l’onglet Identificateurs.

3. Sur la page Identifiers, sélectionnez le bouton + pour créer un ID d’application.

4. Sur la page Register a new identifier, sélectionnez la case d’option App IDs avant de sélectionner le bouton Continue :

   

5. Sur la page Register a new identifier, sélectionnez App avant de sélectionner le bouton Continue :

   

6. 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.

7. 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.

8. Sur la page Register an App ID, sélectionnez le bouton Continue.

9. Sur la page Confirm your App ID, sélectionnez le bouton Register.

Ajouter des appareils

Lors de la création d’un profil d’approvisionnement pour la distribution ad hoc, le profil doit inclure les appareils qui peuvent exécuter l’application. Avant de sélectionner les appareils à ajouter au profil d’approvisionnement, vous devez d’abord ajouter les appareils à votre compte de développeur Apple. Pour ce faire, procédez comme suit :

1. Sélectionnez l’élément de menu Apple > À propos de ce Mac.

2. Dans l’onglet Vue d’ensemble, sélectionnez le bouton Rapport système....

3. Dans le Rapport système, sélectionnez le développeur Matériel pour afficher la vue d’ensemble du matériel. Le rapport affiche l’identificateur universel unique (UUID) en tant que Hardware UUID dans macOS 10.15 et versions antérieures, ou Provisioning UDID dans macOS 11.0 et versions ultérieures.

4. Sélectionnez la valeur Hardware UUID ou Provisioning UDID et copiez-la dans le Presse-papiers.

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

6. Sur la page Register a New Device, définissez la Platform sur macOS et donnez un nom au nouvel appareil. Collez ensuite l’identificateur du Presse-papiers dans le champ Device ID (UDID), puis cliquez sur le bouton Continue :

   

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

Répétez les étapes ci-dessus pour tous les Mac sur lesquels vous souhaitez déployer votre application Mac Catalyst .NET MAUI à l’aide de la distribution ad hoc.

Créer un profil de provisionnement

Une fois l’ID d’application créé, vous devez créer un profil d’approvisionnement de développement. Ce profil permet à l’application d’être signée numériquement afin qu’elle puisse être installée sur des Mac spécifiques.

Pour créer un profil d’approvisionnement pour la distribution ad hoc :

1. Sur la page Certificates, Identifiers & Profiles (Certificats, identificateurs et profils) de votre compte de développeur Apple, sélectionnez l’onglet Profiles (Profils).

2. Sous l’onglet Profiles (Profils), cliquez sur le bouton + pour créer un profil.

3. Sur la page Register a New Provisioning Profile, sélectionnez la case d’option macOS App Development avant de cliquer sur le bouton Continue :

   

4. Sur la page Generate a Provisioning Profile, sélectionnez la case d’option Mac Catalyst. Dans la liste déroulante App ID, sélectionnez ensuite l’ID d’application que vous avez créé précédemment avant de cliquer sur le bouton Continue :

   

5. Sur la page Generate a Provisioning Profile, sélectionnez la case à cocher correspondant à votre certificat de développement avant de cliquer sur le bouton Continue :

   

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

   

7. 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.

8. 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 le ferez dans Xcode.

Télécharger votre profil de provisionnement dans Xcode

Après avoir créé un profil de provisionnement dans votre compte Apple Developer, Xcode peut le télécharger afin qu’il soit disponible pour la signature de votre application :

1. Sur votre Mac, lancez Xcode.

2. Dans Xcode, sélectionnez l’élément de menu Xcode > Preférences….

3. Dans la boîte de dialogue Preferences, sélectionnez l’onglet Accounts.

4. Dans l’onglet Accounts, cliquez sur le bouton + pour ajouter votre compte Apple Developer à Xcode :

   

5. Dans la fenêtre contextuelle de type de compte, sélectionnez Apple ID, puis cliquez sur le bouton Continue :

   

6. Dans la fenêtre contextuelle de connexion, entrez votre ID Apple, puis cliquez sur le bouton Next.

7. Dans la fenêtre contextuelle de connexion, entrez votre mot de passe d’ID Apple, puis cliquez sur le bouton Next :

   

8. Dans l’onglet Accounts, cliquez sur le bouton Manage Certificates… pour vous assurer que votre certificat de distribution a été téléchargé.

9. Dans l’onglet Accounts, cliquez sur le bouton Download Manual Profiles pour télécharger vos profils de provisionnement :

   

10. Attendez que la fin du téléchargement, puis fermez Xcode.

Ajouter des droits

Le bac à sable d’application d’Apple limite l’accès aux ressources système et aux données utilisateur dans les applications Mac afin de contenir des dommages si une application devient compromise. Il doit être activé pour les applications Mac Catalyst distribuées via le Mac App Store, et peut éventuellement être activé pour les applications Mac Catalyst distribuées en dehors du Mac App Store.

Pour ce faire, ajoutez un fichier Entitlements.plist au dossier Platforms/MacCatalyst de votre projet d’application .NET MAUI :

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>com.apple.security.app-sandbox</key>
    <true/>
  </dict>
</plist>

Le droit du bac à sable d’application est défini en utilisant la clé com.apple.security.app-sandbox, de type boolean. Pour plus d’informations sur le bac à sable d’application, consultez Protecting user data with App Sandbox sur developer.apple.com. Pour plus d’informations sur le droit du bac à sable d’application, consultez App Sandbox Entitlement.

Si votre application ouvre des connexions réseau sortantes, vous devez également ajouter la clé com.apple.security.network.client, de type boolean, à votre fichier Entitlements.plist :

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>com.apple.security.app-sandbox</key>
    <true/>
    <key>com.apple.security.network.client</key>
    <true/>
  </dict>
</plist>

Pour plus d’informations sur le droit des connexions réseau sortantes, consultez com.apple.security.network.client sur developer.apple.com.

Mettre à jour Info.plist

Avant de distribuer votre application, vous devez mettre à jour son fichier Info.plist avec des informations supplémentaires.

Spécifier l’idiome de l’interface utilisateur

Une application Mac Catalyst peut s’exécuter dans l’idiome de l’interface utilisateur iPad ou Mac :

• L’idiome de l’interface utilisateur de l’iPad indique à macOS de mettre à l’échelle l’interface utilisateur de l’application pour l’adapter à l’environnement d’affichage du Mac tout en préservant l’apparence de l’iPad.
• L’idiome de l’interface utilisateur du Mac ne met pas à l’échelle l’interface utilisateur de l’application pour l’adapter à l’environnement d’affichage du Mac. Certains contrôles modifient leur taille et leur apparence et l’interaction avec eux est identique à celle avec les contrôles AppKit.

Par défaut, les applications Mac Catalyst .NET MAUI utilisent l’idiome de l’interface utilisateur iPad. S’il s’agit de votre comportement souhaité, vérifiez que le fichier Info.plist de l’application spécifie uniquement 2 comme valeur de la clé UIDeviceFamily :

<key>UIDeviceFamily</key>
<array>
  <integer>2</integer>
</array>

Pour adopter l’idiome de l’interface utilisateur Mac, mettez à jour le fichier Info.plist de l’application pour spécifier 6 comme valeur de la clé UIDeviceFamily :

<key>UIDeviceFamily</key>
<array>
  <integer>6</integer>
</array>

Pour plus d’informations sur les idiomes d’interface utilisateur de Mac Catalyst, consultez Spécifier l’idiome de l’interface utilisateur pour votre application Mac Catalyst.

Définir la langue et la région par défaut de l’application

Définissez la clé CFBundleDevelopmentRegion dans le fichier Info.plist de votre application sur une string qui représente la région de développement native de localisation :

<key>CFBundleDevelopmentRegion</key>
<string>en</string>

La valeur de la clé doit être un indicateur de langage, avec un indicateur de région facultatif. Pour plus d’informations, consultez CFBundleDevelopmentRegion sur developer.apple.com.

Définir la clé de copyright

Définissez la clé NSHumanReadableCopyright dans Info.plist de votre application sur une string qui représente une notification de copyright explicite pour votre application :

<key>NSHumanReadableCopyright</key>
<string>MyMauiApp © 2023</string>

Pour plus d’informations, consultez NSHumanReadableCopyright sur developer.apple.com.

Déclarer l’utilisation du chiffrement de votre application

Si votre application utilise le chiffrement et que vous envisagez de la distribuer en dehors des États-Unis ou du Canada, elle est soumise aux exigences de conformité des exportations des États-Unis. Vous pouvez fournir des informations sur l’utilisation du chiffrement de votre application dans son fichier Info.plist.

Pour ce faire, ajoutez la clé ITSAppUsesNonExemptEncryption au fichier Info.plist de votre application avec une valeur boolean qui indique si votre application utilise le chiffrement :

<key>ITSAppUsesNonExemptEncryption</key>
<false/>

Pour plus d’informations, consultez Complying with Encryption Export Regulations sur developer.apple.com.

Publier en utilisant la ligne de commande

Pour publier votre application Mac Catalyst à partir de la ligne de commande sur un Mac, ouvrez un terminal et accédez au dossier de votre projet d’application .NET MAUI. Exécutez la commande dotnet publish, en fournissant les paramètres suivants :

Des paramètres de build supplémentaires peuvent être spécifiés sur la ligne de commande, s’ils ne sont pas fournis dans un <PropertyGroup> dans votre fichier projet. Le tableau suivant répertorie certains paramètres courants :

Pour obtenir la liste complète des propriétés de build, consultez Project file properties.

Par exemple, utilisez la commande suivante pour générer et signer un .pkg sur un Mac, pour la distribution à des utilisateurs sur des appareils enregistrés :

dotnet publish -f net8.0-maccatalyst -c Release -p:MtouchLink=SdkOnly -p:CreatePackage=true -p:EnableCodeSigning=true  -p:CodesignKey="Apple Development: John Smith (AY2GDE9QM7)" -p:CodesignProvision="MyMauiApp (Ad-hoc)" -p:CodesignEntitlements="Platforms\MacCatalyst\Entitlements.plist" -p:UseHardenedRuntime=true

La publication génère, signe et empaquette l’application, puis copie le .pkg dans le dossier bin/Release/net8.0-maccatalyst/publish/. Si vous publiez l’application à l’aide d’une seule architecture, elle sera publiée dans le dossier bin/Release/net8.0-maccatalyst/{architecture}/publish/.

Pendant le processus de signature, vous devrez peut-être entrer votre mot de passe de connexion et autoriser l’exécution de codesign :

Pour plus d’informations sur la commande dotnet publish, consultez dotnet publish.

Définir les propriétés de build dans votre fichier projet

Une alternative à la spécification des paramètres de build sur la ligne de commande consiste à les spécifier dans votre fichier projet dans un <PropertyGroup>. Le tableau suivant répertorie certaines propriétés courantes de build :

Pour obtenir la liste complète des propriétés de build, consultez Project file properties.

L’exemple suivant montre un groupe de propriétés classique pour la création et la signature de votre application Mac Catalyst pour la distribution ad hoc à des utilisateurs sur des appareils enregistrés :

<PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Release|net8.0-maccatalyst|AnyCPU'">
  <MtouchLink>SdkOnly</MtouchLink>
  <EnableCodeSigning>True</EnableCodeSigning>
  <CreatePackage>true</CreatePackage>
  <CodesignKey>Apple Development: John Smith (AY2GDE9QM7)</CodesignKey>
  <CodesignProvision>MyMauiApp (Ad-hoc)</CodesignProvision>
  <CodesignEntitlements>Platforms\MacCatalyst\Entitlements.plist</CodesignEntitlements>
  <UseHardenedRuntime>true</UseHardenedRuntime>
</PropertyGroup>

Cet exemple de <PropertyGroup> ajoute une vérification de conditions, qui empêche le traitement de ces paramètres sauf si la vérification de conditions est concluante. La vérification de conditions recherche deux éléments :

1. La configuration de build est définie sur Release.
2. L’infrastructure cible est définie sur un élément contenant le texte net8.0-maccatalyst.
3. La plateforme est définie sur AnyCPU.

Si l’une de ces conditions n’est pas remplie, les paramètres ne sont pas traités. Plus important encore, les paramètres <CodesignKey> et <CodesignProvision> ne sont pas définis, ce qui empêche la signature de l’application.

Après avoir ajouté le groupe de propriétés ci-dessus, l’application peut être publiée à partir de la ligne de commande sur un Mac en ouvrant un terminal et en accédant au dossier de votre projet d’application .NET MAUI. Ensuite, exécutez la commande suivante :

dotnet build -f net8.0-maccatalyst -c Release

La publication génère, signe et empaquette l’application, puis copie le .pkg dans le dossier bin/Release/net8.0-maccatalyst/publish/.

Distribuer votre application à des fins de test

Le .pkg peut être distribué à des utilisateurs sur des appareils enregistrés, où il peut être exécuté en double-cliquant sur le fichier .pkg pour installer l’application.

Pour plus d’informations sur l’ouverture sécurisée d’applications sur un Mac, consultez Ouvrir des applications en toute sécurité sur votre Mac sur support.apple.com.

Voir aussi

• Distributing your app to registered devices sur developer.apple.com
• Preparing your app for distribution sur developer.apple.com
• Hardened Runtime sur developer.apple.com