CLI do desenvolvedor da Microsoft Store (MSIX)

Observação

Esta página aborda a publicação de aplicativos MSIX usando a CLI do Desenvolvedor da Microsoft Store. Para obter informações sobre a publicação de aplicativos MSI/EXE 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 ajuda você a publicar atualizações em seus aplicativos na Microsoft Store. Você pode configurar seus projetos de aplicativo localmente e publicar pacotes atualizados usando a CLI, que chama as APIs do Partner Center para carregar os pacotes.

Importante

Você deve concluir a primeira publicação do aplicativo na 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.

Para entender como usar a CLI do Desenvolvedor da Loja, confira o seguinte vídeo:

Pré-requisitos

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

• Registrar-se como desenvolvedor de aplicativos do Windows no Partner Center
• Ter um locatário associado à sua conta do Partner Center. Você pode fazer isso associando uma ID existente do Microsoft Entra no Partner Center ou criando uma nova ID do Microsoft Entra no Partner Center.
• Tenha seu aplicativo já criado no Partner Center. Se o aplicativo ainda não existir, crie seu aplicativo reservando seu nome no Partner Center. A CLI não pode criar um aplicativo para você.
• Conclua a primeira publicação do aplicativo por meio do Partner Center. Crie o primeiro envio para o aplicativo, incluindo o questionário de classificações etárias e envie-o para certificação no Partner Center. Aguarde até que o aplicativo seja publicado no Microsoft Store antes de usar a CLI para publicar atualizações subsequentes.

Instalação

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 a CLI do Desenvolvedor do Microsoft Store (versão prévia) pode ser usada em seus pipelines de CI/CD para, por exemplo, publicar automaticamente atualizações em seus aplicativos no 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.

Comandos

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

Comando	Descrição
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.
Apps	Comandos relacionados ao aplicativo, como listar os aplicativos em sua conta e recuperar os detalhes do aplicativo.
submissão	Comandos relacionados a envios, como "status", "get", "getListingAssets", "updateMetadata", "update", "poll", "publish", "delete", "rollout".
Init	Ajuda você a configurar seu aplicativo para publicar na Microsoft Store.
pacote	Ajuda você a empacotar seu aplicativo da Microsoft Store como um MSIX.
publicar	Publica atualizações para seu aplicativo na Microsoft Store.
Voos	Comandos relacionados a voos, como 'list', 'get', 'delete', 'create', 'submission'.

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
   • Carregando novos pacotes
   • Atualizando metadados da Loja
   • Envio e publicação de atualizações de aplicativos

   Essa ferramenta é particularmente útil para pipelines de CI/CD, em que novos builds podem ser enviados e publicados automaticamente como atualizações 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 aplicativo por meio do Partner Center, você pode usar a CLI em pipelines de build para automatizar o empacotamento, o envio e a publicação de atualizações de aplicativo subsequentes. Você não pode usar a CLI para concluir a primeira publicação.