Comandos (MSIX)

Instalação

winget install Microsoft.DotNet.DesktopRuntime.8

winget install "Microsoft Store Developer CLI"

mkdir MSStoreCLI
curl https://github.com/microsoft/msstore-cli/releases/latest/download/MSStoreCLI-osx-x64.tar.gz -o MSStoreCLI-osx-x64.tar.gz
tar -xvf MSStoreCLI-osx-x64.tar.gz -C ./MSStoreCLI
sudo cp -R MSStoreCLI/. /usr/local/bin

brew install microsoft/msstore-cli/msstore-cli

mkdir MSStoreCLI
wget https://github.com/microsoft/msstore-cli/releases/latest/download/MSStoreCLI-linux-x64.tar.gz
tar -xvf MSStoreCLI-linux-x64.tar.gz -C ./MSStoreCLI
sudo cp -R MSStoreCLI/. /usr/local/bin

brew install microsoft/msstore-cli/msstore-cli

Comando Info

Imprima a configuração existente.

Usage

msstore info

Opções

Comando Reconfigure

Reconfigure a CLI do Desenvolvedor da Microsoft Store. Você pode fornecer um Segredo do Cliente ou um Certificado. Os certificados podem ser fornecidos por meio de sua impressão digital ou fornecendo um caminho de arquivo (com ou sem senha).

Usage

msstore reconfigure

Opções

Comando de configurações

Altere as configurações da CLI do Desenvolvedor da Microsoft Store.

Usage

msstore settings

Opções

Comando secundário SetPDN

Defina a propriedade Nome de Exibição do Publicador que é usada pelo comando init.

Usage

msstore settings setpdn <publisherDisplayName>

Argumentos

Opções

Comando Apps

Aplicativos – Lista – Uso

msstore apps list

Opções

Aplicativos – Baixar – Utilização

msstore apps get <productId>

Argumentos

Opções

Comando Submission

Envio – Status – Uso

msstore submission status <productId>

Argumentos

Opções

Envio – Obter – Uso

msstore submission get <productId>

Argumentos

Opções

Envio – GetListingAssets – Uso

msstore submission getListingAssets <productId>

Argumentos

Opções

Envio – AtualizarMetadados – Uso

msstore submission updateMetadata <productId> <metadata>

Argumentos

Opções

Envio – Votação – Uso

msstore submission poll <productId>

Argumentos

Opções

Envio – Publicar – Uso

msstore submission publish <productId>

Argumentos

Opções

Envio – Excluir – Uso

msstore submission delete <productId>

Argumentos

Opções

Comando Init

O init comando ajuda você a configurar seu aplicativo para publicar na Microsoft Store. Atualmente, ele suporta os seguintes tipos de aplicativos:

• SDK do Aplicativo Windows/WinUI 3
• UWP
• .NET MAUI
• Tremulação
• Elétron
• React Native para desktop
• PWA

Exemplos de uso

SDK do Aplicativo Windows/WinUI 3

msstore init "C:\path\to\winui3_app"

UWP

msstore init "C:\path\to\uwp_app"

.NET MAUI

msstore init "C:\path\to\maui_app"

Tremulação

msstore init "C:\path\to\flutter_app"

Elétron

msstore init "C:\path\to\electron_app"

React Native para desktop

msstore init "C:\path\to\react_native_app"

PWA

msstore init https://contoso.com --output .

Argumentos

Opções

Comando Package

Ajuda você a empacotar seu aplicativo da Microsoft Store como um MSIX.

Exemplos de uso

SDK do Aplicativo Windows/WinUI 3

msstore package "C:\path\to\winui3_app"

UWP

msstore package "C:\path\to\uwp_app"

.NET MAUI

msstore package "C:\path\to\maui_app"

Tremulação

msstore package "C:\path\to\flutter_app"

Elétron

msstore package "C:\path\to\electron_app"

React Native para desktop

msstore package "C:\path\to\react_native_app"

PWA

msstore package "C:\path\to\pwa_app"

Argumentos

Opções

Comando Publish

Publica sua Aplicação na Microsoft Store.

Exemplos de uso

SDK do Aplicativo Windows/WinUI 3

msstore publish "C:\path\to\winui3_app"

UWP

msstore publish "C:\path\to\uwp_app"

.NET MAUI

msstore publish "C:\path\to\maui_app"

Tremulação

msstore publish "C:\path\to\flutter_app"

Elétron

msstore publish "C:\path\to\electron_app"

React Native para desktop

msstore publish "C:\path\to\react_native_app"

PWA

msstore publish "C:\path\to\pwa_app"

Argumentos

Opções

Comando de Voos

Voos – Lista – Uso

msstore flights list <productId>

Argumentos

Opções

Voos – Obter – Uso

msstore flights get <productId> <flightId>

Argumentos

Opções

Voos – Excluir – Uso

msstore flights delete <productId> <flightId>

Argumentos

Opções

Voos – Criar – Utilização

msstore flights create <productId> <friendlyName> --group-ids <group-ids>

Argumentos

Opções

Voos – Envio

Voos – Envio – Obter – Uso

msstore flights submission get <productId> <flightId>

Argumentos

Opções

Voos – Envio – Exclusão – Uso

msstore flights submission delete <productId> <flightId>

Argumentos

Opções

Voos – Envio – Atualização – Uso

msstore flights submission update <productId> <flightId> <product>

Argumentos

Opções

Voos – Submissão – Publicação – Uso

msstore flights publish <productId> <flightId>

Argumentos

Opções

Voos – Envio – Sondagem – Uso

msstore flights poll <productId> <flightId>

Argumentos

Opções

Voos – Envio – Status – Uso

msstore flights status <productId> <flightId>

Argumentos

Opções

Voos – Envio – Distribuição

Voos – Envio – Implementação – Obtenção – Uso

msstore flights submission rollout get <productId> <flightId>

Argumentos

Opções

Voos – Envio – Distribuição – Atualização – Uso

msstore flights submission rollout update <productId> <flightId> <percentage>

Argumentos

Opções

Voos – Envio – Distribuição – Parada – Uso

msstore flights submission rollout halt <productId> <flightId>

Argumentos

Opções

Voos – Envio – Distribuição – Finalizar – Uso

msstore flights submission rollout finalize <productId> <flightId>

Argumentos

Opções

Ambientes de CI/CD

A CLI do Desenvolvedor da Microsoft Store (versão prévia) dá suporte à execução em ambientes de CI/CD. Isso significa que você pode usar a CLI do Desenvolvedor da Microsoft Store (versão prévia) em seus pipelines de CI/CD para, por exemplo, publicar automaticamente seus aplicativos na Microsoft Store.

A primeira etapa para conseguir isso é instalar a CLI do desenvolvedor da Microsoft Store (versão prévia) em seu ambiente de CI/CD. Você pode encontrar instruções sobre como fazer isso aqui.

Depois de instalar a CLI do Desenvolvedor da Microsoft Store (versão prévia), você precisa configurar seu ambiente para poder executar comandos. Você pode fazer isso executando o msstore reconfigure comando com os parâmetros específicos que identificam sua conta do Partner Center (TenantId, SellerId, ClientId). Você também precisa fornecer um ClientSecret ou um Certificate.

É muito importante ocultar essas credenciais, pois elas ficarão visíveis nos logs do seu pipeline de CI/CD. Você pode fazer isso usando segredos. Cada sistema de pipeline de CI/CD tem nomes diferentes para esses segredos. Por exemplo, o Azure DevOps as chama de Variáveis Secretas, mas o GitHub Action as chama de Segredos Criptografados. Crie um segredo para cada um dos parâmetros (TenantId, SellerId, ClientId e ClientSecret ou um Certificado) e use o reconfigure comando para configurar seu ambiente.

Por exemplo:

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

GitHub Actions

- name: Setup Microsoft Store Developer CLI
  uses: microsoft/microsoft-store-apppublisher@v1.1
- 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 }}

Depois que esse comando for executado, a CLI do Desenvolvedor da Microsoft Store (versão prévia) será configurada para usar as credenciais fornecidas. Agora você pode usar a CLI do Desenvolvedor da Microsoft Store (versão prévia) em seu pipeline de CI/CD.