Android 构建命令是开发过程中不可或缺的核心工具，主要用于将源代码编译打包成可安装的应用程序（APK、AAB 或其他格式），Android 开发中常用的构建工具包括 Gradle、Ant 和 Make，Gradle 是目前官方推荐的主流构建工具，其灵活性和可扩展性使其成为 Android 开发的标准配置，本文将详细介绍 Android 构建命令的使用方法、核心参数及常见场景。
在 Android 项目中，构建命令通常通过 Gradle 执行，而 Gradle 的调用方式又分为命令行工具和 IDE 集成两种，命令行构建的优势在于自动化、批处理和远程部署，适合 CI/CD 流水线和持续集成环境，以 Gradle 为例，最基础的构建命令是 ./gradlew build，该命令会执行项目的完整构建流程，包括编译源代码、生成资源文件、运行单元测试、打包 APK/AAB 等步骤。build 是 Gradle 的一个聚合任务，实际上包含了 assemble（打包）和 check（检查）两个核心任务。assemble 任务负责生成所有构建变体的安装包，而 check 任务则运行测试代码并执行代码检查工具（如 Lint）。
针对不同的构建需求，Gradle 提供了更精细的任务控制。./gradlew assembleDebug 仅构建调试版本的 APK，而 ./gradlew assembleRelease 则构建发布版本的 APK，Android 项目通常支持多维度构建变体，如产品风味（Product Flavor）和构建类型（Build Type），可以通过 ./gradlew assembleFlavorBuildType 的形式指定具体变体，./gradlew assembleFreeDebug 会构建“免费版+调试”的 APK。./gradlew installDebug 命令可将构建好的 APK 直接安装到连接的 Android 设备或模拟器中，方便开发调试；./gradlew uninstallDebug 则用于卸载应用。
构建过程中，参数配置对输出结果至关重要，Gradle 支持通过命令行参数覆盖配置文件中的设置，./gradlew assembleRelease -Pandroid.injected.signing.store.file=my.keystore 可以指定签名密钥库文件，-Pandroid.injected.signing.store.password=123456 设置密钥库密码，这些参数常用于 CI/CD 环境中动态配置签名信息。--offline 参数可启用离线构建，避免重复下载依赖；--parallel 参数启用并行构建，加速大型项目的编译速度；--info 或 --debug 参数输出详细的构建日志,便于排查问题。
对于需要增量构建的场景，./gradlew assemble 会跳过未修改模块的编译，大幅缩短构建时间，而 ./gradlew clean 命令则会清理项目中的所有构建文件（如 build/ 目录），强制下次构建时从头开始编译，常用于解决缓存导致的问题，在多模块项目中，可通过 module:task 的形式指定特定模块的构建任务，./gradlew :app:build 仅构建 app 模块。
以下是常用 Gradle 构建命令的总结：
| 命令 | 功能描述 | 适用场景 |
|---|---|---|
./gradlew build |
执行完整构建（编译、测试、打包） | 项目整体构建 |
./gradlew assembleDebug |
构建调试版本 APK | 开发调试 |
./gradlew assembleRelease |
构建发布版本 APK | 应用发布 |
./gradlew installDebug |
安装调试 APK 到设备 | 开发测试 |
./gradlew clean |
清理构建缓存 | 解决编译异常 |
./gradlew --parallel |
并行构建加速 | 大型项目构建 |
./gradlew :app:build |
构建指定模块 | 多模块项目 |
除了 Gradle，Android 早期还使用 Ant 和 Make 工具，Ant 通过 ant debug 或 ant release 命令构建 APK，但因其配置复杂、扩展性差，已逐渐被 Gradle 替代，Make 工具则主要用于底层系统编译,普通应用开发较少涉及。
在实际开发中，构建命令的灵活运用能显著提升效率，通过自定义 Gradle Task 实现自动化逻辑，或结合 Shell 脚本批量处理构建任务，构建性能优化（如启用 Gradle 守护进程、配置内存参数）也是大型项目的重要课题。
相关问答 FAQs
Q1: 如何解决 Gradle 构建时出现的“依赖冲突”问题？
A1: 依赖冲突通常表现为 Failed to resolve: xxx 或 Duplicate class: xxx 错误，可通过以下步骤解决：1）在 build.gradle 文件中使用 implementation 或 api 明确依赖版本；2）运行 ./gradlew dependencies 命令查看依赖树，定位冲突来源；3）使用 exclude group: 'xxx' 排除冲突依赖；4）在 gradle.properties 中配置 android.enableJetifier=true 解决 AndroidX 兼容问题，若仍无法解决，可尝试 ./gradlew clean 清理缓存后重新构建。
Q2: 如何加速 Android 项目的 Gradle 构建速度？
A2: 加速构建的方法包括：1）启用 Gradle 守护进程（在 gradle.properties 中添加 org.gradle.daemon=true）；2）增加并行构建线程数（org.gradle.parallel=true 和 org.gradle.workers.max=4）；3）配置离线模式（--offline），适用于依赖无变化的场景；4）使用构建缓存（org.gradle.caching=true）；5）在模块级 build.gradle 中启用 android.enableJetifier=false（若无需 AndroidX 转换）；6）优化代码结构，减少模块间依赖；7）升级 Gradle 版本和 Android Plugin for Gradle 至最新稳定版。
