Condividi tramite


Documentazione dell'interfaccia della riga di comando

Importante

Visual Studio App Center è pianificato per il ritiro il 31 marzo 2025. Anche se è possibile continuare a usare Visual Studio App Center fino a quando non viene completamente ritirato, esistono diverse alternative consigliate a cui è possibile considerare la migrazione.

Altre informazioni sulle sequenze temporali e sulle alternative di supporto.

L'interfaccia della riga di comando di App Center è uno strumento unificato per l'esecuzione dei servizi di App Center dalla riga di comando. L'interfaccia della riga di comando è uno strumento potente per l'uso dei servizi di App Center e la creazione di script di una sequenza di comandi da eseguire. È attualmente possibile accedere e visualizzare o configurare tutte le app a cui si ha accesso in App Center.

Per altre informazioni sull'installazione dell'interfaccia della riga di comando e sui comandi attualmente supportati, vedere il repository GitHub dell'interfaccia della riga di comando di App Center.

Introduzione

Prerequisiti

La versione consigliata Node.js è 12 o successiva.

Installazione

Aprire un terminale o un prompt dei comandi ed eseguire npm install -g appcenter-cli.

Accesso

  1. Aprire una finestra terminale/comando.
  2. Eseguire appcenter login. Verrà aperto un browser e verrà generato un nuovo API tokenoggetto .
  3. Copiare dal API token browser e incollarlo nella finestra di comando. Immagine del token del browser
  4. La finestra di comando visualizzerà Logged in as {user-name}. Immagine dell'account di accesso del terminale
  5. Complimenti. L'accesso è stato completato ed è possibile eseguire i comandi dell'interfaccia della riga di comando.

Esistono due modi per usare i comandi dell'interfaccia della riga di comando di App Center senza eseguire appcenter login prima:

Uso del --token parametro

  1. Creare un Full Access token API (vedere i passaggi da 1 a 5).
  2. Aprire una finestra terminale/comando.
  3. Aggiungere l'opzione --token al comando dell'interfaccia della riga di comando in esecuzione. Ad esempio, eseguire appcenter apps list --token {API-token} per ottenere un elenco delle applicazioni configurate.

Usando la APPCENTER_ACCESS_TOKEN variabile di ambiente È possibile impostare la APPCENTER_ACCESS_TOKEN variabile di ambiente con il token API. Questa operazione funziona senza dover aggiungere l'opzione a ogni comando dell'interfaccia --token della riga di comando.

Esecuzione del primo comando dell'interfaccia della riga di comando

  1. Aprire una finestra terminale/comando.
  2. Eseguire appcenter per visualizzare un elenco di comandi dell'interfaccia della riga di comando.
  3. Eseguire appcenter profile list per ottenere le informazioni sull'utente connesso.

Per altri dettagli su un elenco dei comandi dell'interfaccia della riga di comando, vedere il repository GitHub dell'interfaccia della riga di comando di App Center.

Nota sull'uso del --app parametro :

A causa delle restrizioni relative al modo in cui viene eseguita l'analisi dei nomi dell'app, i nomi delle applicazioni non devono iniziare con trattini o altri caratteri ambigui che potrebbero confondere i parser di stile GNU. Per altre informazioni, vedere il problema dell'interfaccia della riga di comando associato.

Uso di un proxy

È possibile usare l'interfaccia della riga di comando tramite un proxy. A tale scopo, è necessario configurare npm config e specificare la variabile di ambiente con l'indirizzo proxy. Si noti che gli indirizzi proxy devono essere specificati con i protocolli ( ad esempio http://).

Configurazione NPM

Per configurare l'utilizzo del proxy in npm, è necessario eseguire i comandi:

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

Variabile di ambiente

Per configurare il comando run della variabile di ambiente:

Bash:

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

PowerShell:

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