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

  • Artigo

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.

Saiba mais sobre linhas do tempo e alternativas de suporte.

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

  1. Abra uma janela 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 logon do terminal
  5. 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

  1. Criar um token de Full AccessAPI (consulte as etapas 1 a 5).
  2. Abra uma janela terminal/comando.
  3. Adicione a opção --token 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 o token de API. Isso funciona sem precisar acrescentar a opção --token a cada comando da CLI.

Executando seu primeiro comando da CLI

  1. Abra uma janela 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 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"