最近在学习OSG库的时候发现随便打开一个头文件,每个类的声明中类名之前都会插入一个宏定义OSG_EXPORT
class OSG_EXPORT MatrixTransform : public Transform
查看这个宏定义主要涉及到两个dll文件的关键字__declspec(dllexport)和__declspec(dllexport)
# if defined( OSG_LIBRARY_STATIC )
# define OSG_EXPORT
# elif defined( OSG_LIBRARY )
# define OSG_EXPORT __declspec(dllexport)
# else
# define OSG_EXPORT __declspec(dllimport)
# endif
一番查找资料后总结如下:
头文件的作用
- 首先要知道我们为什么要使用头文件?
- 头文件可以理解为是C++的接口文件，我们在编译这个工程的时候不仅需要它的cpp文件还需要头文件，并且在我们给其他工程链接完动态库后,要想使用动态库里方法时是通过提供此动态库的头文件的方式
#include 动态库的头文件.h - 因此头文件需要区分是给自己编译用还要给别人提供方法用
dllexport
- 字面意思暴露dll中的变量或方法
- 编译dll文件的时候,在dll头文件声明的变量名称前添加dllexport。表明这些东西可以被其他工程使用，即是把 dll中的相关代码(类，函数，全局变量)暴露出来为以后其他应用程序使用。
dllimport
- 字面意思插入dll中的变量或方法
- 是在其他工程需要使用dll内相关内容时使用的关键字。当其他工程要使用dll 内部代码(类，函数，全局变量)时，只需要在dll头文件中声明的变量名称前添加dllimport关键字即可,作用是把dll中的相关代码插入到应用程序中。
_declspec(dllexport)与_declspec(dllimport)是相互呼应，只有在dll内部用dllexport作了声明，才能在外部函数中用dllimport导入相关代码。
常用方法
- 因为同一个头文件里的变量需要两种不同的声明前缀,因此一般通过一个宏
DLL_BUILD来区分
#ifdef DLL_BUILD
#define DLL_EXPORT __declspec(dllexport)
#else
#define DLL_EXPORT __declspec(dllimport)
#endif
- 在生成dll工程中,工程属性下记得要设置预处理器定义
BUILD_DLL告诉编译器该接口需要暴露 - 在外部调用这个dll的工程中，包含这个头文件，此时
BUILD_DLL宏没有定义，所以用了dllimport这个关键字，是告诉编译器该接口是从外部导入的
插曲: 对于动态库本身必须使用关键字__declspec(dllexport),对于应用程序,不使用 __declspec(dllimport)也能正确编译代码，但使用 __declspec(dllimport) 使编译器可以生成更好的代码
回到开头OSG库的代码中
- OSG同时提供动态库和静态库, 且都使用一个头文件,静态库头文件中的声明是不需要任何前缀关键字,因此为了解决关键字的冲突使用了
OSG_LIBRARY_STATIC和OSG_LIBRARY来区分
# if defined( OSG_LIBRARY_STATIC )
# define OSG_EXPORT
# elif defined( OSG_LIBRARY )
# define OSG_EXPORT __declspec(dllexport)
# else
# define OSG_EXPORT __declspec(dllimport)
# endif
- 编译动态库时,头文件需要定义
OSG_LIBRARY宏 - 编译静态库时,头文件需要定义
OSG_LIBRARY_STATIC宏 - 其他程序使用库时,头文件不需要定义任何宏,只在遍历名称前加
OSG_EXPORT即可
