Sdílet prostřednictvím


Dokumentace k rozhraní Command-Line (CLI)

Důležité

Visual Studio App Center bylo vyřazeno 31. března 2025 s výjimkou funkcí Analýzy a diagnostiky, které se budou dál podporovat až do 30. června 2026. Další informace.

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á Node.js verze 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.

Existují dva způsoby, jak použít příkazy příkazového řádku App Center, aniž byste museli spustit appcenter login předem:

Použití parametru --token

  1. Vytvoření tokenu Full Accessrozhraní API (viz kroky 1 až 5).
  2. Otevřete okno terminálu nebo příkazového okna.
  3. Přidejte přepínač --token do příkazu rozhraní příkazového řádku, který právě používáte. Spuštěním příkazu appcenter apps list --token {API-token} například získáte seznam nakonfigurovaných aplikací.

Pomocí proměnné prostředí APPCENTER_ACCESS_TOKEN můžete nastavit proměnnou prostředí svým tokenem rozhraní API APPCENTER_ACCESS_TOKEN. To funguje, aniž by bylo nutné připojit přepínač --token k jednotlivým příkazům rozhraní příkazového řádku.

Spuštění prvního příkazu CLI

  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žívat 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í

Chcete-li nastavit proměnnou prostředí, spusťte příkaz:

Bash

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

PowerShell:

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