CLI do desenvolvedor da Microsoft Store (MSI/EXE)

Observação

Esta página aborda a publicação de aplicações MSI/EXE usando a Microsoft Store Developer CLI. Para obter informações sobre a publicação de aplicativos MSIX usando a CLI do desenvolvedor da Microsoft Store, clique aqui.

A Interface de Linha de Comando da Microsoft Store é uma CLI multiplataforma (Windows, macOS, Linux) que o ajuda a publicar atualizações das suas aplicações na Microsoft Store. Para aplicações MSI/EXE, a CLI chama as APIs do Partner Center para submeter metadados de pacotes contendo o URL do instalador alojado pelo programador. The Store recupera o instalador desse URL; a CLI não empacota nem carrega o binário do instalador. Para requisitos de alojamento web, veja Adicionar e editar informações do pacote.

Importante

Tem de concluir a primeira publicação da sua aplicação no Microsoft Store através do Partner Center. Depois de a sua aplicação ser publicada, pode usar a Microsoft Store Developer CLI para publicar atualizações subsequentes.

O processo para usar a CLI do desenvolvedor da loja é o mesmo para os aplicativos MSI/EXE e MSIX. Então, para entender como usá-lo, confira o vídeo a seguir:

Pré-requisitos

Para usar a CLI do desenvolvedor da Microsoft Store, você precisará:

Installation

A Microsoft Store Developer CLI suporta Windows 10+, Linux e macOS:

Instale a CLI de desenvolvimento da Microsoft Store (visualização) agora!

Introdução

Depois de instalar a CLI do Microsoft Store Developer, você precisa configurar seu ambiente para poder executar comandos. Você pode fazer isso simplesmente executando a CLI pela primeira vez. A CLI irá guiá-lo através do processo de configuração:

msstore

Importante

Ao iniciar sessão, não use o seu MSA! A CLI do desenvolvedor da Microsoft Store exige que você use suas credenciais de ID do Microsoft Entra. Você pode encontrar mais informações sobre isso em nosso pré-requisitos seção.

A execução em ambientes CI também é suportada, e a Microsoft Store Developer CLI (pré-visualização) pode ser usada nos seus pipelines CI/CD para, por exemplo, publicar automaticamente atualizações das suas aplicações na Microsoft Store. Mais instruções sobre como fazer isso podem ser encontradas aqui.

Observação

As operações de atualização de aplicações através do Microsoft Store Developer CLI são atualmente suportadas apenas para produtos gratuitos. Produtos pagos serão suportados numa versão futura.

Commands

Estes são os comandos disponíveis da Microsoft Store Developer CLI:

Command Description
informação Imprima a configuração existente.
reconfigurar Reconfigure a CLI do desenvolvedor da Microsoft Store.
Configurações Altere as configurações da CLI do desenvolvedor da Microsoft Store.
Submissão Comandos relacionados ao envio, como 'status', 'get', 'getListingAssets', 'updateMetadata', 'update', 'poll', 'publish'.

Para obter mais informações, consulte: Comandos.

Perguntas frequentes

  1. O que é a CLI para Desenvolvedores da Microsoft Store e como me pode ajudar?

    A Microsoft Store Developer CLI é uma ferramenta de linha de comando multiplataforma que permite aos desenvolvedores automatizar muitas tarefas do Partner Center, como:

    • Listar e recuperar informações do aplicativo
    • Atualização de metadados de pacotes, incluindo o URL do instalador alojado pelo seu programador
    • Atualizando metadados da Loja
    • Enviar e publicar atualizações de aplicativos

    Esta ferramenta é particularmente útil para pipelines CI/CD, onde pode submeter automaticamente URLs atualizados do instalador e publicar atualizações da aplicação após a primeira publicação da aplicação através do Partner Center. A autenticação é feita usando credenciais do Entra ID vinculadas à sua conta do Partner Center.

    Ele oferece uma alternativa flexível à interface do usuário da Web e suporta fluxos de trabalho de script no Windows, macOS e Linux. Para usá-lo, os desenvolvedores devem primeiro configurar o acesso à API com as permissões apropriadas. Com essa ferramenta, as equipes podem simplificar e dimensionar significativamente suas operações de lançamento.

  2. Posso automatizar submissões de lojas com a CLI?

    Sim, depois de concluir a primeira publicação da sua aplicação através do Partner Center, pode usar a CLI nos pipelines de construção para submeter metadados atualizados de pacotes e publicar atualizações subsequentes da app. Constrói e aloja o teu instalador MSI/EXE separadamente, depois usa a CLI para submeter metadados do pacote que contenham o seu URL. A Loja recupera o instalador dessa URL; a CLI não o empacota nem o carrega para o servidor. Não podes usar o CLI para completar a primeira publicação.