CLI do Desenvolvedor da Microsoft Store (MSI/EXE)

Observação

Esta página aborda a publicação de aplicativos MSI/EXE usando a CLI do Desenvolvedor da Microsoft Store. 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 Microsoft Store é uma CLI multiplataforma (Windows, macOS, Linux) que ajuda você a publicar atualizações em seus aplicativos na Microsoft Store. Para aplicativos MSI/EXE, a CLI chama as APIs do Partner Center para enviar metadados de pacote contendo a URL do instalador hospedado pelo desenvolvedor. A Store recupera o instalador dessa URL; a CLI não empacota nem faz upload do binário do instalador. Para obter os requisitos de hospedagem, consulte Adicionar e editar informações do pacote.

Importante

Você deve concluir a primeira publicação do aplicativo para a Microsoft Store por meio do Partner Center. Depois que seu aplicativo for publicado, você poderá usar a CLI do desenvolvedor do Microsoft Store para publicar atualizações subsequentes.

O processo para usar a CLI do Desenvolvedor da Loja é o mesmo para aplicativos MSI/EXE e MSIX. Portanto, para entender como usá-lo, confira o seguinte vídeo:

Pré-requisitos

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

Installation

A CLI do Desenvolvedor da Microsoft Store dá suporte ao Windows 10+, Linux e macOS:

Instale a CLI do Desenvolvedor da Microsoft Store (versão prévia) agora!

Introdução

Depois de instalar a CLI do desenvolvedor da Microsoft Store, 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 fazer login, não use 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 nossa seção de pré-requisitos .

Também há suporte para a execução em ambientes de CI, e o Microsoft Store Developer CLI (versão prévia) pode ser usado em seus pipelines de CI/CD para, por exemplo, publicar automaticamente atualizações em seus aplicativos na Microsoft Store. Mais instruções sobre como fazer isso podem ser encontradas aqui.

Observação

No momento, há suporte para operações de atualização de aplicativo por meio da CLI do Desenvolvedor da Microsoft Store somente para produtos gratuitos. Os produtos pagos terão suporte em uma versão futura.

Commands

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

Command Description
info 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 do desenvolvedor do Microsoft Store e como ela pode me ajudar?

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

    • Listando e recuperando informações do aplicativo
    • Atualizando metadados do pacote, incluindo a URL do instalador hospedado pelo desenvolvedor
    • Atualizando metadados da Loja
    • Envio e publicação de atualizações de aplicativos

    Essa ferramenta é particularmente útil para pipelines de CI/CD, em que você pode enviar automaticamente URLs do instalador atualizadas e publicar atualizações de aplicativo após a primeira publicação do aplicativo por meio do Partner Center. A autenticação é feita usando as credenciais de ID do Entra vinculadas à sua conta do Partner Center.

    Ele oferece uma alternativa flexível à interface do usuário da Web e dá suporte a 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 envios do Store com a CLI?

    Sim, depois de concluir a primeira publicação do seu aplicativo por meio do Partner Center, você pode usar a CLI em pipelines de build para enviar metadados de pacote atualizados e publicar atualizações subsequentes do aplicativo. Crie e hospede o instalador MSI/EXE separadamente e use a CLI para enviar metadados de pacote que contêm sua URL. O repositório recupera o instalador dessa URL; a CLI não o empacota nem faz upload dele. Você não pode usar a CLI para concluir a primeira publicação.

  • Última atualização em