安卓编译命令行有哪些常用命令？

在安卓开发中，命令行编译是自动化构建、持续集成以及定制化开发的重要手段，通过掌握安卓编译命令行，开发者可以脱离图形界面（如Android Studio），直接通过脚本实现代码编译、打包、签名等全流程操作，尤其适用于大规模项目构建、CI/CD流水线部署或需要精确控制编译参数的场景，本文将详细介绍安卓编译命令行的核心工具、环境配置、常用命令及实战示例。

核心工具与环境准备

安卓编译命令行的核心工具是make和Android.mk/Android.bp构建脚本，而官方提供的sdkmanager、adb、keytool等工具则辅助完成环境初始化、设备调试和签名等操作,首先需要确保已安装以下环境：

1. JDK：安卓开发推荐使用JDK 8或11（不同版本Android Studio可能要求不同），可通过java -version验证安装。
2. Android SDK：下载并配置android-sdk，包含build-tools（编译工具，如aapt、dx）、platform-tools（adb）和platforms（安卓API版本）。
3. NDK（可选）：用于C/C++代码编译，需通过sdkmanager --install ndk;version安装，并配置NDK_HOME环境变量。
4. CMake/ ninja：部分项目依赖CMake生成构建脚本，ninja则是高效的构建工具，可通过Android SDK的cmake包安装。

环境变量配置示例（Linux/macOS）：

export ANDROID_HOME=$HOME/Library/Android/sdk  # macOS默认路径
export ANDROID_SDK_ROOT=$ANDROID_HOME
export PATH=$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/build-tools/34.0.0:$ANDROID_HOME/cmake/3.22.1/bin
export NDK_HOME=$ANDROID_HOME/ndk/25.1.8937393  # 替换为实际NDK版本

核心编译流程与命令

安卓编译的核心是通过source build/envsetup.sh加载构建脚本，然后使用lunch选择目标设备/编译类型，最后执行make命令,以下是详细步骤：

初始化构建环境

在安卓源码根目录（如AOSP或厂商定制代码）执行：

source build/envsetup.sh

此脚本会定义一系列辅助命令，如croot（切换到源码根目录）、m（等同于make -j$(nproc)）等。

选择编译目标

通过lunch命令选择目标配置，格式为产品名称_编译类型，

lunch aosp_arm64-eng  # 编译ARM64架构的eng版本（未签名，调试用）
lunch lineageos_kenzo-userdebug  # 编译LineageOS的kenzo设备userdebug版本

可执行lunch查看所有可选目标，或通过lunch后跟部分关键词模糊匹配。

执行编译

根据目标类型选择编译命令：

• 编译整个系统：make -j$(nproc) 或简写为 m，$(nproc)自动使用所有CPU核心加速编译。
• 编译单个模块：make 模块名，例如make framework-base（编译框架基础模块）。
• 清理编译缓存：make clean（清理当前模块）、make clobber（清理整个out目录）。

打包镜像文件

编译完成后，产物位于out/target/product/设备名/目录，包含system.img、boot.img等,可通过以下命令单独打包：

make systemimage  # 打包system.img
make bootimage     # 打包boot.img

进阶编译场景

增量编译与依赖分析

安卓构建系统支持增量编译，通过make showcommands可查看详细编译命令，便于调试，若需分析模块依赖关系,可使用：

make -d | grep "Considering target"  # 打印依赖分析日志

使用Kati（make加速工具）

AOSP默认使用Kati替代传统make，提升解析速度，可通过export USE_KATI=true强制启用，或在buildspec.mk中配置。

多设备并行编译

若需同时编译多个目标，可通过make -j$(nproc) target1 target2实现,但需注意资源冲突。

C/C++模块编译（NDK）

对于包含JNI的项目,需先编译本地库：

$NDK_HOME/ndk-build -C $PROJECT_PATH  # 在项目目录执行

或使用CMake：

cmake .. -DCMAKE_TOOLCHAIN_FILE=$NDK_HOME/build/cmake/android.toolchain.cmake
make -j$(nproc)

常见编译问题与解决

相关问答FAQs

Q1: 如何通过命令行单独编译APK并安装到设备？
A: 对于Android.mk定义的应用模块，可执行make 应用名生成APK（位于out/target/product/设备名/system/app/），然后通过adb install -r out/target/product/设备名/system/app/应用名.apk安装，若为独立项目，可直接在项目目录运行./gradlew assembleDebug（需配置Gradle环境）。

Q2: 如何修改编译参数（如启用/禁用模块）？
A: 可通过以下方式修改：

1. 全局配置：编辑buildspec.mk文件，添加PRODUCT_MAKEFILES := device/sample/product/aosp_arm64.mk指定产品配置。
2. 临时覆盖：在lunch后添加参数，如lunch aosp_arm64-eng=eng，或通过export BOARD_USES_HWC2=true设置变量。
3. 模块开关：在Android.mk中使用ifeq ($(ENABLE_MODULE),true)条件编译，或通过PRODUCT_PACKAGES += 模块名在产品配置中动态添加模块。