第1章 链接选项与脚本：target_link_options()、链接器脚本、LINKER:前缀、版本脚本控制符号导出

各位同学，今天我们来聊聊链接选项和脚本。说实话，很多做NDK开发的朋友，对编译阶段很熟悉，但一到链接阶段就有点发怵。我刚开始做底层开发时也是这样，总觉得链接是"玄学"——明明编译过了，链接却报一堆莫名其妙的错误。后来踩的坑多了，才慢慢摸清门道。

链接器，说白了就是把你的目标文件(.o)和库文件(.a/.so)粘在一起，生成最终的可执行文件或共享库。但怎么粘、粘哪些、哪些符号要暴露出去，这些都需要我们通过链接选项和脚本来控制。

1.1 target_link_options()：CMake中的链接控制利器

在CMake里，我们最常用的就是target_link_options()这个命令。它专门用来给某个目标（比如你的native库）添加链接器选项。

基本语法很简单：

target_link_options(<target> [BEFORE|AFTER]
                    <INTERFACE|PUBLIC|PRIVATE>
                    [items1...])

这里的关键是作用域：

  • PRIVATE：只影响当前目标，不传递给依赖它的目标
  • PUBLIC：既影响当前目标，也传递给依赖者
  • INTERFACE：只传递给依赖者，不影响当前目标

我个人习惯：链接选项一般用PRIVATE就够了。除非你明确知道某个选项需要被依赖方继承，否则别乱用PUBLIC，容易造成链接选项污染。

举个例子，假设我们要给一个native库添加链接器脚本：

add_library(mylib SHARED src/main.cpp)
target_link_options(mylib PRIVATE -Wl,--version-script=${CMAKE_CURRENT_SOURCE_DIR}/mylib.map)

这里-Wl,是GCC/Clang的语法，表示把后面的参数传递给链接器。嗯，这里要注意，不同编译器对-Wl的支持程度不一样，但Android NDK用的Clang是支持的。

1.2 LINKER:前缀：更清晰的CMake语法

CMake 3.13之后引入了一个好东西——LINKER:前缀。它让链接选项的写法更直观，不用再写-Wl,了。

对比一下：

传统写法 LINKER:写法
-Wl,--gc-sections LINKER:--gc-sections
-Wl,--version-script=file.map LINKER:--version-script,file.map
-Wl,-z,defs LINKER:-z,defs

用LINKER:前缀时，多个参数用逗号分隔，而不是空格。我个人觉得这种写法更清晰，一眼就能看出哪些是传给链接器的。

target_link_options(mylib PRIVATE 
    LINKER:--gc-sections
    LINKER:--version-script,${CMAKE_CURRENT_SOURCE_DIR}/mylib.map
)

小提示：如果你的CMake版本支持（3.13+），建议优先使用LINKER:前缀。代码可读性更好，也更容易维护。

1.3 链接器脚本：控制内存布局的终极武器

链接器脚本（Linker Script）是啥？说白了，就是告诉链接器：你的代码段放哪里、数据段放哪里、栈放哪里。在Android NDK开发中，我们一般用不到太复杂的链接器脚本，但有些场景必须用。

比如，你要把某个关键函数放在固定的内存地址上，或者要控制BSS段的大小。这时候就需要写一个.ld文件。

一个简单的链接器脚本示例：

SECTIONS
{
    . = 0x10000;
    .text : { *(.text) }
    . = 0x20000;
    .data : { *(.data) }
    .bss : { *(.bss) }
}

这个脚本把代码段放在0x10000，数据段放在0x20000。当然，实际项目中很少这么干，除非你在做裸机开发或者特殊的内存映射需求。

警告：链接器脚本写错了，程序大概率跑不起来。我曾经在一个项目中，因为链接器脚本里的对齐方式写错了，导致某个结构体在内存中对齐不对，查了整整两天才找到原因。所以，非必要不写链接器脚本，写了就要仔细检查。

在CMake中使用链接器脚本：

target_link_options(mylib PRIVATE 
    LINKER:--script,${CMAKE_CURRENT_SOURCE_DIR}/mylib.ld
)

1.4 版本脚本：控制符号导出的艺术

做Android NDK开发，我们经常要编译.so文件。但.so文件里的符号，不是所有都要暴露出去的。有些是内部实现细节，暴露出去反而容易造成符号冲突。

版本脚本（Version Script）就是用来控制符号导出的。它用.map文件定义哪些符号是公开的，哪些是隐藏的。

一个典型的版本脚本：

{
    global:
        my_public_function;
        my_public_class::*;
    local:
        *;
};

这个脚本的意思是：只导出my_public_function和my_public_class的所有成员，其他符号全部隐藏。

在CMake中集成：

target_link_options(mylib PRIVATE 
    LINKER:--version-script,${CMAKE_CURRENT_SOURCE_DIR}/mylib.map
)

避坑指南：我曾经在一个项目中，没有用版本脚本，结果.so文件导出了几百个内部符号。后来另一个模块链接这个.so时，符号冲突了，链接报错。从那以后，我每个.so都会配一个版本脚本，只导出必要的API。

为什么版本脚本这么重要？你想想看：

  • 减少符号冲突：不同.so之间不会因为内部符号同名而打架
  • 减小.so体积：不导出的符号可以被链接器优化掉
  • 提高安全性：外部无法直接调用你的内部函数
  • ABI稳定性：只暴露稳定接口，内部实现随便改

1.5 知识体系总览

下面这张图，我把本章的核心知识点串起来了。你可以看到，从CMake命令到链接器底层，每个环节都有对应的控制手段。

链接选项与脚本知识体系 target_link_options() 传统 -Wl, 写法 LINKER: 前缀写法 直接链接器脚本 链接器脚本(.ld) 控制内存布局 段地址、对齐方式 版本脚本(.map) 控制符号导出 global/local声明 其他链接选项 --gc-sections -z defs 等 最终产物：.so / .a / 可执行文件

从这张图可以看出，target_link_options()是CMake层面的入口，它支持三种传参方式。最终这些参数都会传递给底层的链接器，控制链接行为。而链接器脚本和版本脚本，则是更精细的控制手段。

1.6 实战建议

说了这么多，我给大家总结几条实战建议：

  1. 优先用LINKER:前缀：如果你的CMake版本够新，别再用-Wl,了，代码更干净。
  2. 每个.so都要配版本脚本：这是控制ABI的底线。别偷懒，哪怕只导出一个函数，也要写.map文件。
  3. 链接器脚本慎用：除非你有特殊的内存布局需求，否则别碰。Android系统已经帮你安排好了。
  4. 作用域用PRIVATE：链接选项一般不需要传递，PRIVATE就够了。

最后一个小技巧：调试链接问题时，可以在CMake里加一句set(CMAKE_VERBOSE_MAKEFILE ON)，这样编译和链接的完整命令都会打印出来。看到实际的链接命令，问题往往就一目了然了。

好了，这一章的内容就到这里。链接选项和脚本这块，说白了就是"怎么告诉链接器按你的意思干活"。多写几次，多踩几个坑，自然就熟练了。

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

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