Android CLI 總覽

Android CLI 是指令列介面，可讓您使用自選工具，更有效率地建構 Android 專案。這項認證可標準化代理優先工作流程的核心開發能力，並提供官方工具、技能和知識的入門途徑，協助您更有效地開發。此外，由於 Android 開發作業越來越分散，這項工具也能簡化 CI、維護作業和任何其他指令碼自動化作業。

Android CLI 涵蓋完整的開發生命週期，從建立專案、在裝置上測試，到分析效能及調查實際運作情形，都包含在內。例如，代理程式或指令碼可以使用 CLI 執行下列工作：

• 自動設定環境和 Android SDK
• 使用範本建構新專案
• 在連結的裝置或模擬器上建構、安裝及執行應用程式
• 管理虛擬裝置、在電腦視窗中鏡像及控制連結的裝置，以及直接從終端機檢查即時裝置畫面和 UI 階層，並與其互動
• 將 Jetpack Compose 預覽畫面算繪為電腦上的圖片，不需使用裝置或 Android Studio
• 連線至執行中的 Android Studio 執行個體，進行語意程式碼分析、Compose 預覽算繪，以及查詢依附元件版本
• 使用歷程測試應用程式
• 在連結的裝置或模擬器上，記錄系統追蹤記錄並擷取堆積轉儲，分析應用程式
• 分析 APK、應用程式套件和程式庫，回報大小、R8 縮減和最佳化指標，以及保留規則警告
• 調查 Firebase Crashlytics 回報的應用程式當機、ANR 和非致命問題，包括 Crashlytics 在記憶體不足當機時收集的記憶體快照資料

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

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

安裝 Android CLI

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

1. 下載 Android CLI。

2. 為確保您使用的是最新版本，請更新 Android CLI：

   android update
   

   提示： 定期執行 android update，掌握最新功能。

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

為代理設定

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

Android 技能

前往 GitHub 查看

Android CLI

如要安裝 Android CLI 技能，請執行：

android init

收集的資料

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 指令，我們會記錄 android create 是使用 --name 引數執行，但不會儲存 com.company.internal.app 值。

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

意見回饋與問題

如果遇到任何問題或想提供意見，請回報錯誤。

設定 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 指令參考資料。