Android CLI 總覽

Android CLI 是一種指令列介面，可讓您使用自選工具，更有效率地建構 Android 專案。這項計畫會為代理優先工作流程制定核心開發能力標準，並提供官方工具、技能和知識的入門資源，協助您更有效率地開發。此外，隨著 Android 開發作業日益分散，這項工具也能簡化 CI、維護作業和任何其他指令碼自動化作業。

舉例來說，代理程式或指令碼可以使用 CLI 執行下列工作：

  • 自動設定環境和 Android SDK
  • 從範本架構新專案
  • 直接透過終端機管理虛擬裝置、安裝 APK，以及檢查即時裝置畫面和 UI 層級
  • 連線至正在執行的 Android Studio 執行個體，進行語意程式碼分析、Compose 預覽畫面算繪，以及查閱依附元件版本
  • 使用 Journeys 測試應用程式

Android CLI 也可讓代理存取 Android 技能和專用的 Android 知識庫，確保專案採用 Android 建議的模式和最佳做法。

如需 Android CLI 指令和選項的完整說明，請參閱 Android CLI 指令參考資料。

安裝 Android CLI

如要安裝 Android CLI，請按照下列步驟操作：

  1. 下載 Android CLI。

  2. 如要確認您使用的是最新版本，請更新 Android CLI：

    android update

如要檢查電腦是否已安裝 Android CLI，請執行 which android 或 command -v android。如果傳回路徑，表示已安裝。

為服務專員設定

如要協助代理程式瞭解及使用 Android CLI，請執行 android init 安裝 android-cli 技能。

收集的資料

Android CLI 會收集工具的基本使用情況資料。我們收集的資料如下：

  • android 指令和子指令的叫用，例如 android run 和 android create。
  • 使用的非位置引數或選項名稱，例如 --sdk 或 --version。
  • 位置引數和旗標值會對應至 Android CLI 管理的一組預先定義的固定系統選項。舉例來說，我們會收集模擬器範本名稱 (例如 medium_phone 和 large_desktop)，以及代理程式名稱 (例如 GEMINI、CLAUDE 或 CODEX)。
  • 堆疊追蹤和例外狀況訊息，收集前會先將個人識別資訊去識別化，確保隱私權。

以下列舉一些我們不會收集的資料：

  • 執行指令時，我們不會收集 CLI 的回應。
  • 我們不會收集使用者建立的輸入內容，也不會收集傳遞至 CLI 的外部 ID，例如特定 Maven 座標、本機檔案路徑或自訂專案名稱。舉例來說，如果執行 android create --name=com.company.internal.app 指令，我們會使用 --name 引數記錄 android create 的執行情況，但不會儲存 com.company.internal.app 值。

如要停用資料收集功能，請使用 Android CLI 執行指令時，加入 --no-metrics 旗標。

意見回饋與問題

如有任何問題或想提供意見回饋，請回報錯誤。

已知問題

  • Windows 的 android emulator 指令目前已停用。
  • 目前不支援從 Windows PowerShell 下載 Android CLI。

設定 Android CLI

建立 .androidrc 檔案，在每次叫用 Android CLI 時自動套用標記和選項。根據作業系統，將檔案儲存至下列位置：

  • macOS 和 Linux：~/.androidrc
  • Windows：%USERPROFILE%\.androidrc

每行新增一個要自動套用至檔案的標記。

舉例來說，如要讓 Android CLI 每次都預設使用特定 Android SDK，請將 --sdk 旗標新增至檔案：

--sdk=<path-to-sdk>

全域選項

這些是選用旗標，可搭配其他 Android CLI 指令使用。

-h, --help

使用方式： android <command> -h

說明：顯示工具或特定指令的說明手冊。

範例：

  • android -h
  • android create -h

--sdk

使用方式： android --sdk=<path-to-sdk> <command>

說明：您要用於後續指令的 Android SDK 路徑。您可以透過 --sdk 設定暫時覆寫預設 Android SDK，而不必在每次切換時變更全域環境變數。如要查看預設使用的 Android SDK，請執行 android info。

範例： android --sdk=<path/to/sdk> sdk list

-v, --verbose

使用方式： android -v <command>

說明：啟用詳細輸出功能。指定多個 -v 選項，即可提高詳細程度 (例如 -v、-vv 或 -vvv)。

-V, --version

使用方式： android -V

說明：列印版本資訊並結束。

指令

如需 Android CLI 指令和選項的完整說明，請參閱 Android CLI 指令參考資料。