
我们平常在写代码的角料时候,特别是个跨在制造轮子的时候(为别人提供库文件),会遇到各种不同的平台需求场景:
有些人需要在 Linux 系统下使用,有些人需要在 Windows 系统下使用; 有些人使用 C 语言开发,文件有些人使用 C++ 来开发; 有些人使用动态库,语言边有些人使用静态库;特别是角料在 Windows 系统中,库文件中导出的个跨函数需要使用 _declspec(dllexport) 来声明函数,而使用者在导入的平台时候,需要使用 _declspec(dllimport) 来声明函数,文件甚是语言边麻烦!
这篇短文分享一个头文件,利用这个头文件,角料再加上几个编译期间传递的个跨宏,就可以完美的平台处理刚才所说的各种需求。
先直接上代码,可以先试着分析一下,后面我们再逐一分析不同的使用场景。
这个头文件的主要目的,就是IT技术网定义一个宏:MY_API,然后把这个宏添加在库文件中每一个需要导出的函数或者类的声明中即可。例如:
void MY_API do_work();假设需要写一个库文件,提供给别人使用。定义了上面这个头文件之后,其他的文件中都要include 这个头文件。
不同的平台预定义了相应的宏定义,例如:
Windows 平台:WIN32, _WIN32, WIN32; Linux 平台:linux, __linux, linux;在一个确定的平台上,这些宏不一定全部定义,很可能只有其中的某一个宏是被定义的。
为了统一性,我们在头文件的刚开始部分,把这些可能的宏统一起来,定义我们出我们自己的平台宏定义:MY_WIN32 或者是 MY_LINUX,后面需要区分不同的平台时,就用这个自己定义的云南idc服务商平台宏。
当然,还可以继续扩充出其他平台,例如:MY_MAC, MY_ARM 等等。
如果在写库代码的时候,使用的是 C++,而使用者使用的是 C 语言,那么就需要对库函数进行extern “C” 声明,让编译器不要对函数的名称进行改写。
编译器 g++ 预定义了宏 __cplusplus,因此,在头文件中,就利用了这个宏,在 MY_API 中添加 extern "C" 声明。
(1) 生成静态库
在静态库中,不需要 __declspec(dllexport/dllimport) 的声明,因此只需要区分编译器即可(gcc or g++),在编译选项中定义宏 MY_API_STATIC,即可得到最终的 MY_API 为:
gcc 编译器:#define MY_API g++ 编译器:#define MY_API extern "C"(2) 生成动态库
在编译选项中,定义宏 MY_API_EXPORTS,这样最终得到的 MY_API 就会变成:
gcc 编译器:#define MY_API __declspec(dllexport) g++ 编译器:#define MY_API extern "C" __declspec(dllexport)2. 使用库
在使用库的应用程序中,也需要在代码中 include 这个头文件,网站模板然后加上编译选项中定义的各种宏,来生成对应的 MY_API 宏定义。
(1) 使用静态库
需要在编译选项中定义 MY_API_STATIC,即可得到最终的 MY_API 为:
gcc 编译器:#define MY_API g++ 编译器:#define MY_API extern "C"(2) 使用动态库
在编译选项中不需要任何宏定义,即可得到最终的 MY_API 为:
gcc 编译器:#define MY_API extern "C" __declspec(dllimport) g++ 编译器:#define MY_API __declspec(dllimport)这样就相当于声明导入库函数了。
Linux 平台下就简单多了,只需要注意编译器的问题,而没有导出和导入之分。
