Dokumentace k rozhraní Command-Line (CLI)

  • Článek

Důležité

31. března 2025 je naplánované vyřazení z provozu. I když můžete dál používat Visual Studio App Center, dokud ho úplně vyřadíte, existuje několik doporučených alternativ, na které můžete zvážit migraci.

Přečtěte si další informace o časových osách a alternativách podpory.

Rozhraní příkazového řádku App Center je jednotný nástroj pro spouštění služeb App Center z příkazového řádku. Rozhraní příkazového řádku je výkonný nástroj pro používání služeb App Center a skriptování posloupnosti příkazů ke spuštění. V současnosti se můžete přihlásit a zobrazit nebo nakonfigurovat všechny aplikace, ke kterým máte přístup v App Centeru.

Další informace o instalaci rozhraní příkazového řádku a aktuálně podporovaných příkazech najdete v úložišti Rozhraní příkazového řádku App Center na GitHubu.

začínáme

Požadavky

Doporučená verze Node.js je 12 nebo vyšší.

Instalace

Otevřete terminál nebo příkazový řádek a spusťte příkaz npm install -g appcenter-cli.

Přihlášení

  1. Otevřete terminál nebo příkazové okno.
  2. Spusťte appcenter login. Otevře se prohlížeč a vygeneruje se nový API token.
  3. Zkopírujte soubor API token z prohlížeče a vložte ho do příkazového okna. Obrázek tokenu prohlížeče
  4. V příkazovém okně se zobrazí Logged in as {user-name}. Obrázek přihlášení k terminálu
  5. Gratulujeme! Jste úspěšně přihlášeni a můžete spouštět příkazy rozhraní příkazového řádku.

Existují dva způsoby, jak používat příkazy rozhraní příkazového řádku App Center bez předchozího spuštění appcenter login :

Použití parametru --token

  1. Vytvořte Full Accesstoken rozhraní API (viz kroky 1 až 5).
  2. Otevřete terminál nebo příkazové okno.
  3. --token Přidejte přepínač do příkazu rozhraní příkazového řádku, který spouštíte. Například spuštěním příkazu appcenter apps list --token {API-token} získejte seznam nakonfigurovaných aplikací.

APPCENTER_ACCESS_TOKEN Pomocí proměnné prostředí Můžete nastavit proměnnou prostředí pomocí tokenu APPCENTER_ACCESS_TOKEN rozhraní API. To funguje bez nutnosti připojit přepínač ke každému --token příkazu rozhraní příkazového řádku.

Spuštění prvního příkazu rozhraní příkazového řádku

  1. Otevřete terminál nebo příkazové okno.
  2. Spuštěním appcenter příkazu zobrazíte seznam příkazů rozhraní příkazového řádku.
  3. Spuštěním příkazu appcenter profile list získejte informace o přihlášených uživatelích.

Další podrobnosti o seznamu příkazů rozhraní příkazového řádku najdete v úložišti Rozhraní příkazového řádku App Center na GitHubu.

Poznámka k použití parametru --app :

Vzhledem k omezením při parsování názvů aplikací nesmí názvy aplikací začínat spojovníky nebo jinými nejednoznačnými znaky, které můžou zaměňovat analyzátory stylu GNU. Další informace najdete v souvisejícím problému s rozhraním příkazového řádku.

Použití proxy serveru

Rozhraní příkazového řádku můžete použít prostřednictvím proxy serveru. K tomu byste museli nastavit npm config a zadat proměnnou prostředí s adresou proxy serveru. Všimněte si, že adresy proxy serveru by měly být zadané pomocí protokolů (například http://).

Konfigurace NPM

Pokud chcete nastavit využití proxy serveru v npm, musíte spustit příkazy:

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

Proměnná prostředí

Pokud chcete nastavit proměnnou prostředí, spusťte příkaz:

Bash:

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

PowerShell:

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