构建 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