告别编译烦恼：手把手教你用Android.bp预制第三方so库（附32/64位配置）
在Android开发中，集成第三方预编译库是每个开发者都会遇到的场景。无论是供应商提供的闭源SDK，还是性能优化团队交付的.so/.a文件，如何高效、正确地将其集成到项目中，往往成为开发过程中的一大痛点。特别是在Android 10及更高版本的系统开发中，传统的Android.mk方式已逐渐被Android.bp取代，这要求开发者掌握新的构建系统规则和配置方法。
本文将带你深入理解Android.bp中预制第三方库的核心机制，从文件放置到编译验证，提供一套完整的、可复现的流程。我们不仅会讲解cc_prebuilt_library_shared/static的每个关键参数，还会重点解决多架构（arm/arm64）兼容问题，帮助你避开那些让开发者头疼的编译错误。
1. 为什么需要预制第三方库
在Android开发中，我们经常会遇到以下几种需要预制第三方库的场景：
- 闭源SDK集成：许多商业SDK（如支付、地图、广告等）只提供预编译的.so或.a文件，不开放源代码
- 性能优化库：算法团队或硬件厂商提供的优化库，通常以二进制形式交付
- 遗留系统兼容：维护老旧系统时，某些库可能不再有源代码
- 构建时间优化：预编译库可以显著减少全量编译时间
与直接将.so文件拷贝到项目中的简单做法相比，使用Android.bp进行预制有几个显著优势：
- 构建系统感知：构建系统能正确跟踪依赖关系
- 多架构支持：可方便地管理32位和64位版本
- 版本控制：与项目代码一起纳入版本管理
- 安装路径规范：确保库文件被安装到正确位置
2. Android.bp基础：理解cc_prebuilt_library
Android.bp是Google推出的新一代构建系统配置文件，采用简洁的声明式语法。对于预编译库，主要使用以下两种模块类型：
cc_prebuilt_library_shared：用于预制的动态库（.so文件）cc_prebuilt_library_static：用于预制的静态库（.a文件）
下面是一个最基本的预制动态库配置示例：
cc_prebuilt_library_shared { name: "libexample", vendor: true, srcs: ["libs/armeabi-v7a/libexample.so"], strip: { none: true, }, compile_multilib: "32", }这个配置做了以下几件事：
- 定义了一个名为"libexample"的预编译动态库
- 指定了源文件路径
- 禁用了strip操作（保留调试符号）
- 声明这是一个32位库
3. 多架构支持：32位与64位配置实战
现代Android设备需要同时支持32位和64位架构，正确处理多架构是预制第三方库的关键。Android.bp提供了灵活的机制来管理不同架构的库文件。
3.1 文件目录结构
推荐的文件组织方式如下：
prebuilts/ └── vendor_lib/ ├── Android.bp └── libs/ ├── arm64-v8a/ │ └── libexample.so └── armeabi-v7a/ └── libexample.so3.2 多架构配置示例
cc_prebuilt_library_shared { name: "libexample", vendor: true, multilib: { lib32: { srcs: ["libs/armeabi-v7a/libexample.so"], }, lib64: { srcs: ["libs/arm64-v8a/libexample.so"], }, }, strip: { none: true, }, compile_multilib: "both", }关键参数说明：
| 参数 | 说明 | 常用值 |
|---|---|---|
multilib | 定义多架构支持 | lib32,lib64 |
compile_multilib | 控制构建哪些架构 | "32", "64", "both", "first" |
target | 指定目标设备类型 | android,host等 |
strip | 控制符号表处理 | none,all,keep_symbols |
4. 高级配置与最佳实践
4.1 版本化库支持
Android系统支持库的版本化，确保ABI兼容性。配置版本化库需要额外步骤：
cc_prebuilt_library_shared { name: "libexample", version_script: "libexample.map", srcs: ["libs/armeabi-v7a/libexample.so"], // 其他配置... }4.2 导出头文件
如果库需要配套的头文件，可以这样配置：
cc_prebuilt_library_shared { name: "libexample", srcs: ["libs/armeabi-v7a/libexample.so"], export_include_dirs: ["include"], // 其他配置... }4.3 依赖管理
预编译库也可以声明依赖关系：
cc_prebuilt_library_shared { name: "libclient", shared_libs: ["libservice"], // 其他配置... }5. 常见问题排查
在实际项目中，你可能会遇到以下典型问题：
库文件找不到：
- 检查
srcs路径是否正确 - 确认文件权限是否足够
- 检查
ABI不兼容：
adb shell getprop ro.product.cpu.abi确认设备ABI与库文件匹配
符号冲突：
- 使用
nm -D检查库的导出符号 - 考虑使用
version_script限制导出符号
- 使用
安装路径问题：
- vendor库默认安装到
/vendor/lib(64) - 使用
relative_install_path调整安装位置
- vendor库默认安装到
6. 完整示例：从零集成一个第三方库
让我们通过一个完整示例，将上述知识串联起来。假设我们要集成一个名为libfoo的第三方库，它提供了32位和64位版本。
准备文件结构：
vendor/foo/prebuilt/ ├── Android.bp └── libs/ ├── arm64-v8a/ │ ├── libfoo.so │ └── foo.h └── armeabi-v7a/ ├── libfoo.so └── foo.h编写Android.bp：
cc_prebuilt_library_shared { name: "libfoo", vendor: true, multilib: { lib32: { srcs: ["libs/armeabi-v7a/libfoo.so"], export_include_dirs: ["libs/armeabi-v7a"], }, lib64: { srcs: ["libs/arm64-v8a/libfoo.so"], export_include_dirs: ["libs/arm64-v8a"], }, }, strip: { none: true, }, compile_multilib: "both", shared_libs: [ "liblog", "libutils", ], }在应用中使用： 在需要使用该库的模块中，添加依赖：
cc_binary { name: "foo_client", shared_libs: ["libfoo"], // 其他配置... }编译验证：
m libfoo && m foo_client
在实际项目中集成预编译库时，最常遇到的坑是路径配置错误和ABI不匹配。建议每次修改配置后，先执行mma命令进行增量编译，快速验证配置是否正确。
