C 语言静态库的一些特性总结

一、静态库按 .o 为最小单位连接到程序，如果某个 .o 中的所有符号都没有被引入则这个 .o 不会被连接，反之 .o 中只要有一个符号被引入则链接整个 .o 。可以做一个例子来验证一下。

        构建一个静态库，包含两个 .c 文件，libtest.c 和 libtest2.c。libtest.c 中包含三个函数：lib_func1()、lib_func2()、lib_func3()。

#include <stdio.h>

void lib_func1 (void)
{
    printf("lib_func call1!\n");
}

void lib_func2 (void)
{
    printf("lib_func call2!\n");
}

void lib_func3 (void)
{
    printf("lib_func call3!\n");
}

        libtest2.c 中包含一个函数：lib_func4 ()

#include <stdio.h>

void lib_func4 (void)
{
    printf("lib_func call4!\n");
}

        APP 链接此静态库，定义与静态库重名的函数 lib_func2()，并在程序中调用 lib_func1() 和 lib_func1()。APP 程序如下：

#include <stdio.h>

void lib_func2 (void)
{
    printf("app: lib_func call2!\n");
}

extern void lib_func1(void);
extern void lib_func2(void);
extern void lib_func3(void);
extern void lib_func4(void);

int main (int argc, char **argv)
{
    lib_func1();
    lib_func4();

    return  (0);
}

        此时编译程序会报重复定义错误，因为程序中调用的 lib_func1() 与 lib_func4() 分别在 libtest.o 和 libtest2.o 中，因此链接时会包含这两个 .o。这就导致 libtest.o 中的符号 lib_func2() 被导入，并与 APP 中定义的 lib_func2() 重复，因此报重复定义错误。

         此时删除 APP 中调用 lib_func1() 的位置编译即可通过。因为 APP 中没有调用任何 libtest2.o 中的符号，因此链接时不会连接 libtest2.o，也就不会导入符号 lib_func2()，因此不会与 APP 中定义的 lib_func2() 冲突。

二、若在链接静态库时希望无论是否调用，均链接所有的 .o 可以使用链接参数 -Wl,--whole-archive 和 -Wl,--no-whole-archive（这是链接参数，gcc 不识别，需要通过 gcc 转到 ld，因此需要加 -Wl 前缀）。

-Wl,--whole-archive 此定义之后的静态库全部完整链接

-Wl,--no-whole-archive 取消静态库全部完整链接

使用：

LOCAL_DEPEND_LIB := \

-Wl,--whole-archive \

-l:lib2.a

-Wl,--no-whole-archive

三、如果静态库中某个 .o 的所有符号均在 APP 中定义，则不会链接此 .o。编译时也不会报重复定义错误。我们稍微修改一下上述的 APP，把 lib_test.o 中其他的两个函数 lib_func1() 和 lib_func3() 全部定义一遍，编译不报错。代码如下：

#include <stdio.h>

void lib_func1 (void)
{
    printf("app: lib_func call1!\n");
}

void lib_func2 (void)
{
    printf("app: lib_func call2!\n");
}

void lib_func3 (void)
{
    printf("app: lib_func call3!\n");
}

extern void lib_func1(void);
extern void lib_func2(void);
extern void lib_func3(void);
extern void lib_func4(void);

int main (int argc, char **argv)
{
    lib_func1();
    lib_func2();
    lib_func4();

    return  (0);
}

        运行结果表明 lib_func1() 与 lib_func2() 执行的确实是 APP 中定义的函数：