android build

建構 Android 構件。

用量

android build [-h] [<reference>] [-- <build_args>]

選項

  • -h,--help:顯示指定指令的說明訊息。

android 選項:

  • --sdk=PARAM - Android SDK 的路徑。
  • -v,--verbose:啟用詳細輸出功能,以便排解問題。
  • -V,--version:輸出版本資訊並結束。

位置引數

  • <reference> - 建構參考資料 ([system://][path]?[target])。
  • -- <build_args> - 逐字傳遞至建構系統的引數。請使用 -- 與其他引數分隔。

說明

android build 會偵測工作區的建構系統 (Gradle、Bazel、Soong、Lightbuild 或 Android CLI 設定中宣告的建構系統),並使用該系統建構要求的目標。

傳遞建構參照 ([system://][path]?[target]) 來選取要建構的工作區和目標,或省略 <reference> 來建構目前工作區中的預設目標。

建構參考資料

建構作業參照包含三個選用部分:

  • system://:強制使用特定建構系統 (例如 gradle:// 或 bazel://),而非從工作區偵測。
  • path:工作區中要建構的目錄,絕對或相對於目前目錄 (預設為目前目錄)。
  • ?target:要建構的內容,採用建構系統本身的語法 (例如 Gradle 專案路徑,例如 :app 或 :app@debug,或 Bazel 標籤,例如 //app:app)。

只要有 system:// 或 path,就必須使用 ? 分隔符號 (例如 gradle://?、./app? 或 gradle://./app?:app)。如果沒有 ?,整個參照都會視為目標。

-- 之後的引數會逐字傳遞至基礎建構系統。

範例

在目前的工作區中建構預設目標:

android build

在目前的 Gradle 工作區中建構 :app:

android build :app

從 Gradle 工作區 $HOME/my-app 建構 :app (:app@debug) 的 debug 變體,並將額外引數傳遞至 Gradle:

android build $HOME/my-app?:app@debug -- --offline

建構 Bazel 目標,強制 Bazel 建構系統:

android build bazel://?//app:app