第1章 预编译库集成：静态库与动态库的抉择

各位同学，今天我们来聊聊NDK开发中一个绕不开的话题——预编译库的集成。说白了，就是别人已经编译好的.a和.so文件，你怎么把它用到自己的项目里。

我记得刚入行那会儿，第一次接手一个集成第三方SDK的项目，打开工程一看，一堆.a和.so文件躺在那里。我当时就懵了——这俩到底啥区别？该用哪个？怎么链接？后来踩了不少坑，才慢慢摸清楚门道。

静态库(.a)与动态库(.so)的本质区别

先说说最基础的概念。静态库和动态库，说白了就是两种不同的代码打包方式。

对比维度 静态库(.a) 动态库(.so)
链接时机 编译时直接嵌入可执行文件 运行时由系统加载
最终产物大小 APK体积增大（代码被复制） APK体积较小（共享代码）
更新方式 需重新编译整个应用 可单独替换.so文件
加载速度 快（已包含在可执行文件中） 稍慢（需运行时加载）
内存占用 每个进程一份拷贝 多进程可共享同一份

我在项目中遇到过这样一个场景：一个图像处理算法库，提供了.a和.so两种格式。当时团队里有人图省事直接用了.a，结果APK体积暴涨了30MB。后来换成.so，不仅体积小了，而且后续算法升级只需要替换一个文件，方便多了。

核心结论：如果你的库会被多个应用或进程共享，或者需要频繁更新，选动态库。如果追求极致性能、不想操心运行时加载问题，选静态库。

add_library()导入预编译库

好，理论说完了，咱们直接上代码。在CMake中导入预编译库，用的是add_library()命令，配合IMPORTED属性。

你想想看，普通的add_library()是告诉CMake「我要编译一个库」，而加上IMPORTED之后，意思是「这个库已经存在了，你只需要知道它的位置就行」。

# 导入静态库
add_library(my_static_lib STATIC IMPORTED)
set_target_properties(my_static_lib PROPERTIES
    IMPORTED_LOCATION ${CMAKE_SOURCE_DIR}/libs/${ANDROID_ABI}/libmy_static.a
)

# 导入动态库
add_library(my_shared_lib SHARED IMPORTED)
set_target_properties(my_shared_lib PROPERTIES
    IMPORTED_LOCATION ${CMAKE_SOURCE_DIR}/libs/${ANDROID_ABI}/libmy_shared.so
)

这里有个细节要注意：IMPORTED_LOCATION指向的是库文件的实际路径。我习惯把不同ABI的库放在对应的目录下，比如libs/arm64-v8a/、libs/armeabi-v7a/，然后用${ANDROID_ABI}变量动态选择。

小技巧：如果你有多个ABI架构的库，建议用IMPORTED_LOCATION_<CONFIG>或者直接遍历ABI列表设置属性，避免写死路径。

IMPORTED属性的深层含义

为什么非要加这个IMPORTED？嗯，这里要注意——不加的话，CMake会以为你要从源码编译这个库，然后去找.c或.cpp文件，找不到就报错。

IMPORTED属性告诉CMake三件事：

  • 这个库是外部提供的，不需要编译
  • 它的位置、依赖、头文件路径等信息通过属性指定
  • 链接时直接使用这个预编译好的文件

我曾经犯过一个低级错误：导入动态库时忘了加IMPORTED，结果CMake一直报找不到源文件。折腾了半小时才发现是少写了这个关键字。所以各位同学，写代码时眼睛睁大点。

链接预编译库到目标

库导入完了，怎么用？用target_link_libraries()把它链接到你的Native代码上。

# 假设你要编译一个叫native-lib的库
add_library(native-lib SHARED
    src/main/cpp/native-lib.cpp
)

# 链接预编译的静态库
target_link_libraries(native-lib
    my_static_lib
    log  # Android的log库
)

# 或者链接动态库
target_link_libraries(native-lib
    my_shared_lib
    log
)

这里有个容易混淆的点：静态库和动态库在链接时的行为不一样。静态库会把代码直接复制到native-lib.so里，而动态库只是在生成的可执行文件里记录一个依赖关系，运行时由系统加载。

避坑指南：我曾经在链接动态库时忘了把.so文件打包进APK，结果运行时直接崩溃，报UnsatisfiedLinkError。记住，动态库不仅要链接，还要确保它存在于APK的lib/目录下。

实战中的选择策略

说了这么多，到底什么时候用静态库，什么时候用动态库？我总结了几条经验：

  1. 第三方SDK：大部分商业SDK提供的是.so，因为方便升级。比如支付SDK、推送SDK，跟着它们的版本走就行。
  2. 自己的公共模块：如果多个App共享，用.so。如果只是单个App内部用，.a更省心。
  3. 性能敏感场景：比如游戏引擎、音视频编解码，用.a可以减少运行时开销。
  4. 体积敏感场景：比如安装包不能超过50MB，优先考虑.so。

我个人习惯是：能动态就动态，除非有明确的性能要求。因为动态库的灵活性实在太香了——热修复、模块化、按需下载，这些玩法都离不开.so。

知识体系总览

下面这张图帮你理清预编译库集成的完整流程：

预编译库集成知识体系 静态库 (.a) 动态库 (.so) add_library(... STATIC IMPORTED) add_library(... SHARED IMPORTED) IMPORTED_LOCATION → 指定库文件路径 IMPORTED_LOCATION → 指定库文件路径 target_link_libraries(native-lib my_library log) 核心流程：选择库类型 → 导入声明 → 设置路径 → 链接到目标

这张图把整个流程串起来了。从选择静态库还是动态库开始，到用add_library()导入，再到设置IMPORTED_LOCATION属性，最后用target_link_libraries()链接。每一步都有它的道理，缺一不可。

本章核心要点：

  • 静态库编译时嵌入，动态库运行时加载
  • 导入预编译库必须加IMPORTED属性
  • IMPORTED_LOCATION指定库的实际路径
  • 链接时静态库复制代码，动态库记录依赖
  • 动态库需要打包进APK才能正常运行

好了，预编译库集成的基础知识就讲到这里。这些内容看起来简单，但实际项目中稍不注意就会踩坑。下一章我们会深入探讨头文件搜索路径和依赖管理，到时候再聊。

公众号:蓝海资料掘金营，微信deep3321

← 上一章 📖 返回目录 下一章 →