Documentação da CLI (Interface Command-Line)
Importante
O Visual Studio App Center está programado para ser desativado em 31 de março de 2025. Embora você possa continuar a usar o Visual Studio App Center até que ele seja totalmente desativado, há várias alternativas recomendadas para as quais você pode considerar a migração.
A interface de linha de comando do App Center é uma ferramenta unificada para executar serviços do App Center na 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. No momento, você pode fazer logon e exibir ou configurar todos os aplicativos aos quais você tem acesso no App Center.
Para obter mais informações sobre a instalação da CLI e os comandos com suporte no momento, consulte Repositório GitHub da CLI do App Center.
Introdução
Pré-requisitos
A versão de Node.js recomendada é 12 ou superior.
Instalação
Abra um prompt de terminal/comando e execute npm install -g appcenter-cli
.
Iniciando Sessão
- Abra uma janela terminal/comando.
- Execute
appcenter login
. Isso abre um navegador e gera um novoAPI token
. - Copie o
API token
do navegador e cole-o na janela de comando. - A janela de comando exibirá
Logged in as {user-name}
. - Parabéns! Você está conectado com êxito e pode executar comandos da CLI.
Há duas maneiras de usar comandos da CLI do App Center sem executar appcenter login
anteriormente:
Usando o --token
parâmetro
- Criar um token de
Full Access
API (consulte as etapas 1 a 5). - Abra uma janela terminal/comando.
- Adicione a opção
--token
ao comando da CLI que você está executando. Por exemplo, executeappcenter 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 o token de API. Isso funciona sem precisar acrescentar a opção --token
a cada comando da CLI.
Executando seu primeiro comando da CLI
- Abra uma janela terminal/comando.
- Execute
appcenter
para ver uma lista de comandos da CLI. - 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 Repositório GitHub da CLI do App Center.
Uma observação sobre como usar o --app
parâmetro :
Devido a restrições na forma como a análise de nome do aplicativo é feita, os nomes de aplicativos não devem começar com hifens ou outros caracteres ambíguos que possam confundir analisadores de estilo GNU. Você pode ler mais sobre isso no problema da CLI associada.
Como usar 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 o 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 o comando de execução da variável de ambiente:
Bash:
export HTTP_PROXY="http://host:port"
PowerShell:
$Env:HTTP_PROXY="http://host:port"