Documentación de Command-Line Interface (CLI)

  • Artículo

Importante

Visual Studio App Center está programado para retirarse el 31 de marzo de 2025. Aunque puede seguir usando Visual Studio App Center hasta que se retire por completo, hay varias alternativas recomendadas a las que puede considerar la posibilidad de migrar.

Obtenga más información sobre las escalas de tiempo y las alternativas de soporte técnico.

La interfaz de la línea de comandos de App Center es una herramienta unificada para ejecutar servicios de App Center desde la línea de comandos. La CLI es una herramienta eficaz para usar los servicios de App Center y crear scripts de una secuencia de comandos que se van a ejecutar. Actualmente puede iniciar sesión y ver o configurar todas las aplicaciones a las que tiene acceso en App Center.

Para obtener más información sobre la instalación de la CLI y los comandos admitidos actualmente, consulte el repositorio de GitHub de la CLI de App Center.

Introducción

Requisitos previos

La versión de Node.js recomendada es 12 o posterior.

Instalación

Abra un símbolo del sistema o terminal y ejecute npm install -g appcenter-cli.

Iniciando sesión

  1. Abra una ventana de terminal o comandos.
  2. Ejecute appcenter login. Se abre un explorador y se genera un nuevo API token.
  3. Copie el API token desde el explorador y péguelo en la ventana de comandos. Imagen del token del explorador
  4. La ventana de comandos mostrará Logged in as {user-name}. Imagen del inicio de sesión del terminal
  5. ¡Enhorabuena! Ha iniciado sesión correctamente y puede ejecutar comandos de la CLI.

Hay dos maneras de usar comandos de la CLI de App Center sin ejecutarse appcenter login antes:

Uso del --token parámetro

  1. Cree un Full Accesstoken de API (consulte los pasos 1-5).
  2. Abra una ventana de terminal o comandos.
  3. Agregue el --token modificador al comando de la CLI que está ejecutando. Por ejemplo, ejecute appcenter apps list --token {API-token} para obtener una lista de las aplicaciones configuradas.

Con la APPCENTER_ACCESS_TOKEN variable de entorno Puede establecer la APPCENTER_ACCESS_TOKEN variable de entorno con el token de API. Esto funciona sin tener que anexar el modificador a cada comando de la --token CLI.

Ejecución del primer comando de la CLI

  1. Abra una ventana de terminal o comandos.
  2. Ejecute appcenter para ver una lista de comandos de la CLI.
  3. Ejecute appcenter profile list para obtener la información sobre el usuario que ha iniciado sesión.

Para más información sobre una lista de comandos de la CLI, consulte el repositorio de GitHub de la CLI de App Center.

Nota sobre el uso del --app parámetro :

Debido a las restricciones en la forma en que se realiza el análisis de nombres de aplicación, los nombres de aplicación no deben comenzar con guiones u otros caracteres ambiguos que puedan confundir a los analizadores de estilo GNU. Puede obtener más información sobre esto en el problema de la CLI asociada.

Uso de un proxy

Puede usar la CLI a través de un proxy. Para ello, tendría que configurar npm config y especificar la variable de entorno con la dirección de proxy. Tenga en cuenta que las direcciones de proxy deben especificarse con protocolos (por ejemplo http://, ).

Configuración de NPM

Para configurar el uso de proxy en npm, debe ejecutar comandos:

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

Variable del entorno

Para configurar el comando de ejecución de variables de entorno:

Bash:

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

PowerShell:

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