Comandos (MSI/EXE)

Installation

Etapa 1: Instalar o Windows Runtime do .NET

Se você ainda não tiver feito isso, instale a versão mais recente do .NET 8 Desktop Runtime. Este é 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. Alternativamente, você pode usar winget:

winget install "Microsoft Store Developer CLI"

Etapa 1: Instalar o .NET macOS Runtime

Se você ainda não tiver feito isso, instale a versão mais recente do .NET 8 Runtime. Este é 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 macOS .tar.gz para sua arquitetura específica (x64 ou Arm64) na página de versões da Microsoft Store Developer CLI. Uma vez baixado, extraia o arquivo e coloque-o em seu PATH, como você quiser fazer isso, por exemplo:

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

Alternativamente, você pode usar brew:

brew install microsoft/msstore-cli/msstore-cli

Etapa 1: Instalar o .NET Linux Runtime

Se você ainda não tiver feito isso, instale a versão mais recente do .NET 8 Runtime. Este é 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 a sua arquitetura específica (x64 ou Arm64) a partir da página de lançamentos do Microsoft Store Developer CLI. Uma vez baixado, extraia o arquivo e coloque-o em seu PATH, como você quiser fazer isso, 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

Alternativamente, 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, --verborrágico	Imprima a saída detalhada.
-?, -h, --ajuda	Mostrar informações de ajuda e utilização.

Comando para Reconfigurar

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

Usage

msstore reconfigure

Opções

Opção	Description
-t, --tenantId	Especifique o ID do locatário que deve ser usado.
-s, --sellerId	Especifique o ID do vendedor que deve ser usado.
-c, --identificadorCliente	Especifique o ID do cliente que deve ser usado.
-cs, --clientSecret	Especifique o segredo do cliente que deve ser usado.
-ct, --certificateImpressão digital	Especifique a impressão digital (Thumbprint) 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	Apenas redefina as credenciais, sem começar de novo.
-v, --verborrágico	Imprima a saída detalhada.
-?, -h, --ajuda	Mostrar informações de ajuda e utilização.

Comando de Configurações

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

Usage

msstore settings

Opções

Opção	Description
-t, --enableTelemetria	Ative ou desative a telemetria (vazio/verdadeiro/falso).
-v, --verboso	Imprima a saída detalhada.
-?, -h, --ajuda	Mostrar informações de ajuda e utilização.

SetPDN Sub-Command

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 Editor que será configurada globalmente.

Opções

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

Comando de envio

Sub-comando	Description
Situação	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 listados de uma submissão específica.
updateMetadados	Atualiza os metadados de um envio específico.
atualizar	Atualiza as informações do pacote de um envio específico.
sondagem	Sonda o status de um envio.
publicar	Publica uma submissão específica.

Submissão - Estado - Utilização

msstore submission status <productId>

Arguments

Argument	Description
productId	O Identificador do Partner Center.

Opções

Opção	Description
-v, --verboso	Imprima a saída detalhada.
-?, -h, --ajuda	Mostrar informações de ajuda e utilização.

Submissão - Obter - Utilização

msstore submission get <productId>

Arguments

Argument	Description
productId	O Identificador do Partner Center.

Opções

Opção	Description
-l, --língua	Selecione o idioma que deseja recuperar. [padrão: en]
-v, --verboso	Imprima a saída detalhada.
-?, -h, --ajuda	Mostrar informações de ajuda e utilização.

Submissão - GetListingAssets - Uso

msstore submission getListingAssets <productId>

Arguments

Argument	Description
productId	O Identificador do Partner Center.

Opções

Opção	Description
-l, --língua	Selecione o idioma que deseja recuperar. [padrão: en]
-v, --verboso	Imprima a saída detalhada.
-?, -h, --ajuda	Mostrar informações de ajuda e utilização.

Submissão - Atualizar Metadados - Uso

msstore submission updateMetadata <productId> <metadata>

Arguments

Argument	Description
productId	O ID do Centro de Parceiros.
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, --verborrágico	Imprima resultados detalhados.
-?, -h, --ajuda	Mostrar informações de ajuda e utilização.

Submissão - Atualização - Utilização

msstore submission update <productId> <package>

Arguments

Argument	Description
productId	O ID do Centro de Parceiros.
package	A representação JSON atualizada do pacote do aplicativo.

Opções

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

Submissão - Sondagem - Utilização

msstore submission poll <productId>

Arguments

Argument	Description
productId	O ID do Partner Center.

Opções

Opção	Description
-v, --verborrágico	Imprima a saída detalhada.
-?, -h, --ajuda	Mostrar informações de ajuda e utilização.

Submissão - Publicar - Utilização

msstore submission publish <productId>

Arguments

Argument	Description
productId	O Identificador do Partner Center.

Opções

Opção	Description
-v, --verboso	Imprima a saída verbosa.
-?, -h, --ajuda	Mostrar informações de ajuda e utilização.

Ambientes CI/CD

O Microsoft Store Developer CLI (visualização) suporta a execução em ambientes CI/CD. Isto significa que pode utilizar a CLI de Developer da Microsoft Store (versão preliminar) nos seus pipelines de CI/CD para, por exemplo, publicar automaticamente as suas aplicações para a Microsoft Store.

O primeiro passo para conseguir isso é instalar o Microsoft Store Developer CLI (em pré-visualização) no seu ambiente de CI/CD. Você pode encontrar instruções sobre como fazer isso aqui.

Depois de instalar a Microsoft Store Developer CLI (visualização), 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 serão visíveis nos logs do seu pipeline de CI/CD. Você pode fazer isso usando segredos. Cada sistema de pipeline CI/CD pode usar nomes diferentes para esses segredos. Por exemplo, o Azure DevOps as chama de Variáveis Secretas, mas a Ação do GitHub as chama de Segredos Criptografados. Crie um segredo para cada um dos parâmetros (TenantId, SellerId, ClientId e ClientSecret ou um Certificado) e, em seguida, use o comando para configurar seu reconfigure 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 (visualização) será configurada para usar as credenciais fornecidas. Agora podes usar a Microsoft Store Developer CLI (visualização) no teu pipeline de CI/CD.