分享

在Symbian开发环境下如何编写静态接口DLL(动态链接库)

 夜海星空 2010-04-27
Symbian 的DLL分为两种,一种是静态接口DLL(static interface dll),一种是多态接口DLL(polymorphic interface dll)。
(一)静态接口DLL(static interface dll):
静态接口DLL一般使用DLL结尾,提供固定的API,给其他程序调用。静态接口DLL在主调程序启动的时候被系统自动载入到手机内存里面(唯一的例外是如果该DLL是在ROM只读存储器里面,那么可以直接通过它的地址进行调用)。并且如果没有外部程序使用它了,它将被自动的从内存中卸载。
在Symbian OS编写dll时,要注意的问题是,不能有全局或静态变量存在,这个一定要注意,在SDK中讲得很清楚。
Symbian OS是基于ROM来处理程序的。DLL是通常是存储在ROM中的(运行也是在ROM中),所以它是不可写的。虽然有时把DLL装入RAM中运行,但 Symbian OS仍旧假定DLL不可写。因此Symbian OS中的DLL没有数据段(Data Segment ),这就导致了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 visibleby the
  // clients of the DLL andneeds to have
  // the IMPORT_C tag
  IMPORT_C static CMyEngine*NewL();
  IMPORT_C static CMyEngine*NewLC();

  IMPORT_C voidMyPublicMethod();
  IMPORT_C voidAnotherPublicMethod();
  ...
private:
  // These functions are notvisible by the
  // clients of the DLL and thendo not need
  // the IMPORT_C tag
  CMyEngine();
  void ConstructL();
  voidSomePrivateMethod();
}

实现文件
编写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 beused.
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模拟器和winscwCodeWarrior环境来说,他们有不同的.def文件。一旦项目已经定稿,重新生成makefile,这时候导入的lib会直接通过定稿的.def,文件生成。

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

    本站是提供个人知识管理的网络存储空间,所有内容均由用户发布,不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息,谨防诈骗。如发现有害或侵权内容,请点击一键举报。
    转藏 分享 献花(0

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多