Command-Line 接口 (CLI) 文档

  • 项目

重要

Visual Studio App Center 计划于 2025 年 3 月 31 日停用。 虽然可以继续使用 Visual Studio App Center，直到它完全停用，但你可以考虑迁移到几个建议的替代方法。

详细了解支持时间线和替代方法。

App Center 命令行接口是从命令行运行 App Center 服务的统一工具。 CLI 是一个功能强大的工具，可用于使用 App Center 服务和编写要执行的一系列命令的脚本。 你当前可以在 App Center 中登录并查看或配置你有权访问的所有应用。

若要获取有关 CLI 安装和当前支持的命令的详细信息，请参阅 App Center CLI GitHub 存储库。

入门

先决条件

建议 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 命令。

有两种方法可以在不运行 appcenter login 之前的情况下使用 App Center CLI 命令：

--token使用 参数

  1. 创建 Full AccessAPI 令牌 (请参阅步骤 1-5) 。
  2. 打开终端/命令窗口。
  3. 将 --token 开关添加到正在运行的 CLI 命令。 例如，运行 appcenter apps list --token {API-token} 以获取已配置应用程序的列表。

APPCENTER_ACCESS_TOKEN使用 环境变量 可以使用 API 令牌设置APPCENTER_ACCESS_TOKEN环境变量。 这无需将开关追加 --token 到每个 CLI 命令即可正常工作。

运行第一个 CLI 命令

  1. 打开终端/命令窗口。
  2. 运行 appcenter 以查看 CLI 命令的列表。
  3. 运行 appcenter profile list 以获取有关已登录用户的信息。

有关 CLI 命令列表的更多详细信息，请参阅 App Center CLI GitHub 存储库。

有关使用 参数的说明 --app ：

由于应用名称分析的完成方式存在限制，应用程序名称不得以连字符或其他可能混淆 GNU 样式分析器的不明确字符开头。 有关此内容的详细信息，请参阅相关的 CLI 问题。

使用代理

可以通过代理使用 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"