Документация по интерфейсу Command-Line (CLI)

  • Статья

Важно!

Прекращение поддержки Центра приложений Visual Studio запланировано на 31 марта 2025 г. Хотя вы можете продолжать использовать Центр приложений Visual Studio до полного прекращения его использования, существует несколько рекомендуемых вариантов, на которые можно перейти.

Узнайте больше о сроках поддержки и альтернативных вариантах.

Интерфейс командной строки центра приложений — это единое средство для запуска служб Центра приложений из командной строки. Интерфейс командной строки — это мощный инструмент для использования служб Центра приложений и создания скриптов для выполнения последовательности команд. В настоящее время вы можете войти в систему и просмотреть или настроить все приложения, к которым у вас есть доступ в Центре приложений.

Дополнительные сведения об установке CLI и поддерживаемых в настоящее время командах см. в репозитории GitHub CLI центра приложений.

Приступая к работе

Предварительные требования

Рекомендуемая версия Node.js — 12 или выше.

Установка

Откройте терминал или командную строку и выполните команду npm install -g appcenter-cli.

вход

  1. Откройте окно терминала или командное окно.
  2. Выполните команду appcenter login. Откроется браузер и будет создан новый API token.
  3. API token Скопируйте из браузера и вставьте его в командное окно. Изображение маркера браузера
  4. В командном окне отобразится .Logged in as {user-name} Изображение входа в терминал
  5. Поздравляем! Вы успешно вошли в систему и можете выполнять команды CLI.

Существует два способа использования команд CLI Центра приложений без предварительного выполнения appcenter login .

--token Использование параметра

  1. Создайте Full Accessмаркер API (см. шаги 1–5).
  2. Откройте окно терминала или командное окно.
  3. --token Добавьте параметр в выполняемую команду CLI. Например, выполните команду appcenter apps list --token {API-token} , чтобы получить список настроенных приложений.

С помощью переменной APPCENTER_ACCESS_TOKEN среды Можно задать APPCENTER_ACCESS_TOKEN переменную среды с помощью маркера API. Это работает без добавления переключателя к каждой команде --token CLI.

Выполнение первой команды CLI

  1. Откройте окно терминала или командное окно.
  2. Запустите appcenter , чтобы просмотреть список команд CLI.
  3. Выполните команду appcenter profile list , чтобы получить сведения о вошедшего в систему пользователя.

Дополнительные сведения о списке команд CLI см. в репозитории GitHub CLI центра приложений.

Примечание об использовании --app параметра :

Из-за ограничений в том, как выполняется синтаксический анализ имен приложений, имена приложений не должны начинаться с дефисов или других неоднозначных символов, которые могут спутать средства синтаксического анализа стиля GNU. Дополнительные сведения об этом см. в соответствующей проблеме cli.

Использование прокси-сервера

Интерфейс командной строки можно использовать через прокси-сервер. Для этого необходимо настроить npm config и указать переменную среды с адресом прокси-сервера. Обратите внимание, что адреса прокси-сервера следует указывать с помощью протоколов (например http://, ).

Конфигурация NPM

Чтобы настроить использование прокси-сервера в npm, необходимо выполнить следующие команды:

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

Переменная среды

Чтобы настроить переменную среды, выполните следующую команду:

Bash:

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

PowerShell.

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