详解Cocos2d-X中宏CC_DLL

在cocos2d-x的源码中，常常能够看到宏CC_DLL的使用，好比在类CCScene的定义中：

class CC_DLL CCScene : public CCNode
{
public:
        CCScene();
        virtual ~CCScene();
        bool init();

        static CCScene *create(void);
};

在cocos2d-x中，根据不一样的平台，宏CC_DLL的定义是不一样的，在iOS/Android/Blackberry/Mac平台上，CC_DLL表明“空”：

#define CC_DLL

在win32平台上，CC_DLL的定义为：

#if defined(_USRDLL)
    #define CC_DLL     __declspec(dllexport)
#else         /* use a DLL library */
    #define CC_DLL     __declspec(dllimport)
#endif

在linux平台上，CC_DLL的定义为：

#if defined(_USRDLL)
#define CC_DLL __attribute__ ((visibility ("default")))
#else         /* use a DLL library */
#define CC_DLL __attribute__ ((visibility ("default")))
#endif

对于win32，须要明白__declspec(dllexport)和__declspec(dllimport)的功能。

__declspec(dllexport)

声明一个导出函数，是说这个函数要从本DLL导出。我要给别人用。通常用于dll中省掉在DEF文件中手工定义导出哪些函数的一个方法。固然，若是你的DLL里全是C++的类的话，你没法在DEF里指定导出的函数，只能用__declspec(dllexport)导出类。

//SimpleDLLClass.h

#ifdef SIMPLEDLL_EXPORT
#define DLL_EXPORT __declspec(dllexport)
#else
#define DLL_EXPORT
#endif

class DLL_EXPORT SimpleDLLClass
{
public: 
    SimpleDLLClass(); 
    virtual ~SimpleDLLClass(); 
    virtual getValue() { return m_nValue;};
private: 
    int m_nValue;
};

//SimpleDLLClass.cpp

#include "SimpleDLLClass.h"

SimpleDLLClass::SimpleDLLClass()
{ 
    m_nValue=0;
}

SimpleDLLClass::~SimpleDLLClass()
{
}

对于上述代码，若是定义了SIMPLEDLL_EXPORT，那上述代码会被编译生成dll文件，此dll文件会向其余程序模块提供类SimpleDLLClass的函数和变量调用。

 

__declspec(dllimport)

声明一个导入函数，是说这个函数是从别的DLL导入。我要用。通常用于使用某个dll的exe中 。

不使用 __declspec(dllimport) 也能正确编译代码，但使用 __declspec(dllimport) 使编译器能够生成更好的代码。编译器之因此可以生成更好的代码，是由于它能够肯定函数是否存在于 DLL 中，这使得编译器能够生成跳过间接寻址级别的代码，而这些代码一般会出如今跨 DLL 边界的函数调用中。可是，必须使用 __declspec(dllimport) 才能导入 DLL 中使用的变量。

在Windows DLL编程时，可以使用__declspec(dllimport)关键字导入函数或者变量。

函数的导入

    当你须要使用DLL中的函数时，每每不须要显示地导入函数，编译器可自动完成。但若是你显示地导入函数，编译器会产生质量更好的代码。因为编译器确切地知道了一个函数是否在一个DLL中，它就能够产生更好的代码，再也不须要间接的调用转接。

 

    Win32的PE格式（Portable Executable Format）把全部导入地址放在一个导入地址表中。下面用一个具体实例说明使用__declspec(dllimport)导入函数和不使用的区别：

 

    假设func是一个DLL中的函数，如今在要生成的.exe的main函数中调用func函数，而且不显示地导入func函数（即没有：__declspec(dllimport)），代码示例以下：

int main()
{
    func();
}

编译器将产生相似这样的调用代码：

call func

而后，连接器把该调用翻译为相似这样的代码：

call 0x40000001; //0x40000001是func的地址

而且，连接器将产生一个Thunk，形如：

0x40000001: jmp DWORD PTR __imp_func

这里的imp_func是func函数在.exe的导入地址表中的函数槽的地址。而后，加载器只须要在加载时更新.exe的导入地址表便可。

 

    而若是使用了__declspec(dllimport)显示地导入函数，那么连接器就不会产生Thunk（若是不被要求的话），而直接产生一个间接调用。所以，下面的代码：

__declspec(dllimport) void func1(void);

void main(void) 
{
    func1();
}

将调用以下调用指令：

call DWORD PTR __imp_func1

所以，显示地导入函数能有效减小目标代码（由于不产生Thunk）。另外，在DLL中使用DLL外的函数也能够这样作，从而提升空间和时间效率。

变量的导入

    与函数不一样的是，在使用DLL中的变量时，须要显示地导入变量。使用__declspec(dllimport)关键字导入变量。若在DLL中使用.def导出变量，则应使用DATA修饰变量，而不是使用已经被遗弃的CONSTANT。由于CONSTANT可能须要使用指针间接访问变量，不肯定何时会出问题。

 我相信写WIN32程序的人，作过DLL，都会很清楚__declspec(dllexport)的做用，它就是为了省掉在DEF文件中手工定义导出哪些 函数的一个方法。固然，若是你的DLL里全是C++的类的话，你没法在DEF里指定导出的函数，只能用__declspec(dllexport)导出 类。可是，MSDN文档里面，对于__declspec(dllimport)的说明让人感受有点奇怪，先来看看MSDN里面是怎么说的： 

不使用 __declspec(dllimport) 也能正确编译代码，但使用 __declspec(dllimport) 使编译器能够生成更好的代码。编译器之因此可以生成更好的代码，是由于它能够肯定函数是否存在于 DLL 中，这使得编译器能够生成跳过间接寻址级别的代码，而这些代码一般会出如今跨 DLL 边界的函数调用中。可是，必须使用 __declspec(dllimport) 才能导入 DLL 中使用的变量。

初看起来，这段话前面的意思是，不用它也能够正常使用DLL的导出库，但最后一句话又说，必须使用 __declspec(dllimport) 才能导入 DLL 中使用的变量这个是什么意思？？

那我就来试验一下，假定，你在DLL里只导出一个简单的类，咱们在下面的代码中导入使用这个DLL中的类，注意，我假定你已经在项目属性中定义了 SIMPLEDLL_EXPORT。

//SimpleDLLClass.h

#ifdef SIMPLEDLL_EXPORT
#define DLL_EXPORT __declspec(dllexport)
#else
#define DLL_EXPORT
#endif

class DLL_EXPORT SimpleDLLClass
{
public: 
    SimpleDLLClass(); 
    virtual ~SimpleDLLClass(); 
    virtual getValue() { return m_nValue;};
private: 
    int m_nValue;
};

//SimpleDLLClass.cpp

#include "SimpleDLLClass.h"

SimpleDLLClass::SimpleDLLClass()
{ 
    m_nValue=0;
}

SimpleDLLClass::~SimpleDLLClass()
{
}

而后你再使用这个DLL类，在你的APP中include SimpleDLLClass.h时，你的APP的项目不用定义 SIMPLEDLL_EXPORT 因此，DLL_EXPORT 就不会存在了，这个时候，你在APP中，不会遇到问题。这正好对应MSDN上说的__declspec(dllimport)定义与否均可以正常使用。但咱们也没有遇到变量不能正常使用呀。 那好，咱们改一下SimpleDLLClass,把它的m_nValue改为static,而后在cpp文件中加一行int SimpleDLLClass::m_nValue=0;若是你不知道为何要加这一行，那就回去看看C++的基础。

改完以后，再去LINK一下，你的APP，看结果如何， 结果是LINK告诉你找不到这个m_nValue。明明已经定义了，为何又没有了？？ 确定是由于我把m_nValue定义为static的缘由。但若是我必定要使用Singleton的Design Pattern的话，那这个类确定是要有一个静态成员，每次LINK都没有，那不是完了？ 若是你有Platform SDK，用里面的Depend程序看一下，DLL中又的确是有这个m_nValue导出的呀。

再回去看看我引用MSDN的那段话的最后一句。 那咱们再改一下SimpleDLLClass.h，把那段改为下面的样子:

#ifdef SIMPLEDLL_EXPORT
#define DLL_EXPORT __declspec(dllexport)
#else
#define DLL_EXPORT __declspec(dllimport)
#endif

再LINK，一切正常。原来dllimport是为了更好的处理类中的静态成员变量的，若是没有静态成员变量，那么这个__declspec(dllimport)无所谓。

 关于__declspec(dllexport)和__declspec(dllimport)的使用，参考了这篇博文：http://www.cnblogs.com/xd502djj/archive/2010/09/21/1832493.html

 关于linux平台上的CC_DLL解释有待下次添加。