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 :
- Créez une requête de signature de certificat. Pour plus d’informations, consultez Créer une demande de signature de certificat.
- Créez un certificat de distribution. Pour plus d’informations, consultez Créer un certificat de distribution.
- Créez un certificat d’installation. Pour plus d’informations, consultez Créer un certificat d’installation.
- Créez un ID d’application. Pour plus d’informations, consultez Créer un ID d’application.
- Configurez l’ID de l’application Pour plus d’informations, consultez Configurer l’ID de l’application.
- Créez un profil de provisionnement. Pour plus d’informations, consultez Créer un profil de provisionnement.
- 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 :
- Ajoutez les droits requis à votre application. Pour plus d’informations, consultez Ajouter des droits.
- Mettez à jour le fichier Info.plist de l’application. Pour plus d’informations, consultez Mettre à jour Info.plist.
- 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 :
Sur votre Mac, démarrez Trousseau d’accès.
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....
Dans la boîte de dialogue Assistant de certification, entrez une adresse e-mail dans le champ Adresse e-mail de l’utilisateur.
Dans la boîte de dialogue Assistant de certification, entrez un nom pour la clé dans le champ Nom commun.
Dans la boîte de dialogue Assistant de certification, laissez le champ Adresse e-mail de l’autorité de certification vide.
Dans la boîte de dialogue Assistant de certification, choisissez la case d’option Enregistré sur disque, puis sélectionnez Continuer :
Enregistrez la demande de signature de certificat à un emplacement connu.
Dans la boîte de dialogue Assistant de certification, sélectionnez le bouton Terminé.
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 :
Dans un navigateur web, connectez-vous à votre compte Apple Developer.
Dans votre compte Apple Developer, accédez à l’onglet Certificates, IDs & Profiles.
Sur la page Certificates, Identifiers & Profiles, sélectionnez le bouton + pour créer un certificat.
Sur la page Create a New Certificate, sélectionnez la case d’option Apple Distribution avant de sélectionner le bouton Continue :
Sur la page Create a New Certificate, sélectionnez Choose File :
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.Sur la page Create a New Certificate, sélectionnez le bouton Continue :
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.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 :
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 :
Dans votre compte Apple Developer, accédez à l’onglet Certificates, IDs & Profiles.
Sur la page Certificates, Identifiers & Profiles, sélectionnez le bouton + pour créer un certificat.
Sur la page Create a New Certificate, sélectionnez la case d’option Mac Installer Distribution avant de sélectionner le bouton Continue :
Sur la page Create a New Certificate, sélectionnez Choose File :
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.Sur la page Create a New Certificate, sélectionnez le bouton Continue :
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.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 :
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 :
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, sélectionnez le bouton + pour créer un ID d’application.
Sur la page Register a new identifier, sélectionnez la case d’option App IDs avant de sélectionner le bouton Continue :
Sur la page Register a new identifier, sélectionnez App avant de sélectionner le bouton Continue :
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 Register an App ID, sélectionnez le bouton Continue.
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 :
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, sélectionnez l’ID d’application que vous venez de créer.
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.
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 :
Dans la page Edit your App ID Configuration, sélectionnez le bouton Save :
Dans la fenêtre contextuelle Modify App Capabilities, sélectionnez le bouton Confirm.
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 :
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 Mac App Store avant de cliquer sur le bouton Continue :
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 :
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 (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 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 :
Sur votre Mac, lancez Xcode.
Dans Xcode, sélectionnez l’élément de menu Xcode > Preférences….
Dans la boîte de dialogue Preferences, sélectionnez l’onglet Accounts.
Dans l’onglet Accounts, cliquez sur le bouton + pour ajouter votre compte Apple Developer à Xcode :
Dans la fenêtre contextuelle de type de compte, sélectionnez Apple ID, puis cliquez sur le bouton Continue :
Dans la fenêtre contextuelle de connexion, entrez votre ID Apple, puis cliquez sur le bouton Next.
Dans la fenêtre contextuelle de connexion, entrez votre mot de passe d’ID Apple, puis cliquez sur le bouton Next :
Dans l’onglet Accounts, cliquez sur le bouton Manage Certificates… pour vous assurer que votre certificat de distribution a été téléchargé.
Dans l’onglet Accounts, cliquez sur le bouton Download Manual Profiles pour télécharger vos profils de provisionnement :
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é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é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
:
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 :
- La configuration de build est définie sur
Release
. - L’infrastructure cible est définie sur un élément contenant le texte
net8.0-maccatalyst
. - 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
- Preparing your app for distribution sur developer.apple.com