Comandos (MSI/EXE)

Installation

Etapa 1: instalar o Windows Runtime do .NET

Se você ainda não fez isso, instale a versão mais recente do .NET 8 Desktop Runtime. Esse é um requisito para executar a CLI do Desenvolvedor da Microsoft Store.

A maneira mais fácil de instalá-lo é usar winget:

winget install Microsoft.DotNet.DesktopRuntime.8

Etapa 2: Instalar a CLI do Desenvolvedor da Microsoft Store no Windows

Você pode baixar a CLI do Desenvolvedor da Microsoft Store na Microsoft Store. Como alternativa, você pode usar winget:

winget install "Microsoft Store Developer CLI"

Etapa 1: Instalar o .NET Runtime para macOS

Se você ainda não fez isso, instale a versão mais recente do Runtime do .NET 8. Esse é um requisito para executar a CLI do Desenvolvedor da Microsoft Store.

Etapa 2: Instalar a CLI do Desenvolvedor da Microsoft Store no macOS

Você pode baixar o .tar.gz do macOS para sua arquitetura específica (x64 ou Arm64) na página de versões da CLI do Desenvolvedor da Microsoft Store. Depois de baixado, extraia o arquivo e coloque-o em seu PATH, da maneira que preferir.

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

Como alternativa, você pode usar brew:

brew install microsoft/msstore-cli/msstore-cli

Etapa 1: instalar o Runtime do .NET Linux

Se você ainda não fez isso, instale a versão mais recente do Runtime do .NET 8. Esse é um requisito para executar a CLI do Desenvolvedor da Microsoft Store.

Etapa 2: Instalar a CLI do Desenvolvedor da Microsoft Store no Linux

Você pode baixar o .tar.gz do Linux para sua arquitetura específica (x64 ou Arm64) na página de versões da CLI do Desenvolvedor da Microsoft Store. Depois de baixado, extraia o arquivo compactado e coloque-o em seu PATH, da forma que você preferir, por exemplo:

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

Como alternativa, você pode usar brew:

brew install microsoft/msstore-cli/msstore-cli

Comando Info

Imprima a configuração existente.

Usage

msstore info

Opções

Opção	Description
-v, --verbose (modo detalhado)	Imprimir saída detalhada.
-?, -h, --help	Mostrar informações de ajuda e uso.

Reconfigurar Comando

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 uma senha).

Usage

msstore reconfigure

Opções

Opção	Description
-t, --idLocatario	Especifique a ID do locatário que deve ser usada.
-s, --sellerId	Especifique a ID do vendedor que deve ser usada.
-c, --clientId	Especifique a ID do cliente que deve ser usada.
-cs, --clientSecret	Especifique o segredo do cliente que deve ser usado.
-ct, --certificateThumbprint	Especifique a impressão digital do certificado que deve ser usada.
-cfp, --certificateFilePath	Especifique o caminho do arquivo de certificado que deve ser usado.
-cp, --certificatePassword	Especifique a senha do certificado que deve ser usada.
--reiniciar	Redefina apenas as credenciais, sem recomeçar.
-v, --verbose	Imprimir saída detalhada.
-?, -h, --help	Mostrar informações de ajuda e uso.

Comando de Configurações

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

Usage

msstore settings

Opções

Opção	Description
-t, --enableTelemetry	Habilitar (vazia/verdadeira) ou desabilitar a telemetria (false).
-v, --verboso	Imprimir saída detalhada.
-?, -h, --help	Mostrar informações de ajuda e uso.

Comando secundário SetPDN

Defina a propriedade Nome de Exibição do Publicador.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Argument	Description
publisherDisplayName	A propriedade Nome de Exibição do Publicador que será definida globalmente.

Opções

Opção	Description
-?, -h, --help	Mostrar informações de ajuda e uso.

Comando envio

Sub-Command	Description
estado	Obtém o status de um envio.
Obter	Obtém os metadados e as informações do pacote de um envio específico.
getListingAssets	Obtém os ativos de listagem de um envio específico.
updateMetadata	Atualiza os metadados de um envio específico.
update	Atualiza as informações do pacote de um envio específico.
enquete	Sonda o status de uma submissão.
publish	Publica uma submissão específica.

Envio – Status – Uso

msstore submission status <productId>

Arguments

Argument	Description
productId	O ID do Centro de Parceiros.

Opções

Opção	Description
-v, --verbose (detalhado)	Imprimir saída detalhada.
-?, -h, --help	Mostrar informações de ajuda e uso.

Envio – Obter – Uso

msstore submission get <productId>

Arguments

Argument	Description
productId	O ID do Partner Center.

Opções

Opção	Description
-l, --idioma	Selecione qual idioma você deseja recuperar. [padrão: en]
-v, --verbose	Imprimir saída detalhada.
-?, -h, --help	Mostrar informações de ajuda e uso.

Envio – GetListingAssets – Uso

msstore submission getListingAssets <productId>

Arguments

Argument	Description
productId	O ID do Partner Center.

Opções

Opção	Description
-l, --linguagem	Selecione qual idioma você deseja recuperar. [padrão: en]
-v, --verbose	Imprimir saída verbosa.
-?, -h, --help	Mostrar informações de ajuda e uso.

Envio – AtualizarMetadados – Uso

msstore submission updateMetadata <productId> <metadata>

Arguments

Argument	Description
productId	O ID do Partner Center.
metadata	A representação de metadados JSON atualizada.

Opções

Opção	Description
-s, --skipInitialPolling	Ignore a sondagem inicial antes de executar a ação. [padrão: False]
-v, --verbose	Imprimir saída detalhada.
-?, -h, --help	Mostrar informações de ajuda e uso.

Envio – Atualização – Uso

msstore submission update <productId> <package>

Arguments

Argument	Description
productId	O ID do Partner Center.
package	A representação JSON atualizada do pacote do aplicativo.

Opções

Opção	Description
-s, --skipInitialPolling (ignorarVerificaçãoInicial)	Ignore a sondagem inicial antes de executar a ação. [padrão: False]
-v, --verbose	Imprimir saída detalhada.
-?, -h, --help	Mostrar informações de ajuda e uso.

Envio – Votação – Uso

msstore submission poll <productId>

Arguments

Argument	Description
productId	O ID do Partner Center.

Opções

Opção	Description
-v, --verbose	Imprimir saída detalhada.
-?, -h, --help	Mostrar informações de ajuda e uso.

Envio – Publicar – Uso

msstore submission publish <productId>

Arguments

Argument	Description
productId	O ID do Partner Center.

Opções

Opção	Description
-v, --verbose	Imprimir saída detalhada.
-?, -h, --help	Mostrar informações de ajuda e uso.

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.

O primeiro passo para conseguir isso é instalar o Microsoft Store Developer CLI (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 certificado.

É muito importante ocultar essas credenciais, pois elas estarão visíveis nos registros do 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 Microsoft Store Developer CLI (preview) no pipeline de CI/CD.