为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
文件生成。


猜你喜欢

转载自blog.csdn.net/ArtX/article/details/1750424