Sdílet prostřednictvím

Dokumentace k rozhraní příkazového řádku (CLI)

  • Článek

Důležité

31. března 2025 je naplánované vyřazení sady Visual Studio App Center. I když můžete Visual Studio App Center dál používat, dokud nebude plně vyřazený, 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 podpory a alternativách.

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í. Aktuálně se můžete přihlásit a zobrazit nebo nakonfigurovat všechny aplikace, ke kterým máte přístup v App Center.

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

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 npm install -g appcenter-clipříkaz .

Přihlášení

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

Příkazy rozhraní příkazového řádku App Center můžete používat dvěma způsoby, aniž byste museli spustit appcenter login předchozí příkazy:

Použití parametru --token

  1. Vytvoření tokenu Full Access rozhraní API (viz kroky 1 až 5).
  2. Otevřete okno terminálu nebo příkazového okna.
  3. --token Přidejte přepínač do příkazu rozhraní příkazového řádku, který používáte. Spuštěním příkazu appcenter apps list --token {API-token} například získáte 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 připojení přepínače k jednotlivým příkazům --token rozhraní příkazového řádku.

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

  1. Otevřete okno terminálu nebo příkazového okna.
  2. Spuštěním appcenter zobrazíte seznam příkazů rozhraní příkazového řádku.
  3. Spuštěním appcenter profile list získáte 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 o použití parametru --app :

Vzhledem k omezením při analýze názvů aplikací nesmí názvy aplikací začínat spojovníky ani jinými nejednoznačnými znaky, které mohou zaměňovat analyzátory stylu GNU. Další informace najdete v přidružené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. V takovém případě byste museli nastavit npm config a zadat proměnnou prostředí s adresou proxy. Všimněte si, že proxy adresy by měly být zadány pomocí protokolů (například http://).

Konfigurace NPM

Pokud chcete nastavit využití proxy serveru v npm, musíte spouštět 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í

Nastavení příkazu spuštění proměnné prostředí:

Udeřit:

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

PowerShell:

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