Partager via


Publier une application Mac Catalyst pour la distribution Mac App Store

L’approche la plus courante pour distribuer des applications Mac Catalyst aux utilisateurs est via le Mac App Store. Les applications sont soumises au Mac App Store via un outil en ligne appelé App Store Connect. Seuls les développeurs qui appartiennent au Programme des développeurs Apple ont accès à cet outil. Les membres du programme Developer Enterprise d’Apple n’y ont pas accès. Toutes les applications soumises au Mac App Store nécessitent l’approbation d’Apple.

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), vous devez créer un profil de provisionnement de distribution 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 de provisionnement de distribution contient un ID d’application et un certificat de distribution. 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. En outre, vous devez créer un certificat d’installation Mac pour signer le package d’installation de votre application pour la soumission au Mac App Store.

Le processus d’approvisionnement d’une application Mac Catalyst .NET MAUI pour la distribution via le Mac App Store 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 distribution. Pour plus d’informations, consultez Créer un certificat de distribution.
  3. Créez un certificat d’installation. Pour plus d’informations, consultez Créer un certificat d’installation.
  4. Créez un ID d’application. Pour plus d’informations, consultez Créer un ID d’application.
  5. Configurez l’ID de l’application Pour plus d’informations, consultez Configurer l’ID de l’application.
  6. Créez un profil de provisionnement. Pour plus d’informations, consultez Créer un profil de provisionnement.
  7. 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. Ajoutez les droits requis à 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 :

    Boîte de dialogue Assistant de certification.

  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 distribution

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

  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 Distribution avant de sélectionner le bouton Continue :

    Créez un certificat de distribution Apple.

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

    Chargez votre demande de signature de certificat pour un certificat de distribution Apple.

  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 :

    Continuez à générer votre certificat de distribution.

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

    Téléchargez votre certificat de distribution Apple.

    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 Distribution :

    Trousseau d’accès montrant le certificat de distribution.

    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 certificat d’installation

La demande de signature de certificat vous permet de générer un certificat d’installation, qui est nécessaire pour signer votre package d’installation de votre application pour la soumission au Mac App Store. Le certificat d’installation doit être créé avec l’ID Apple de votre compte Apple Developer :

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

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

  3. Sur la page Create a New Certificate, sélectionnez la case d’option Mac Installer Distribution avant de sélectionner le bouton Continue :

    Créez un certificat de distribution d’installation Mac.

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

    Chargez votre demande de signature de certificat pour un certificat d’installation Mac.

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

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

    Continuez à générer votre certificat d’installation.

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

    Téléchargez votre certificat d’installation Mac.

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

  8. 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 Trousseaux d’accès et commence par 3rd Party Mac Developer Installer :

    Trousseaux d’accès montrant le certificat d’installation ID de développeur.

    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 distribution

Un profil de provisionnement de distribution permet à votre application Mac Catalyst .NET MAUI d’être signée numériquement pour publication, afin qu’elle puisse être installée sur un autre Mac. Un profil de provisionnement de distribution Mac App Store contient un ID d’application et un certificat de distribution.

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 :

    Créez un ID d’application.

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

    Enregistrez un ID d’application.

  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 :

    Spécifiez l’identificateur de bundle pour l’application.

    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.

Configurer l’ID de l’application

Par défaut, une application Mac Catalyst utilise le même ID d’offre groupée qu’une application iOS pour vous permettre d’offrir les applications ensemble en tant qu’achat universel sur le Mac App Store. Vous pouvez également spécifier un ID d’offre groupée unique pour offrir l’application en tant que produit distinct.

Pour configurer l’ID de l’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 l’ID d’application que vous venez de créer.

  4. Dans la page Edit your App ID Configuration, faites défiler jusqu’au bas de la page et cochez la case de fonctionnalité Mac Catalyst. Sélectionnez ensuite le bouton Configure.

    Activez la fonctionnalité Mac Catalyst.

  5. Dans la fenêtre contextuelle Configure Bundle ID for Mac Catalyst, sélectionnez la case d’option Use existing Mac App ID. Dans la liste déroulante App ID, sélectionnez l’ID d’application de votre application iOS partenaire de Mac Catalyst ou l’ID d’application que vous avez créé si vous proposez l’application Mac Catalyst comme produit distinct. Sélectionnez ensuite le bouton Save :

    Configurez l’ID d’offre groupée pour Mac Catalyst.

  6. Dans la page Edit your App ID Configuration, sélectionnez le bouton Save :

    Enregistrez la configuration de Mac Catalyst.

  7. Dans la fenêtre contextuelle Modify App Capabilities, sélectionnez le bouton Confirm.

    Modifiez les fonctionnalités de l’application.

Créer un profil de provisionnement

Une fois l’ID d’application créé et configuré, 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 des Mac.

Pour créer un profil de provisionnement pour la distribution Mac App Store :

  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 Mac App Store avant de cliquer sur le bouton Continue :

    Inscrivez un profil de provisionnement pour distribution dans l’App Store.

  4. Sur la page Generate a Provisioning Profile, sélectionnez la case d’option Mac. 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 :

    Sélectionnez votre ID d’application.

  5. 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) :

    Sélectionnez votre certificat de distribution.

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

    Générez le profil de provisionnement.

    Remarque

    Notez le nom du profil de provisionnement, car il sera nécessaire lors de la signature de votre application.

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

    Boîte de dialogue Accounts Xcode dans les préférences.

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

    Fenêtre contextuelle Xcode Select the type of account you'd like to add.

  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 :

    Connexion au compte Apple Xcode.

  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 :

    Détails du compte de programme Apple Developer Xcode.

  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 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 publier votre application, vous devez mettre à jour son fichier Info.plist avec des informations supplémentaires pour vous assurer que l’application peut être chargée dans le Mac App Store et vous aider à garantir un processus de révision de Mac App Store fluide.

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é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éfinir la catégorie d’application

Les catégories aident les utilisateurs à trouver votre application sur le Mac App Store. Vous pouvez définir la catégorie principale de l’application dans votre fichier Info.plist :

<key>LSApplicationCategoryType</key>
<string>public.app-category.utilities</string>

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

Remarque

La catégorie principale de votre application doit correspondre à la catégorie principale que vous avez définie dans App Store Connect.

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. Chaque fois que vous soumettez une version de votre application à App Store Connect, elle subit un examen de conformité des réglementations d’exportation de chiffrement. Pour éviter qu’App Store Connect vous pose des questions pour vous guider dans la révision, vous pouvez fournir les informations requises dans le fichier Info.plist de votre application.

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 :

Paramètre Valeur
-f ou --framework Infrastructure cible, c’est-à-dire net8.0-maccatalyst.
-c ou --configuration Configuration de build, c’est-à-dire Release.
-p:MtouchLink Mode lien du projet, qui peut être None, SdkOnly ou Full.
-p:CreatePackage Définir sur true pour qu’un package (.pkg) soit créé pour l’application à la fin de la build.
-p:EnableCodeSigning Définir sur true pour que le code de signature soit activé.
-p:EnablePackageSigning Définir sur true pour que le package créé soit signé.
-p:CodesignKey Nom de la clé de signature du code. Définir sur le nom de votre certificat de distribution, comme indiqué dans Trousseaux d’accès.
-p:CodesignProvision Profil de provisionnement à utiliser lors de la signature de l’ensemble d’applications.
-p:CodesignEntitlements Chemin d’accès au fichier des droits qui spécifie les droits dont a besoin l’application. Réglez sur Platforms\MacCatalyst\Entitlements.plist.
-p:PackageSigningKey Clé de signature de package à utiliser lors de la signature du package. Définir sur le nom de votre certificat d’installation, comme indiqué dans Trousseaux d’accès.

Avertissement

La tentative de publication d’une solution .NET MAUI entraîne la commande dotnet publish qui tente de publier chaque projet dans la solution individuellement, ce qui peut entraîner des problèmes lorsque vous avez ajouté d’autres types de projets à votre solution. Par conséquent, la commande dotnet publish doit être étendue à votre projet d’application .NET MAUI.

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 :

Paramètre Valeur
-p:ApplicationTitle Nom de l’application visible par l’utilisateur.
-p:ApplicationId Identificateur unique de l’application, par exemple com.companyname.mymauiapp.
-p:ApplicationVersion Version de la build qui identifie une itération de l’application.
-p:ApplicationDisplayVersion Numéro de version de l’application.

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

Important

Les valeurs de ces paramètres ne doivent pas nécessairement être fournies sur la ligne de commande. Elles peuvent également être indiquées dans le fichier projet. Lorsqu’un paramètre est fourni sur la ligne de commande et dans le fichier projet, le paramètre de ligne de commande est prioritaire. Pour en savoir plus sur l’entrée des propriétés de build dans le fichier projet, consultez Définir les propriétés de build dans votre fichier projet.

Par exemple, utilisez la commande suivante pour générer et signer un .pkg sur un Mac, pour la distribution via le Mac App Store :

dotnet publish -f net8.0-maccatalyst -c Release -p:MtouchLink=SdkOnly -p:CreatePackage=true -p:EnableCodeSigning=true -p:EnablePackageSigning=true -p:CodesignKey="Apple Distribution: John Smith (AY2GDE9QM7)" -p:CodesignProvision="MyMauiApp" -p:CodesignEntitlements="Platforms\MacCatalyst\Entitlements.plist" -p:PackageSigningKey="3rd Party Mac Developer Installer: John Smith (AY2GDE9QM7)"

Remarque

Dans .NET 8, la commande dotnet publish est par défaut dans la configuration Release. Par conséquent, la configuration de build peut être omise à partir de la ligne de commande.

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 et de productbuild :

Autorisez codesign pour signer votre application sur votre Mac.Autorisez productbuild pour signer votre application sur votre Mac.

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 :

Propriété Valeur
<ApplicationTitle> Nom de l’application visible par l’utilisateur.
<ApplicationId> Identificateur unique de l’application, par exemple com.companyname.mymauiapp.
<ApplicationVersion> Version de la build qui identifie une itération de l’application.
<ApplicationDisplayVersion> Numéro de version de l’application.
<CodesignKey> Nom de la clé de signature du code. Définir sur le nom de votre certificat de distribution, comme indiqué dans Trousseaux d’accès.
<CodesignEntitlements> Chemin d’accès au fichier des droits qui spécifie les droits dont a besoin l’application. Réglez sur Platforms\MacCatalyst\Entitlements.plist.
<CodesignProvision> Profil de provisionnement à utiliser lors de la signature de l’ensemble d’applications.
<CreatePackage> Définir sur true pour qu’un package (.pkg) soit créé pour l’application à la fin de la build.
<EnableCodeSigning> Définir sur true pour que le code de signature soit activé.
<EnablePackageSigning> Définir sur true pour que le package créé soit signé.
<MtouchLink> Mode lien du projet, qui peut être None, SdkOnly ou Full.
<PackageSigningKey> Clé de signature de package à utiliser lors de la signature du package. Définir sur le nom de votre certificat d’installation, comme indiqué dans Trousseaux d’accès.

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

Important

Les valeurs de ces propriétés de build ne doivent pas nécessairement être fournies dans le fichier projet. Elles peuvent également être indiquées sur la ligne de commande lorsque vous publiez l’application. Vous pouvez ainsi omettre des valeurs spécifiques de votre fichier projet.

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 dans le Mac App Store :

<PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Release|net8.0-maccatalyst|AnyCPU'">
  <MtouchLink>SdkOnly</MtouchLink>
  <EnableCodeSigning>True</EnableCodeSigning>
  <EnablePackageSigning>true</EnablePackageSigning>
  <CreatePackage>true</CreatePackage>
  <CodesignKey>Apple Distribution: John Smith (AY2GDE9QM7)</CodesignKey>
  <CodesignProvision>MyMauiApp</CodesignProvision>
  <CodesignEntitlements>Platforms\MacCatalyst\Entitlements.plist</CodesignEntitlements>
  <PackageSigningKey>3rd Party Mac Developer Installer: John Smith (AY2GDE9QM7)</PackageSigningKey>
</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>, <CodesignProvision> et <PackageSigningKey> 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

Remarque

Dans .NET 8, la commande dotnet publish est par défaut dans la configuration Release. Par conséquent, la configuration de build peut être omise à partir de la ligne de commande.

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

Charger sur le Mac App Store

Une fois qu’une application a été signée avec un certificat de distribution Apple, elle ne peut pas être exécutée localement. Au lieu de cela, elle doit être chargée dans App Store Connect où elle sera à nouveau signée pour activer l’exécution locale.

Pour distribuer votre application via le Mac App Store ou TestFlight, vous devez créer un enregistrement d’application dans App Store Connect. Cet enregistrement inclut toutes les informations relatives à l’application, comme elles apparaîtront dans l’App Store et toutes les informations nécessaires pour gérer l’application via le processus de distribution. Pour plus d’informations, consultez Créer un enregistrement d’application sur developer.apple.com.

Transporter peut être utilisé pour soumettre votre application au Mac App Store. Il permet également d’identifier les erreurs avec les packages d’application qui arrêtent la soumission réussie.

Voir aussi