Documentação da interface de linha de comando (CLI)

  • 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 migrar.

Saiba mais sobre cronogramas 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. Atualmente, você pode fazer logon e exibir ou configurar todos os aplicativos aos quais tem acesso no App Center.

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

Introdução

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-clio .

Fazendo login

  1. Abra um terminal/janela de comando.
  2. Execute appcenter login. Isso abre um navegador e gera um novo API tokenarquivo .
  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 comandos da CLI do App Center sem executar appcenter login antes:

Usando o --token parâmetro

  1. Crie um token de Full Access API (consulte as etapas 1 a 5).
  2. Abra um terminal/janela de comando.
  3. Adicione o --token switch ao comando 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 precisar anexar o --token switch a cada comando da CLI.

Executando seu primeiro comando CLI

  1. Abra um terminal/janela de 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 o repositório GitHub da CLI do App Center.

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ífens ou outros caracteres ambíguos que possam confundir os analisadores de estilo GNU. Você pode ler mais sobre isso no problema CLI associado.

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 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"