Android CLI 版本資訊

Android CLI 是從終端機進行 Android 開發的主要介面,可使用您選擇的代理和工具,提升開發工作流程效率。

本頁列出每個 Android CLI 版本的新功能。如要下載 Android CLI,請前往下載頁面。詳情請參閱 Android CLI 總覽。

1.0.16406183 版 (2026 年 9 月)

  • 啟動速度更快:Android CLI 的啟動速度約快一倍,因為原生下載器程式庫只會在需要時載入,不再於每次叫用時解壓縮至暫時目錄。
  • 修正結束代碼:現在命令失敗時會傳回非零的結束代碼,包括 create、run、install、describe、layout、docs、info、skills 和 update,讓指令碼和 CI 更可靠。
  • 螢幕註解調整:android screen --annotate 會公開功能偵測的調整參數,包括邊緣偵測閾值、形狀篩選和叢集策略,詳情請參閱 --help。
  • 專案建立選項:android create 支援 --application-id 和 --namespace 旗標,以及連字號選項名稱,例如 --min-sdk。Compose 範本現在使用 src/main/kotlin 來源集和 Material 3 主題。
  • 無頭模擬器:使用 android emulator start --headless 啟動沒有視窗的模擬器。
  • SDK 可靠性:android sdk 指令會取得程序間鎖定,因此並行呼叫不會發生衝突、驗證已安裝套件的路徑和版本、僅在必要時更新舊版 XML 檔案,以及回報更清楚的錯誤。
  • Compose 預覽輸出:android studio render-compose-preview 會列印算繪圖片的絕對路徑,並在即使使用 --print-semantics 時,確認寫入作業。
  • 支援舊版 API 級別:修正 API 級別 32 以下裝置的裝置互動失敗問題,例如 android layout。

1.0.16261425 版 (2026 年 9 月)

  • 版面配置修正:修正版面配置指令在某些情況下無法運作的問題。如要暫時還原為舊版版面配置行為,請使用 export ANDROID_CLI_LAYOUT_V1=1。

1.0.16251017 版 (2026 年 9 月)

  • 版面配置傾印:android layout 現在支援 --no-idle 旗標,可擷取版面配置,不必等待閒置狀態。android layout 也支援 --full 旗標,可傳回整個版面配置樹狀結構,而不進行篩選;根據預設,layout 只會傳回互動式元素。
  • 殼層完成:使用新的 android completion 指令,為 Bash 和 Zsh 產生及安裝殼層自動完成指令碼。
  • 更新技能:使用新的 android skills update 指令更新技能,並在單一叫用中安裝或移除多項技能 (例如 android skills install <skill1> <skill2>)。
  • 依代理列出技能:android skills list現在預設為詳細顯示,包括技能說明和安裝技能的代理。android skills list 也支援 --agent <agent> 標記,可列出代理安裝的所有技能。
  • Delta 安裝效能:在 android install 中使用零複製核心系統呼叫,加快漸進式 APK 修補速度。
  • 螢幕邊緣偵測:改良功能和邊緣偵測 android screen,使用 Canny 邊緣偵測演算法。

1.0.15985488 版 (2026 年 7 月)

  • 專用安裝指令:使用獨立的 android install 指令安裝 APK,這個指令具有漸進式 APK 推送功能,可大幅加快漸進式安裝速度,比 adb 快上好幾個數量級。
  • 執行漸進式安裝:同樣地,在 android run 中使用新的 --use-delta-install 標記,即可加快將漸進式 APK 部署至裝置的速度。
  • 跨平台 SDK 管理:在 android sdk 指令 (install、update、materialize) 中使用新的 --platform <os_arch> 標記,以非主機平台為目標,檢查、解決及安裝跨 OS 和 CPU 架構的元件。
  • Skills CLI 強化功能:擴充 android skills 子指令 (add、remove、list、find),提供 --help 說明文件,在缺少技能時提供清楚的回饋,並透過自動復原功能,確保原子下載暫存作業安全無虞。

1.0.15857036 版 (2026 年 7 月)

  • 支援更多代理技能:使用 android skills install 在數十個代理程式環境 (包括 Claude Code、Cursor、Cline、OpenHands、Windsurf、Zed 和 Devin) 中安裝代理技能。
  • 支援 Proxy 的原生下載器:使用原生 HTTP 下載器可靠地下載網路資源,並支援企業 Proxy。
  • SDK 套件管理:在 android sdk remove 中管理 SDK 套件,並在 android sdk resolve 中以 SHA 為基礎解決問題。
  • 說明和畫面改善:直接在 android describe 的標準輸出中查看 Gradle 建構錯誤,並在 android screen 中使用 --device 標記指定特定裝置。
  • CLI 可用性和錯誤報告:輸入不明指令或無效專案建立目標時,會顯示更清楚的錯誤訊息;android emulator 指令不區分大小寫。

1.0.15498356 版 (2026 年 5 月)

  • 動態載入 SDK 範本:現在會從 Android SDK 套件動態下載 android create 的專案範本,而不是在 CLI 二進位檔中進行組合,確保新專案一律使用最新範本。
  • SDK 授權相容性:android sdk 儲存的已接受 SDK 授權,現在符合舊版 Android SDK 工具和 Gradle 外掛程式預期的檔案格式。
  • 符號連結支援:新增對 CLI 指令和檔案作業的符號連結支援。
  • 原子二進位檔擷取:在並行多程序 CLI 叫用期間,先將二進位檔解壓縮至暫時目錄,再以原子方式移至適當位置,避免擷取競爭條件。
  • Windows 穩定性:改善 Windows 11 的相容性和效能,並修正主目錄路徑解析問題。

1.0.15433482 版 (2026 年 5 月)

  • 整合 Antigravity:Android CLI 和技能現已正式整合至 Google Antigravity 2.0,做為選用的資源套件,可簡化代理開發作業。
  • Android Studio 指令:使用新的 android studio 指令,讓代理程式運用 Android Studio 的深入情境功能,包括程式碼分析、語意查詢和 Compose 算繪。
  • 支援歷程:使用歷程驗證重要使用者體驗。歷程是以自然語言描述使用者流程,代理程式可從終端機或 CI/CD 執行。
  • 全新 Android 技能:存取全新的 Android 技能程式庫,包括 CameraX 遷移、自適應 UI、AppFunctions 和 Compose 樣式的技能。
  • 更多安裝選項:使用熱門套件管理工具 (包括 apt-get、winget 和 homebrew) 安裝及更新 Android CLI。詳情請參閱下載選項。

0.7 版 (2026 年 4 月)

初版!