Dokumentacja interfejsu Command-Line (CLI)

Interfejs wiersza polecenia usługi App Center to ujednolicone narzędzie do uruchamiania usług App Center z poziomu wiersza polecenia. Interfejs wiersza polecenia to potężne narzędzie do korzystania z usług App Center i szybkiego tworzenia skryptów zawierających sekwencję poleceń. Obecnie możesz zalogować się i wyświetlić lub skonfigurować wszystkie aplikacje, do których masz dostęp w Centrum aplikacji.

Aby uzyskać więcej informacji na temat instalacji CLI (interfejsu wiersza polecenia) oraz aktualnie obsługiwanych poleceń, zapoznaj się z repozytorium GitHub CLI App Center.

Wprowadzenie

Wymagania wstępne

Zalecana wersja Node.js to 12 lub nowsza.

Instalacja

Otwórz terminal lub wiersz polecenia i uruchom npm install -g appcenter-cli.

Logowanie

1. Otwórz okno terminala/wiersz polecenia.
2. Uruchom program appcenter login. Spowoduje to otwarcie przeglądarki i wygenerowanie nowego elementu API token.
3. Skopiuj element API token z przeglądarki i wklej go w oknie polecenia.
4. Zostanie wyświetlone okno polecenia Logged in as {user-name}.
5. Gratulacje! Pomyślnie zalogowano się i można uruchomić polecenia CLI.

Istnieją dwa sposoby używania poleceń CLI App Center bez uprzedniego uruchomienia appcenter login:

Używanie parametru --token

1. Utwórz Full Accesstoken API (zobacz kroki 1–5).
2. Otwórz okno terminala/okno poleceń.
3. Dodaj przełącznik --token do polecenia CLI, które uruchamiasz. Na przykład uruchom polecenie appcenter apps list --token {API-token} , aby uzyskać listę skonfigurowanych aplikacji.

Za pomocą zmiennej środowiskowej APPCENTER_ACCESS_TOKEN możesz ustawić zmienną środowiskową przy użyciu tokenu interfejsu APPCENTER_ACCESS_TOKEN API. To działa bez konieczności dołączania przełącznika --token do każdego polecenia CLI wiersza polecenia.

Uruchamianie pierwszego polecenia CLI

1. Otwórz okno konsoli.
2. Uruchom polecenie appcenter , aby wyświetlić listę poleceń interfejsu wiersza polecenia.
3. Uruchom polecenie appcenter profile list , aby uzyskać informacje o zalogowanym użytkowniku.

Aby uzyskać więcej informacji na temat listy poleceń CLI, zapoznaj się z repozytorium GitHub App Center CLI.

Uwaga dotycząca używania parametru --app :

Ze względu na ograniczenia dotyczące sposobu analizowania nazw aplikacji nazwy aplikacji nie mogą rozpoczynać się od łączników ani innych niejednoznacznych znaków, które mogą mylić analizatory stylów GNU. Więcej informacji na ten temat można uzyskać w skojarzonym problemie z interfejsem wiersza polecenia.

Korzystanie z serwera proxy

Możesz korzystać z interfejsu wiersza poleceń za pośrednictwem serwera proxy. W tym celu należy skonfigurować npm config i określić zmienną środowiskową z adresem serwera proxy. Należy pamiętać, że adresy serwera proxy powinny być określone przy użyciu protokołów (na przykład http://).

Konfiguracja serwera NPM

Aby skonfigurować użycie serwera proxy w narzędziu npm, należy uruchomić polecenia:

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

Zmienna środowiskowa

Aby skonfigurować polecenie uruchamiania zmiennej środowiskowej:

Bash:

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

PowerShell:

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