Si vous ne l’avez pas déjà fait, installez la dernière version de .NET 8 Desktop Runtime. Cet outil est obligatoire pour exécuter Microsoft Store Developer CLI.
Le moyen le plus simple de l’installer consiste à utiliser winget :
winget install Microsoft.DotNet.DesktopRuntime.8
Étape 2 : Installer l’interface CLI du développeur du Microsoft Store sur Windows
Vous pouvez télécharger Microsoft Store Developer CLI à partir du Microsoft Store. Vous pouvez également utiliser winget :
winget install "Microsoft Store Developer CLI"
Étape 1 : Installer .NET macOS Runtime
Si vous ne l’avez pas déjà fait, installez la dernière version de .NET 8 Runtime. Cet outil est obligatoire pour exécuter Microsoft Store Developer CLI.
Étape 2 : Installer l’interface CLI du développeur du Microsoft Store sur macOS
Vous pouvez télécharger le fichier macOS .tar.gz adapté à votre architecture (x64 ou Arm64) à partir de la page des versions de Microsoft Store Developer CLI. Une fois le téléchargement terminé, extrayez l’archive et placez les fichiers dans le chemin d’accès de votre choix, par exemple :
Si vous ne l’avez pas déjà fait, installez la dernière version de .NET 8 Runtime. Cet outil est obligatoire pour exécuter Microsoft Store Developer CLI.
Étape 2 : Installer l’interface CLI du développeur du Microsoft Store sur Linux
Vous pouvez télécharger le fichier Linux .tar.gz adapté à votre architecture (x64 ou Arm64) à partir de la page des versions de Microsoft Store Developer CLI. Une fois le téléchargement terminé, extrayez l’archive et placez les fichiers dans le chemin d’accès de votre choix, par exemple :
Configurez à nouveau l’interface CLI du développeur du Microsoft Store. Vous pouvez fournir un secret client ou un certificat. Les certificats peuvent être fournis via son empreinte numérique ou en fournissant un chemin d’accès de fichier (avec ou sans mot de passe).
Reconfigurer - Utilisation
msstore reconfigure
Reconfigurer - Options
Option
Description
-t, --tenantId
Spécifiez l’ID de locataire à utiliser.
-s, --sellerId
Spécifiez l’ID de vendeur à utiliser.
-c, --clientId
Spécifiez l’ID client à utiliser.
-cs, --clientSecret
Spécifiez le secret client qui doit être utilisé.
-ct, --certificateThumbprint
Spécifiez l’empreinte numérique du certificat à utiliser.
-cfp, --certificateFilePath
Spécifiez le chemin d’accès au fichier de certificat qui doit être utilisé.
-cp, --certificatePassword
Spécifiez le mot de passe de certificat à utiliser.
--réinitialisation
Réinitialisez uniquement les informations d’identification, sans recommencer.
Settings, commande
Modifiez les paramètres de l’interface CLI du développeur du Microsoft Store.
Paramètres - Utilisation
msstore settings
Sous-commande
Description
setpdn
Définissez la propriété Nom complet du serveur de publication utilisée par la commande init.
Paramètres - Options
Option
Description
-t, --enableTelemetry
Activez (vide/true) ou désactivez la télémétrie (false).
-v, --verbose
Imprimer une sortie détaillée.
Paramètres - Utilisation des commandes SetPDN
msstore settings setpdn <publisherDisplayName>
Arguments
Argument
Description
publisherDisplayName
Propriété Nom complet du serveur de publication qui sera définie globalement.
Ignorez l’interrogation initiale avant d’exécuter l’action. [valeur par défaut : False]
Soumission - Aide de la commande UpdateMetadata
msstore submission updateMetadata --help
Soumission - Mise à jour de l’utilisation des commandes
msstore submission update <productId> <product>
Soumission - Mettre à jour les arguments de commande
Argument
Description
productId
ID du produit.
product
Représentation de produit JSON mise à jour.
Soumission - Mettre à jour les options de commande
Option
Description
-s, --skipInitialPolling
Ignorez l’interrogation initiale avant d’exécuter l’action. [valeur par défaut : False]
Soumission - Mettre à jour l’aide de la commande
msstore submission update --help
Soumission - Utilisation des commandes Poll
msstore submission poll <productId>
Soumission - Arguments de commande Poll
Argument
Description
productId
ID du produit.
Soumission - Aide de la commande Poll
msstore submission poll --help
Soumission - Publier l’utilisation des commandes
msstore submission publish <productId>
Soumission - Publier des arguments de commande
Argument
Description
productId
ID du produit.
Soumission - Aide sur la publication de commandes
msstore submission publish --help
Soumission - Supprimer l’utilisation des commandes
Supprime la soumission en attente du magasin.
Soumission - Supprimer des arguments de commande
Argument
Description
productId
ID du produit.
Soumission - Supprimer les options de commande
Option
Description
--no-confirm
Ne pas demander de confirmation. [valeur par défaut : False]
Soumission - Aide sur la suppression de commandes
msstore submission delete --help
Commande Init
La init commande vous aide à configurer votre application pour publier sur le Microsoft Store. Il prend actuellement en charge les types d’applications suivants :
SDK d’application Windows / WinUI 3
UWP
.NET MAUI
Flutter
Electron
React Native pour Desktop
PWA
Commande Init - Exemples d’utilisation
Commande Init - Kit de développement logiciel (SDK) d’application Windows/WinUI 3
msstore init "C:\path\to\winui3_app"
Commande Init - UWP
msstore init "C:\path\to\uwp_app"
Commande Init - .NET MAUI
msstore init "C:\path\to\maui_app"
Commande Init - Flutter
msstore init "C:\path\to\flutter_app"
Commande Init - Electron
msstore init "C:\path\to\electron_app"
Commande Init - React Native for Desktop
msstore init "C:\path\to\react_native_app"
Remarque
Pour Electron, ainsi que React Native pour les projets Desktop, les deux Npm sont Yarn pris en charge. La présence du fichier de Yarn verrou (yarn.lock) sera utilisée pour déterminer le gestionnaire de package à utiliser. Veillez donc à archiver votre fichier de verrouillage dans votre système de contrôle de code source.
Commande Init - PWA
msstore init https://contoso.com --output .
Commande Init - Arguments
Argument
Description
pathOrUrl
Chemin d’accès au répertoire racine où se trouve le fichier projet, ou URL publique pointant vers une PWA.
Commande Init - Options
Option
Description
-n, --publisherDisplayName
Nom complet du serveur de publication utilisé pour configurer l’application. Si elle est fournie, évite un appel d’API supplémentaire.
--colis
Si le type d’application est pris en charge, packe automatiquement le projet.
--publier
Si le type d’application est pris en charge, publie automatiquement le projet. Implique « --package true »
-f, --flightId
Spécifie l’ID de vol où le package sera publié.
-prp, --packageRolloutPercentage
Spécifie le pourcentage de déploiement du package. La valeur doit être comprise entre 0 et 100.
-a, --arch
Architecture(s) à générer. Si ce n’est pas le cas, l’architecture par défaut pour le système d’exploitation actuel et le type de projet seront utilisées. Valeurs autorisées : « x86 », « x64 », « arm64 ». Utilisé uniquement avec « --package true ».
-o, --output
Répertoire de sortie dans lequel l’application empaquetée sera stockée. S’il n’est pas fourni, le répertoire par défaut pour chaque type d’application différent sera utilisé.
-ver, --version
Version utilisée lors de la génération de l’application. S’il n’est pas fourni, la version du fichier projet est utilisée.
Commande Package
Vous aide à empaqueter votre application du Microsoft Store en tant que MSIX.
Commande de package - Exemples d’utilisation
Commande de package - Kit de développement logiciel (SDK) d’application Windows/WinUI 3
msstore package "C:\path\to\winui3_app"
Commande de package - UWP
msstore package "C:\path\to\uwp_app"
Commande de package - .NET MAUI
msstore package "C:\path\to\maui_app"
Commande de package - Flutter
msstore package "C:\path\to\flutter_app"
Commande de package - Electron
msstore package "C:\path\to\electron_app"
Commande package - React Native for Desktop
msstore package "C:\path\to\react_native_app"
Commande de package - PWA
msstore package "C:\path\to\pwa_app"
Commande de package - Arguments
Option
Description
pathOrUrl
Chemin d’accès au répertoire racine où se trouve le fichier projet, ou URL publique pointant vers une PWA.
Commande de package - Options
Option
Description
-o, --output
Répertoire de sortie dans lequel l’application empaquetée sera stockée. S’il n’est pas fourni, le répertoire par défaut pour chaque type d’application différent sera utilisé.
-a, --arch
Architecture(s) à générer. Si ce n’est pas le cas, l’architecture par défaut pour le système d’exploitation actuel et le type de projet seront utilisées. Valeurs autorisées : « x86 », « x64 », « arm64 ».
-ver, --version
Version utilisée lors de la génération de l’application. S’il n’est pas fourni, la version du fichier projet est utilisée.
Commande Publish
Elle publie votre application dans Microsoft Store.
Commande Publier - Exemples d’utilisation
Commande Publier - Kit de développement logiciel (SDK) d’application Windows/WinUI 3
msstore publish "C:\path\to\winui3_app"
Publier la commande - UWP
msstore publish "C:\path\to\uwp_app"
Publier la commande - .NET MAUI
msstore publish "C:\path\to\maui_app"
Publier la commande - Flutter
msstore publish "C:\path\to\flutter_app"
Publier la commande - Electron
msstore publish "C:\path\to\electron_app"
Publier la commande - React Native for Desktop
msstore publish "C:\path\to\react_native_app"
Publier la commande - PWA
msstore publish "C:\path\to\pwa_app"
Publier la commande - Arguments
Option
Description
pathOrUrl
Chemin d’accès au répertoire racine où se trouve le fichier projet, ou URL publique pointant vers une PWA.
Commande Publier - Options
Option
Description
-i, --inputDirectory
Répertoire dans lequel se trouve le fichier « .msix » ou « .msixupload » à utiliser pour la commande de publication. S’il n’est pas précisé, l’interface CLI tente de trouver le meilleur candidat sur la base de l’argument « pathOrUrl ».
-id, --appId
Indique l'ID de l'application. Nécessaire uniquement dans le cas où le projet n'a pas déjà été initialisé avec la commande « init ».
-nc, --noCommit
Désactive la validation de la soumission, en la conservant dans l’état brouillon.
-f, --flightId
Spécifie l’ID de vol où le package sera publié.
-prp, --packageRolloutPercentage
Spécifie le pourcentage de déploiement du package. La valeur doit être comprise entre 0 et 100.
Environnements CI/CD
Microsoft Store Developer CLI (préversion) prend en charge l’exécution dans les environnements CI/CD. Cela signifie que vous pouvez utiliser l’interface CLI du développeur du Microsoft Store (préversion) dans vos pipelines CI/CD pour publier automatiquement vos applications dans le Microsoft Store.
La première étape pour y parvenir pour installer l’interface CLI du développeur du Microsoft Store (préversion) sur votre environnement CI/CD. Vous pouvez consulter des instructions sur la façon d’y parvenir ici.
Après avoir installé l’interface CLI du développeur du Microsoft Store (préversion), vous devez configurer votre environnement pour pouvoir exécuter des commandes. Pour ce faire, exécutez la msstore reconfigure commande avec les paramètres spécifiques qui identifient votre compte espace partenaires (TenantId, SellerId, ClientId). Vous devez également fournir un ClientSecret ou un certificat.
Il est très important de masquer ces informations d’identification, car elles seront visibles dans les journaux de votre pipeline CI/CD. Pour ce faire, utilisez des secrets. Chaque système de pipeline CI/CD a des noms différents pour ces secrets. Par exemple, Azure DevOps les appelle variables secrètes, mais GitHub Action les appelle secrets chiffrés. Créez un secret pour chacun des paramètres (TenantId, SellerId, ClientId et ClientSecret ou certificat), puis utilisez la reconfigure commande pour configurer votre environnement.
Par exemple :
Azure DevOps
- task: UseMSStoreCLI@0
displayName: Setup Microsoft Store Developer CLI
- script: msstore reconfigure --tenantId $(PARTNER_CENTER_TENANT_ID) --sellerId $(PARTNER_CENTER_SELLER_ID) --clientId $(PARTNER_CENTER_CLIENT_ID) --clientSecret $(PARTNER_CENTER_CLIENT_SECRET)
displayName: Configure Microsoft Store Developer CLI
Actions GitHub
- name: Setup Microsoft Store Developer CLI
uses: microsoft/setup-msstore-cli@v1
- name: Configure Microsoft Store Developer CLI
run: msstore reconfigure --tenantId ${{ secrets.PARTNER_CENTER_TENANT_ID }} --sellerId ${{ secrets.PARTNER_CENTER_SELLER_ID }} --clientId ${{ secrets.PARTNER_CENTER_CLIENT_ID }} --clientSecret ${{ secrets.PARTNER_CENTER_CLIENT_SECRET }}
Une fois cette commande exécutée, l’interface CLI du développeur du Microsoft Store (préversion) est configurée pour utiliser les informations d’identification fournies. Vous pouvez maintenant utiliser l’interface CLI pour développeurs du Microsoft Store (préversion) dans votre pipeline CI/CD.
Collaborer avec nous sur GitHub
La source de ce contenu se trouve sur GitHub, où vous pouvez également créer et examiner les problèmes et les demandes de tirage. Pour plus d’informations, consultez notre guide du contributeur.
