2004-10-9 18:20
symbian
Developer's Guide<br /><br /><br />Hands On<br /><br /><br />Development basics<br /><br /><br /> 为任何一种基于Symbian OS的电话编程都需要遵循一种标准的模式。<br /> <br /> Symbian OS软件开发是在基于PC/Windows平台的模拟器上面进行的。对于6.0,6.1版本来说,编辑/编译/创建的循环是基于MS的VC6.0开发环境。然而,开发者并不会链接Win32/MFC库,而是链接SDK提供的Symbian的头文件和库。二进制结果文件直接运行在相应版本的模拟器上面。<br /><br /> SDK提供的工具可以让这些过程变得简单。Symbian开发环境的mmp工程文件可以用来生成VC工具集的工程文件和GCC的工程文件,这样在开发中,可以用VC类型的工程文件来管理所有的链接和创建细节。这样也确保了创建产生的输出以及任何所需要的资源文件(图标,位图,声音文件等等),可以创建在正确的位置,以便模拟器可以调用它们。<br /><br /> 更喜欢命令行的开发者的开发流程会有一些区别。他们的开发流程基本上和用Makefile来控制编译链接步骤差不多。<br /><br />--------------------------------------------------------------------------------<br /><br /><br /><br />Reference hardware<br /><br /><br /> 对大部分的开发者来说参考硬件是来自Symbian授权的真电话,或者是购买来的电话。然而,开发循环中的硬件部分实际上是和真实硬件独立的。真实硬件的主要是测试和校验环境,在开发的大部分层次里面,大部分时间里,他是不必需的。<br /><br /> 事实上,模拟器的基本处理流程和真实电话上面的真实应用精确的相似。<br /><br />--------------------------------------------------------------------------------<br /><br /><br /><br />Issues to be aware of<br /><br /> 创建程序的时候可以指定是否打开调试信息。<br /> <br /> 如果需要调试,那么对于6.0,6.1版本来说强烈推荐MS VC的调试器。MS VC可以提供系统级头文件方便调试和跟踪,而且允许在系统级显示线程运行情况。<br /><br /> 模拟器肯定和真实的手机有一些区别。例如Windows的进程线程模型就与Symbian的不完全相同。这在app和exe两种不同类型的工程在模拟器产生的结果中可以看出,但是这个情况不会在真实硬件中出现。而且Cpu的不同带来的区别也存在与模拟器和非模拟器版本之间,比如,字长和高低位在前问题。<br /><br /> 对于大多数的开发者,大多数情况下,这些不同是不可见的。<br /><br /><br />--------------------------------------------------------------------------------<br /><br /><br /><br />Hello World<br /><br /><br /> HelloWorld是一个非常简单的UI程序。这个程序在屏幕中央显示了一个简单的消息,而且提供了一个菜单。它包括了一个简单的视图(View)显示“HelloWorld”文本,这个文本使用了UI提供的缺省字体。这个例子程序可以在[path]\epoc32ex\HelloWorld下面找到。[path]指的就是Symbian的安装目录。<br /><br /> 这个工程显示的要点是:<br /><br /><br /> <br />应用程序资源,资源用来定义程序里面显示的文本,菜单,对话框和自定义的“屏幕设备”。资源是在程序代码以外的资源文件管理的,可以单独编译,在这个例子里面是 HelloWorld.rss。<br /> <br />程序里面需要解释的命令,也是定义在主程序代码之外的,而且要#include近来包括它的资源文件。<br /> <br />应用程序可以分为引擎、UI、显示组件等部分,虽然相互依靠,但是逻辑上面相对分离。<br /> <br />所有的程序都必须有一个三值的UID用来唯一标识它。<br /><br /><br /> <br /> 同样很重要的是,这个工程展示了基本的程序需求-需要的文件,基本的创建流程,需要使用的命令和它们的功能。<br /><br /><br />--------------------------------------------------------------------------------<br /><br /><br /><br />Build files<br /><br /><br /> HelloWorld工程文件提供了一个Symbain的.mmp工程文件和一个bldmake组件描述文件bld.inf。<br /> <br /> bld.inf文件只是简单的制定了一个用来编译的.mmp文件,如下:<br /><br />PRJ_MMPFILES<br />HelloWorld.mmp<br /><br /><br /> HelloWorld.mmp文件内容如下:<br /><br />TARGET HelloWorld.app<br />TARGETTYPE app<br />UID 0x100039CE 0x10004299<br />TARGETPATH \system\apps\HelloWorld<br />SOURCEPATH .<br />SOURCE HelloWorld_Main.cpp<br />SOURCE HelloWorld_Application.cpp<br />SOURCE HelloWorld_Document.cpp<br />SOURCE HelloWorld_AppUi.cpp<br />SOURCE HelloWorld_AppView.cpp<br />USERINCLUDE .<br />SYSTEMINCLUDE \epoc32\include<br />RESOURCE HelloWorld.rss<br />LIBRARY euser.lib apparc.lib cone.lib eikcore.lib<br /><br /><br /> 注意,TARGETTYPE是app,这说明这是一个图形界面(GUI)程序,LIBRARY段列出来一个图形界面程序所需要的应用程序框架和图形库。UID行表明一个GUI程序的唯一系统标识符(0x100039CE),和这个程序的唯一系统标识符(0x10004299)。<br /><br /><br />--------------------------------------------------------------------------------<br /><br /><br /><br />Building the application<br /><br /><br /> 所有的类定义在一个头文件里面,每个类的实现都包含在自己的.cpp文件里面。<br /><br /> 在命令行界面下,做如下的操做:/*注释:nokia的s60开发包1.2版本不包括perl语言解释器,所以下面的命令不能运行,需要自己下载一个perl解释器,例如ActivePrel,版本至少5.0以上。*/<br /><br /><br /> <br />改变当前目录为[path]\epoc32ex\HelloWorld<br /> <br />输入bldmake bldfiles<br /> <br />输入abld makefile vc6<br /><br /><br /> 这样就会生成VC工作区格式文件HelloWorld.dsw,声称目录在[path]\epoc32\build\[path]\epoc32ex\HelloWorld\HelloWorld\wins。这个文件可以用VC打开,而且可以用F7进行创建,或者选择菜单里面的Build | Build HELLOWORLD.APP。<br /><br /> 用命令行编译调试版,使用下面的命令:<br /> <br /> abld build wins udeb<br /><br /> 程序会创建在模拟器的z:\system\apps\HelloWorld目录,而且可以从模拟器的图形界面运行。<br /> <br /> 用命令行编译真正手机需要的文件,用下面的命令:<br /><br /> abld build armi urel<br /><br /> 这样程序文件就生成在[path]\epoc32\release\armi\urel目录,而且可以下载到一个真的手机里面。(这个实验我做了,包含后面章节的内容:怎么样创建安装程序。没有出现什么大问题。)<br /><br /><br />--------------------------------------------------------------------------------<br /><br /><br /><br />Up and running<br /><br /><br /> 在IDE里面如果你想运行Hello World程序,你可以先按Ctrl F5,或者选择 Build | Execute菜单。第一次,IDE会提示输入运行的可执行文件名,你必须提供模拟器的完全地址[path]\epoc32\release\wins\udeb\epoc.exe。注意,你只需要这么做一次,下次模拟器的地址就自动保存在工作区里面了。<br /><br /> 模拟器运行以后,需要等一会儿,然后你就可以运行Hello World程序了。<br /><br /><br />--------------------------------------------------------------------------------<br /><br /><br /><br />Debugging<br /><br /><br /> Symbian程序的调试和一般的Windows调试没有什么不同。首先装入VC工程文件,然后按F7创建程序。任何编译错误都会在"Build"标签里面出现。你可以用F4在错误间切换,显示错误所在的源码位置。你也可以象平时一样设置断点和单步运行代码。<br /><br /> 注意Hello World程序没有任何错误,所以不需要进行调试。<br /><br /><br />--------------------------------------------------------------------------------<br /><br /><br /><br />Uploading<br /><br /><br /> 开发流程的最后一环就是把程序传到手机上面。模拟器和真实手机的二进制格式是不相同的,所以你首先必须用ARMI格式重新编译程序,在命令行使用abld build armi urel命令即可。你可以把程序和资源文件从pc的[path]\epoc32\release\armi\目录,复制到手机的\System\Apps\HelloWorld目录。<br /><br /> Symbain提供一个打包应用程序的工具——makesis。如果你要做很多次的重现编译和测试,那么利用这工具的机制,要比直接复制文件到目录更加方便。<br /><br />参看:Application installation guide (尚未翻译)<br /><br /><br />--------------------------------------------------------------------------------<br /><br /><br /><br />Going deeper<br /><br /><br /> 这个指南里的其他主题描述了构成OS的主要子系统,以及为了保证程序的健壮和可靠性而制定的编程准则。<br /><br /> 其他的专家话题可以在DevNet的技术论文里面看到。另外现在部分Symbianos编程的书已经上市了。
2004-10-9 18:21
symbian
Subsystems and APIs<br /><br /><br /><br />Overview<br /><br /><br /> Symbian是一个很大的系统,包含了数百个类和数千个成员函数。象大部分复杂的系统一样,接触Symbain可以把它分成几个大的领域去了解,然后更加关注在你的任务中最重要的部分。比较好的分割方式叫做子系统subsystems。例如,应用程序引擎子系统包括了标准应用程序(例如联系人)所需的处理数据的所有API。<br /><br /> 第三方开发者可以把任何领域和相关的功能组和看做一个子系统。他们不是类似DLL的二进制文件,也不是头文件那样的源文件。但是出于下面的原因,他们仍旧值得去被学习。<br /> <br /><br /><br /> <br />子系统是可以配置的,可以以很多种方式存在,子系统的一部分是必要的时候,其它部分可能是可选的。<br /> <br />系统文档,利用子系统来组织文档的结构。<br /><br /><br /><br /><br />--------------------------------------------------------------------------------<br /><br /><br /><br />The subsystems<br /><br /><br />下图就是Symbian的子系统<br /><br /><br /><br />--------------------------------------------------------------------------------<br /><br /><br /><br />Base<br /><br /> <br /> 不管是写哪一类程序,开发者都不能忽略Base子系统的API。对于初次进行Symbain开发的开发者来说,应该知道的是程序的基础都是用专门给手机优化的类库来构件的,而不是标准C函数库,或者标准C++类库。也就是说Base子系统的API包括了字符串处理、数组、表、错误处理,甚至表示整数和实数的标准数据类型。而且,它还包括了系统开发者所需要的可以处理系统基础,例如线程、进程、内存的API。<br /><br /> 开始理解Base子系统API的最好起点是Essential Idioms章节,里面说明了面向对象的操作系统内部环境。<br /><br /><br />--------------------------------------------------------------------------------<br /><br /><br /><br />Graphics<br /><br /><br /> 图形组件包括用来描绘具体手机的API,例如屏幕、打印机、嵌入图形对象、字体、位图处理等等。<br /><br /> 这个组件也包括了窗口客户服务器端API,这样提供了描绘窗口和接收窗口事件的能力,还有动画API,这个API允许动画运行在一个比较高优先级的线程上面。<br /><br /><br />--------------------------------------------------------------------------------<br /><br /><br /><br />Application Framework<br /><br /><br /> 应用程序框架API,实现了程序框架、定义了程序结构和基本的用户界面处理。应用程序就是狭义的程序:实现一个包含用户界面的程序,而且一个服务程序可以在后台进行系统任务。他也实现了一些其它的功能,例如怎么把文档给用户展现等等。<br /><br /> 这些API其实比刚才说得更加的有用,包含了可重用的程序框架,可以处理文本布局,用户接口控件、和前端处理。<br /><br /> 手机厂商会加入他们自己提供的用户元素API,这些API可以更好的适应他们的屏幕尺寸和输入机制。然而,关键的应用程序概念和基础类都是在这个子系统定义的。<br /><br /><br />--------------------------------------------------------------------------------<br /><br /><br /><br />Engines and utilities<br /><br /><br /> 应用程序引擎API提供访问核心程序数据的方法。这样第三方程序就可以完美的和核心应用程序相结合,例如可以写一个新的通信程序来保存操作读取联系人和议程的数据。<br /><br /> 另外,多媒体服务API可以处理音频和图像。应用程序服务API提供一系列的工具服务,从日志到系统信息,到通讯录同步和日程表同步。<br /><br /><br />--------------------------------------------------------------------------------<br /><br /><br /><br />Communications<br /><br /><br /> 正象你期望的那样,Symbian提供了丰富的通讯API。它们往往都很小,而且经常使用。<br /><br /> Comms Infrastructure API提供了通讯和网络编程的框架和系统服务。希望使用串口和红外的数据传输的都需要了解这个API。<br /><br /> 在更高的层面上,Messaging提供了一个多协议的信息传递的程序框架。
2004-10-9 18:22
symbian
Layout conventions<br /><br /><br />Overview<br /><br /> 和命名习惯一样,Symbian有一种标准的代码布局方式。开发者和组织一般都有自己偏爱的习惯。下面的信息是为了帮助你更好的阅读Symbian平台的代码,即使你已经打算采用其他的布局方式。<br /><br />--------------------------------------------------------------------------------<br /><br /><br />Headers<br /><br /><br /><br /> <br />尽量减少头文件的数目,尽可能使用前导声明。<br /> <br />使用标准的放重复机制,防止头文件的重复引用。例如:<br /><br /><br /><br /> // EG.H<br /> //<br /> // Copyright notice<br /> //<br /><br /> #ifndef _EG_H_<br /> #define _EG_H_<br /> //...include files and declarations<br /> #endif<br /><br /><br />--------------------------------------------------------------------------------<br /><br /><br />Class layout<br /><br /> Symbian平台的类代码布局风格如下:<br /><br />--------------------------------------------------------------------------------<br /><br /><br />General<br /><br /><br /><br /> <br />为了可读性,永远保留访问控制标志<br /> <br />成员的声明顺序:公共成员函数、保护成员函数、私有成员函数、保护数据、私有数据、公共数据。相应的访问控制标志放在每一组的前面。<br /> <br />为了可读性,在声明中给出函数参数的名字。<br /><br /><br /><br />--------------------------------------------------------------------------------<br /><br /><br />Virtual functions<br /><br /><br /><br /> <br />在头文件里把替换继承的行为的虚函数都放在一起,用注释表明这些行为从哪一个类继承而来。<br /> <br />这些函数不写virtual关键字。<br /> <br />虚函数不能是inline函数,因为这样很难确定编译器会怎么处理它们。唯一例外的是虚inline析构器,这是被允许的。<br /><br /><br /><br />--------------------------------------------------------------------------------<br /><br /><br />Inline functions<br /><br /><br /><br /> <br />必须注明inline关键字。<br /> <br />不要在函数的声明里面实现inline函数。应该在头文件的底部实现,或者在其他文件实现。<br /><br />
2004-10-9 18:22
symbian
Class types<br /><br /><br />--------------------------------------------------------------------------------<br /><br /><br />Overview<br /><br /> Symbian平台的应用程序使用4种主要类型的类,下面是它们:<br /><br /><br /> <br />数值类,或者数值类型,名字以T开头。它们不包含任何外部对象,不管直接(指针)或者间接(句柄)。<br /> <br />堆分配类,名字以C开头。这样的类都是继承自CBase类。<br /> <br />资源类,名字以R开头。资源对象控制真实的资源。<br /> <br />接口类,名字以M开头。它们定义抽象的接口,有派生类来实现功能。<br /><br /><br /> 这些类型都和垃圾清理支持紧密相关。<br /><br /><br /><br />Value types—T classes<br /><br /> 数值类型是最基础的类型。它们是用T开头的类型或者类。 <br /><br /><br /> <br />T类型有自己的值。它们不包含任何外部对象,不管直接(指针)或者间接(句柄)。<br /> <br />T类型可以分配空间在堆栈(C++自动变量)或者作为其他类的成员。<br /><br /><br /> 这些基础特征的后果,将在下面探索。<br /><br />--------------------------------------------------------------------------------<br /><br /><br />Constructor<br /><br /> 许多T类型简单到不需要构造器。它们仍旧需要构造起来初始化成员数据。<br /><br />--------------------------------------------------------------------------------<br /><br /><br />Copy constructor and assignment operator<br /><br /> 复制构造器(TX(const TX&))或者赋值运算符(TX& operator=(const TX&))是很少需要的。这个因为复制总是简单的,几乎总是简单的把源对象的成员复制到目的对象而已。这是编译器生成复制构造器和赋值运算符的时候的缺省行为。<br /> 当T类是一个模板类,而参数是一个整数长度而类也有成员的情况下,这些功能还是有用的。那么,复制或者赋值TX<32>到TX<40>的时候,就需要比简单的位复制更老练的机制,所以需要给复制构造器和赋值运算符进行编码。<br /><br />--------------------------------------------------------------------------------<br /><br /><br />Destructor<br /><br /> T类型没有C++析构器。因为没有必要,T类型没有任何外部资源需要释放。<br /><br />--------------------------------------------------------------------------------<br /><br /><br />Orphaning<br /><br /> T类型可以安全的在堆栈上面孤立。孤立的意思就是在不掉用析构器的情况下释放内存。因为T类型没有外部资源,所以当T类型孤立的时候,没有外部资源会变得无法访问。<br /><br />--------------------------------------------------------------------------------<br /><br /><br />Function arguments<br /><br /> T类型可以在作为传值和传址参数的情况下作为函数的参数。<br /><br />--------------------------------------------------------------------------------<br /><br /><br />Data members<br /><br /> T类型可以包含其他T类型。另外它们还可以包含R对象,或者是C对象的指针,作为对象的宿主,有义务维护对象的清除过程。在实际中,这种情况很少发生。<br /><br />--------------------------------------------------------------------------------<br /><br /><br />Built-in C++ types<br /><br /> 所有的C++内建类型都符合T类的标准。内建类型都用typedef定义了以T开头的名字,例如TInt。<br /><br />--------------------------------------------------------------------------------<br /><br /><br />Standard class hierarchy—C classes and class CBase
页:
[1]
Powered by Discuz! Archiver 5.5.0
© 2001-2006 Comsenz Inc.