最近在学习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即可