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 配置中声明的构建系统),并使用该系统构建请求的目标。

传递 build 引用 ([system://][path]?[target]) 以选择要构建的工作区和目标,或省略 <reference> 以在当前工作区中构建默认目标。

构建参考

build 引用包含三个可选部分:

  • 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

从 $HOME/my-app 处的 Gradle 工作区构建 :app (:app@debug) 的 debug 变体,并将额外参数传递给 Gradle:

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

构建 Bazel 目标,强制 Bazel 构建系统:

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