Compartir a través de


Documentación de Command-Line Interface (CLI)

Importante

Visual Studio App Center se retiró el 31 de marzo de 2025, excepto las características de análisis y diagnóstico, que seguirán siendo compatibles hasta el 30 de junio de 2026. Más información.

La interfaz de 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 poderosa para utilizar los servicios de App Center y scriptar una secuencia de comandos para 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

Prerrequisitos

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

Instalación

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

Inicio de 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 del navegador 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. ¡Felicidades! Ha iniciado sesión correctamente y puede ejecutar comandos de la CLI.

Hay dos maneras de utilizar los comandos de la CLI de App Center sin que se ejecute la interfaz de línea de comandos appcenter login antes:

Uso del --token parámetro

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

Usar la APPCENTER_ACCESS_TOKEN variable de entorno Puede establecer la APPCENTER_ACCESS_TOKEN variable de entorno con su token de API. No es necesario agregar el interruptor --token a cada comando de CLI para que esto funcione.

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 obtener 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 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 del 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:

Juerga:

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

PowerShell:

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