为Symbian编写动态链接库DLL

DLL（Dynamic Link Library）是一段特殊的代码，它能够被外部程序在程序
运行的时候调用。在DLL里面的代码可以同时被许多外部程序共享，而且不会引起
手机内存的重复分配。

静态接口vs多态接口
Symbian系统支持两种类型的DLL:
(1)静态接口DLL
(2)多态接口DLL

静态接口DLL在主调程序启动的时候被系统自动载入到手机内存里面（唯一的例外是
如果该DLL是在ROM只读存储器里面，那么可以直接通过它的地址进行调用）。并且
如果没有外部程序使用它了，它将被自动的从内存中卸载。静态接口DLL在系统内
提供了一系列唯一的函数（例如，两个具有相同导出函数的DLL在系统中也不会混淆）
静态接口DLL具有.dll文件后缀，通常用于在Symbian系统中实现应用程序引擎
（例如，与UI无关的代码）。

多态接口DLL只有明确的通过调用RLibrary::Load()函数才能被载入到内存中，而且
在卸载的时候，也最好通过RLibrary::Close()函数进行卸载。多个多态接口DLL可以
为外部程序导出多个相同的函数名的函数。所以，这种DLL通常情况下被广泛应用于
实现某个应用程序框架功能扩展时候的插件。在Symbian系统中，多态接口DLL可以有
多种不同的文件后缀。其中最著名的一个就是.app结尾的（应用程序），.ldd（逻辑
设备驱动），.tsy和.csy（电话和通信服务模块）等等。。。

在本文中，我们将只关注静态接口DLL技术，它是你我在开发中最最常用的DLL类型。
我们将以通用DLL的继续我们的内容。

静态接口的DLL
从DLL调用者的角度来看，DLL有三个文件组成：
（1）头文件：.h的文件后缀，可以#include到主调程序的代码中去，只有在编译
的时候有用。
（2）导出文件：.lib的文件后缀，可以由主调程序进行链接，这个文件记载了DLL的
提供的所有接口函数名称和地址。
（3）DLL文件本身：.dll的文件后缀包括所有.lib文件记载的接口函数的具体实现，
主调函数在运行的时候实际调用和执行的部分。

从DLL编写者的角度来看，DLL可以被看成是一个完整的Symbian项目。
它由以下几部分组成：
（1）项目自己的MMP文件（在bld.inf文件中列出的）
（2）一个头文件，指定了该DLL需要导出的接口
（3）源代码文件，具体导出函数的实现

头文件
DLL的头文件与其它类的头文件的头文件非常类似。不同的地方在于
使用了IMPORT_C宏来定义所有导出函数：
class CMyEngine : public CBase
{
public:
   // These functions are visible by the
   // clients of the DLL and needs to have
   // the IMPORT_C tag
   IMPORT_C static CMyEngine* NewL();
   IMPORT_C static CMyEngine* NewLC();

   IMPORT_C void MyPublicMethod();
   IMPORT_C void AnotherPublicMethod();
   ...
private:
   // These functions are not visible by the
   // clients of the DLL and then do not need
   // the IMPORT_C tag
   CMyEngine();
   void ConstructL();
   void SomePrivateMethod();
}

实现文件
编写DLL工作本身没有什么需要复杂的地方，但是有两个重要的
地方需要留意：
（1）E32Dll()函数必须实现
（2）另外一个特殊的宏，EXPORT_C，应该加在每个导出函数实现
的前面。
例如：
// This function is mandatory for all DLLs
EXPORT_C TInt E32Dll(TDllReason)
{
        return KErrNone;
}

// This function is exported: The EXPORT_C tag shall be used.
EXPORT_C void MyPublicMethod()
{
   ...
}

// This one is not: The EXPORT_C tag shall not be used.
void SomePrivateMethod()
{
  // Do Something
}

MMP文件
DLL的MMP文件应该有以下特点
（1）定义项目(project)的类型是dll
（2）使用正确的UID2的值(0x1000008d)

在开发过程中，你也应该通过EXPORTUNFROZEN告诉编译环境，DLL接口还没有
定稿，还可以随时修改。

例如：
TARGET        MyEngine.dll
TARGETTYPE    dll
UID           0x1000008d
...
EXPORTUNFROZEN

把DLL接口定稿（Freezing DLL）
一旦你完成了DLL的开发，在你发行你的DLL版本之前，应该把接口定稿（Freezing）
这样可以确定将来发行的DLL可以向下兼容。

通过将项目的MMP文件中的EXPORTUNFROZEN关键字去掉，用常规的方法重新建立DLL，
来实现DLL库的定稿。这时候会有“.def文件不存在”的编译警告信息出现，不要紧，
继续就建立当前项目，在项目编译完毕以后，你可以用如下命令定稿：
abld freeze

注意:
所有的ARM平台共享一个.def文件，但是对于wins模拟器和winscw CodeWarrior
环境来说，他们有不同的.def文件。

一旦项目已经定稿，重新生成makefile，这时候导入的lib会直接通过定稿的.def
文件生成。