Partager via

Documentation de l’interface de ligne de commande (CLI)

  • Article

Important

Visual Studio App Center est prévu pour la mise hors service le 31 mars 2025. Bien que vous puissiez continuer à utiliser Visual Studio App Center jusqu’à ce qu’il soit entièrement mis hors service, il existe plusieurs alternatives recommandées que vous pouvez envisager de migrer vers.

En savoir plus sur les chronologies de support et les alternatives.

L’interface de ligne de commande App Center est un outil unifié permettant d’exécuter des services App Center à partir de la ligne de commande. L’interface CLI est un outil puissant pour l’utilisation des services App Center et l’écriture de scripts d’une séquence de commandes à exécuter. Vous pouvez actuellement vous connecter et afficher ou configurer toutes les applications auxquelles vous avez accès dans App Center.

Pour obtenir plus d’informations sur l’installation de l’interface CLI et les commandes actuellement prises en charge, reportez-vous au dépôt GitHub de l’interface CLI App Center.

Mise en route

Prérequis

La version recommandée Node.js est 12 ou ultérieure.

Installation

Ouvrez un terminal/invite de commandes, puis exécutez npm install -g appcenter-cli.

Connexion

  1. Ouvrez une fenêtre terminal/commande.
  2. Exécutez appcenter login. Cela ouvre un navigateur et génère un nouveau API token.
  3. Copiez l’élément API token à partir du navigateur et collez-le dans la fenêtre de commande. Image du jeton de navigateur
  4. La fenêtre de commande s’affiche Logged in as {user-name}. Image de la connexion au terminal
  5. Félicitations ! Vous êtes connecté avec succès et pouvez exécuter des commandes CLI.

Il existe deux façons d’utiliser les commandes CLI App Center sans exécuter appcenter login préalablement :

Utilisation du --token paramètre

  1. Créez un jeton d’API Full Access (voir les étapes 1 à 5).
  2. Ouvrez une fenêtre terminal/commande.
  3. Ajoutez le --token commutateur à la commande CLI que vous exécutez. Par exemple, exécutez appcenter apps list --token {API-token} pour obtenir la liste de vos applications configurées.

À l’aide de la variable d’environnementAPPCENTER_ACCESS_TOKEN, vous pouvez définir la APPCENTER_ACCESS_TOKEN variable d’environnement avec votre jeton d’API. Cela fonctionne sans avoir à ajouter le --token commutateur à chaque commande CLI.

Exécution de votre première commande CLI

  1. Ouvrez une fenêtre terminal/commande.
  2. Exécutez appcenter pour afficher la liste des commandes CLI.
  3. Exécutez appcenter profile list pour obtenir les informations sur l’utilisateur connecté.

Pour plus d’informations sur la liste des commandes CLI, reportez-vous au dépôt GitHub de l’interface CLI App Center.

Remarque sur l’utilisation du --app paramètre :

En raison de restrictions dans la façon dont l’analyse des noms d’application est effectuée, les noms d’application ne doivent pas commencer par des traits d’union ou d’autres caractères ambigus susceptibles de confondre les analyseurs de style GNU. Vous pouvez en savoir plus sur ce problème dans le problème CLI associé.

Utilisation d’un proxy

Vous pouvez utiliser l’interface CLI via un proxy. Pour cela, vous devez configurer npm config et spécifier la variable d’environnement avec l’adresse proxy. Notez que les adresses proxy doivent être spécifiées avec des protocoles (par exemple http://).

NPM Configuration

Pour configurer l’utilisation du proxy dans npm, vous devez exécuter des commandes :

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

Variable d'environnement

Pour configurer la commande d’exécution de variable d’environnement :

Bash :

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

PowerShell :

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