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
。
正在登入
- 開啟終端機/命令視窗。
- 執行
appcenter login
。 這會開啟瀏覽器並產生新的API token
。 API token
從瀏覽器複製 ,並將此內容貼到命令視窗中。- 命令視窗會顯示
Logged in as {user-name}
。 - 恭喜! 您已成功登入,而且可以執行 CLI 命令。
有兩種方式可以使用App Center CLI命令,而不需事先執行 appcenter login
:
--token
使用 參數
- 建立
Full Access
API 令牌 (請參閱步驟 1-5) 。 - 開啟終端機/命令視窗。
- 將
--token
參數新增至您執行的 CLI 命令。 例如,執行appcenter apps list --token {API-token}
以取得已設定的應用程式清單。
APPCENTER_ACCESS_TOKEN
使用環境變數 您可以使用 API 令牌來設定APPCENTER_ACCESS_TOKEN
環境變數。 這不需將參數附加 --token
至每個 CLI 命令即可運作。
執行您的第一個 CLI 命令
- 開啟終端機/命令視窗。
- 執行
appcenter
以查看 CLI 命令的清單。 - 執行
appcenter profile list
以取得已登入使用者的相關信息。
如需 CLI 命令列表的詳細資訊,請參閱 App Center CLI GitHub 存放庫。
關於使用 參數的 --app
注意事項:
由於應用程式名稱剖析方式的限制,應用程式名稱不得以連字元或其他模棱兩可混淆 GNU 樣式剖析器的模棱兩可字元開頭。 您可以在相關聯的 CLI 問題中深入瞭解此問題。
使用 Proxy
您可以透過 Proxy 使用 CLI。 因此,您必須設定 npm config
並指定具有 Proxy 位址的環境變數。
請注意,應該使用通訊協定 (來指定 Proxy 位址,例如 http://
) 。
NPM 設定
若要在 npm 中設定 Proxy 使用量,您需要執行命令:
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"