Partilhar via

Documentação da interface Command-Line (CLI)

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, exceto para os recursos de Análise e Diagnóstico, que continuarão a ter suporte até 30 de junho de 2026. Mais informações.

A interface de linha de comando do App Center é uma ferramenta unificada para executar serviços do App Center a partir da linha de comando. A CLI é uma ferramenta poderosa para usar os serviços do App Center e criar scripts de uma sequência de comandos a serem executados. Atualmente, pode iniciar sessão e ver ou configurar todas as aplicações a que tem acesso no App Center.

Para obter mais informações sobre a instalação da CLI e os comandos atualmente suportados, consulte o repositório GitHub da CLI do App Center.

Primeiros passos

Pré-requisitos

A versão Node.js recomendada é 12 ou superior.

Instalação

Abra um terminal/prompt de comando e execute npm install -g appcenter-cli.

Iniciar sessão

  1. Abra uma janela de terminal/comando.
  2. Execute appcenter login. Isso abre um navegador e gera um novo API token.
  3. Copie o API token do navegador e cole-o na janela de comando. Imagem do token do navegador
  4. A janela de comando exibirá Logged in as {user-name}. Imagem do login do terminal
  5. Parabéns! Você está conectado com êxito e pode executar comandos da CLI.

Há duas maneiras de usar os comandos da CLI do App Center sem executar appcenter login antes:

Usando o --token parâmetro

  1. Crie um token deFull Access API (consulte as etapas 1 a 5).
  2. Abra uma janela de terminal/comando.
  3. Adicione o --token switch ao comando da CLI que você está executando. Por exemplo, execute appcenter apps list --token {API-token} para obter uma lista de seus aplicativos configurados.

Usando a APPCENTER_ACCESS_TOKEN variável de ambiente Você pode definir a APPCENTER_ACCESS_TOKEN variável de ambiente com seu token de API. Isso funciona sem ter que acrescentar o --token switch a cada comando da CLI.

Executando seu primeiro comando CLI

  1. Abra uma janela de terminal/comando.
  2. Execute appcenter para ver uma lista de comandos da CLI.
  3. Execute appcenter profile list para obter as informações sobre o usuário conectado.

Para obter mais detalhes sobre uma lista de comandos da CLI, consulte App Center CLI GitHub repo.

Uma observação sobre o uso do --app parâmetro:

Devido a restrições na forma como a análise de nomes de aplicativos é feita, os nomes de aplicativos não devem começar com hífenes ou outros caracteres ambíguos que possam confundir analisadores de estilo GNU. Você pode ler mais sobre isso na questão de CLI associada.

Usando um proxy

Você pode usar a CLI por meio de um proxy. Para isso, você precisaria configurar npm config e especificar a variável de ambiente com endereço proxy. Observe que os endereços proxy devem ser especificados com protocolos (por exemplo http://, ).

Configuração do NPM

Para configurar o uso de proxy no npm, você precisa executar comandos:

npm config set proxy http://username:password@host:port
npm config set https-proxy http://username:password@host:port

Variável de ambiente

Para configurar a variável de ambiente, execute o comando:

Bash:

export HTTP_PROXY="http://host:port"

PowerShell::

$Env:HTTP_PROXY="http://host:port"