技术开发 频道

如何为Symbian编写动态链接库DLL

  【IT168 技术】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

  文件生成。

0
相关文章