编写动态链接库给别人用的时候,在Mac ,Linux 以及 windows 上的处理策略是不同的。其实就是 gcc(clang) 与 vs 的差别。一般大家都会用一段宏定义来解决这种跨平台的问题。废话不多说,直接上代码:
#ifndef CROSS_PLATFORM_LIBRARY_EXAMPLE_LIBRARY_H
#define CROSS_PLATFORM_LIBRARY_EXAMPLE_LIBRARY_H
#ifdef _MSC_VER //用于判断是否是 vs 平台
#define CROSS_PLATFORM_HIDDEN_API
#ifdef CROSS_PLATFORM_LIBRARY_EXPORTS
#define CROSS_PLATFORM_API __declspec(dllexport)
#else
#define CROSS_PLATFORM_API __declspec(dllimport)
#endif
#else // 说明是 OSX 或者 Linux
#define CROSS_PLATFORM_API __attribute((visibility("default"))) // 明确指示,这个函数在动态库中可见
#define CROSS_PLATFORM_HIDDEN_API __attribute((visibility("hidden"))) // 明确指示,这个函数在动态库中不可见
#endif
// 不加 CROSS_PLATFORM_API 的情况
// 在 gcc/clang 编译的情形下也会被导出并且可以被调用
// 在 vs 编译的情况下无法被调用
void name();
// 公开的 API,动态库可以被外部所调用
CROSS_PLATFORM_API void hello();
// 我是你看得到,调用不了的函数
CROSS_PLATFORM_HIDDEN_API void cantHello();
#endif // CROSS_PLATFORM_HIDDEN_API
#endif //CROSS_PLATFORM_LIBRARY_EXAMPLE_LIBRARY_H
如上这段代码包含三个函数 name, hello, cantHello。在vs和gcc下生成的动态库,hello都是可以调用的,cantHello则是不可调用的。而 name 函数则不同,在gcc下可以被调用,在vs下不可以被调用。应该是两个平台采用了不同的处理策略,gcc是你不说不能被调用,那就都可以被调用,而 vs则是你不说能被调用,那么就全部不让调用,两者采用了完全相反的处理思路,因此在编写sdk的时候,要在头文件函数的声明处显示的定义到底能不能被调用。
而且两个编译器对动态库的导出的函数的可见性也是不同的,在gcc(clang)下导出的动态链接库你用 nm 命令查看里面的函数,你可以发现里面所有的函数名,虽然 cantHello 你是无法调用的。而在windows下,你用 dumpbin -exports 查看 dll 的信息,就只能看到hello 这个函数的信息,另外两个信息是完全隐藏的。
接下来,讲解一下代码的核心,就是这段宏定义, 其实没啥好讲的,感觉直接记死了比较重要。至于 __declspec(dllimport) 与 __declspec(dllexport) 的区别可以查看博客 https://blog.csdn.net/magictong/article/details/6758644
#ifdef _MSC_VER //用于判断是否是 vs 平台
#define CROSS_PLATFORM_HIDDEN_API // 这行其实就是充数的,在vs中放到那里啥用没有,但是有了这个定义就可以和 gcc下的代码保持同步
#ifdef CROSS_PLATFORM_LIBRARY_EXPORTS
#define CROSS_PLATFORM_API __declspec(dllexport)
#else
#define CROSS_PLATFORM_API __declspec(dllimport)
#endif
#else // 说明是 gcc 或者 clang
#define CROSS_PLATFORM_API __attribute((visibility("default"))) // 明确指示,这个函数在动态库中可见
#define CROSS_PLATFORM_HIDDEN_API __attribute((visibility("hidden"))) // 明确指示,这个函数在动态库中不可见
#endif