Android Soong编译中链接共享库时无法解析静态函数符号

问题根源 #

你遇到的核心问题在于静态函数的链接特性：C++里static修饰的函数默认是内部链接属性，作用域仅限定义它的编译单元——哪怕放在不同命名空间下，编译器也不会把这些符号导出到共享库的动态符号表中。所以虽然sample1.so的objdump能看到这些符号，但它们是局部符号（通常标记为l），根本没法被其他共享库的链接器解析。

正确解决方案 #

要让这些日志函数能被其他共享库调用，得把静态函数改成外部链接，同时保留命名空间来区分不同签名的函数，具体步骤如下：

1. 修改sample1的函数定义，移除static修饰 #

把原来静态函数里的static关键字删掉，改成全局可见的函数，命名空间保留：

// sample1.h
namespace ns1 {
void log_func(const char* msg); // 无额外参数
}

namespace ns2 {
void log_func(const char* msg, int level); // 带一个int参数
}

namespace ns3 {
void log_func(const char* msg, int level, const char* tag); // 三个参数
}

// 宏定义保持原样即可，比如：
#define LOG_NS1(msg) ns1::log_func(msg)
#define LOG_NS2(msg, level) ns2::log_func(msg, level)
#define LOG_NS3(msg, level, tag) ns3::log_func(msg, level, tag)

2. 配置sample1的Android.bp确保符号导出 #

不需要额外花里胡哨的配置，只要正确编译成共享库并导出头文件就行：

cc_library_shared {
    name: "sample1",
    srcs: ["sample1.cpp"],
    export_include_dirs: ["."], // 让其他库能自动找到头文件
    visibility: ["//visibility:public"], // 允许其他模块引用这个库
}

3. 检查其他库的依赖配置 #

在sample2、sample3、sample4的Android.bp里，确保正确依赖sample1：

cc_library_shared {
    name: "sample2",
    srcs: ["sample2.cpp"],
    shared_libs: ["sample1"],
    // 因为sample1已经export_include_dirs，这里可以不用写include_dirs
}

为什么之前的操作没用？ #

• allow_undefined_symbols只是跳过了链接检查，运行时大概率会出现符号找不到的崩溃，绝对不推荐用。
• export_shared_lib_headers只是导出头文件，解决不了静态函数的链接属性问题。
• 静态函数的局部特性决定了它没法跨编译单元/共享库被引用，哪怕套了不同命名空间也不行。

替代方案（必须保留static的情况） #

如果因为某些限制必须保留静态函数的定义，可以把宏的实现改成在每个使用的库中实例化静态函数，不用依赖sample1.so里的定义。比如把头文件改成：

// sample1.h
namespace ns1 {
static inline void log_func(const char* msg) {
    // 直接在这里写日志逻辑，比如调用__android_log_print
    __android_log_print(ANDROID_LOG_INFO, "NS1", "%s", msg);
}
}

#define LOG_NS1(msg) ns1::log_func(msg)

这样每个包含该头文件的库都会在自己的编译单元里生成静态函数的副本，彻底避开跨库链接的问题。不过这种方式会导致代码冗余，只适合逻辑简单的函数。

内容的提问来源于stack exchange，提问作者Shailaja