Symbian开发环境

二 Symbian开发环境入门

二 . 开发环境入门
2.1 安装 SDK 及 VC
Nokia 根据手机的屏幕大小和价格高低把手机分成了多个系列，现在使用的系列有： Series 40 、 Series 60 、 Series 80 和 Series 90 。 60 系列采用 Symbian os 6.1 ，然后又根据手机屏幕的特点对 UI 做了一些修改，这个被修改了的 Symbian 就被称为 Nokia 的 60 系列平台。使用 60 系列的手机型号包括： Nokia 6670 、 Nokia 6630 、 Nokia 6260 、 Nokia N-Gage QD™ 、 Nokia 7610 、 Nokia 6620 、 Nokia 3620 、 Nokia 3660 、 Nokia 6600 、 Nokia 3600 、 Nokia 3650 、 Nokia 7650 、 Nokia N-Gage™ 等。

下面我们就以 60 系列为例，介绍 SDK 的安装过程。

2.1.1 安装 SDK
第一步，到 Nokia 论坛注册，下载最新的 SDK 。 Nokia 网站提供的 Series 60 SDK for Symbian OS Nokia Edition SDK 最新版本是 v1.2 ， Series 60 SDK for Symbian OS 的最新版本是 v2.1 。下载网址： http://www.forum.nokia.com/main/0 ,6566,034-4,00.html

第二步，到 http://www.activestate.com 网站下载最新的 Active Perl Script 安装程序。到 http://www.java.com/en/download/manual.jsp 下载最新的 J2RE 。

第三步：安装 SDK ，推荐为 Symbian 开发单独建一个目录，例如 d ： /Symbian 而不是使用 C:/program files 等这样的目录。

第四步：安装 Active Perl 和 J2RE ，安装到默认目录即可。

第五步：检查环境变量设定。打开系统环境变量 tab ，然后看看有没有 EPOCROOT ，如果有的话，把它手动改成 “/” 。改完之后应该是这个样子的：

EPOCROOT = /（不要加入盘符例如c:/..../等）
如果你的安装后，EPROCROOT的路径为C:/Symbian/8.0a/S60_2nd_FP2_SC/epoc32
那么EROCROOT设置为/Symbian/8.0a/S60_2nd_FP2_SC/

然后，在系统 PATH 中加入 /epoc32/tools 目录以及 /epoc32/gcc/bin 目录就可以了。

实际上， Symbian SDK 根本不用安装，直接把 epoc32 目录拷贝到一个机器上，然后照上述方法设定目录和环境变量就可以了。

2.1.2 配置 VC
如果我们使用的是 VC 6.0 ，我们要保证系统至少打了 SP3 补丁，否则系统会有警告提示。如果我们使用的是 VS.NET2003, 我们就只能安装 Series 60 SDK for Symbian OS v2.1 ，因为 Series 60 SDK for Symbian OS Nokia Edition SDK v1.2 在 VS.NET2003 无法正确建立工程。

如果要直接在 vc6 里创建新项目，要把 /Symbian/6.1/Series60/Series60Tools/ Application Wizard 目录下的 AvkonAppWiz.awx 和 AVKONAPPWIZ.HLP 文件拷贝到 vc6 的模板目录 C:/Program Files/ Microsoft Visual Studio/ Common/ MSDev98/ Template 下。这样我们就可以在 VC 的新建工程中看到 Series 60 AppWizard v 1.9 这个选项 .

     填入 Project Name 以后，确认。
    
一路 “Next” ，一个最简单的 Symbian 应用程序就建立好了。


如果要将已经建立好的工程导入到 VC6.0 中，比如我们将 SDK 中的例子 HelloWorld 转换成一个 VC6 的项目，我们首先进入 /Symbian/6.1/Series60/Series60Ex/HelloWorld 目录。在这里我们可以看到，在 Symbian 中，一个 Project 通常是按 inc, src, group 等目录组织， group 目录里通常放的是项目文件，所以编译时要先到这里。用命令提示符模式进入刚才说的那个目录下，然后执行：

bldmake bldfiles

这个命令会在 group 目录下生成一个 abld.bat 的批处理文件，并且会在 /Symbian /6.1/Series60/Epoc32/BUILD 下生成 /Symbian/6.1/Series60/Epoc32/BUILD/SYMBIAN/6.1/ SERIES60/SERIES60EX/HELLOWORLD/GROUP 这个目录，并在最底层目录下生成一堆 .make 文件。

然后，我们在同一个目录运行刚才生成的 abld.bat ：

abld makefile vc6(这个步骤可以没有，他是生成VC下的一些工程文件，好方便你在VC下打开)

这样就会自动生成 vc6 的 dsw 文件，位置在 /Symbian/6.1/Series60/Epoc32/BUILD/ SYMBIAN/6.1/ SERIES60/SERIES60EX/HELLOWORLD/GROUP/HELLOWORLD/WINS 。然后我们就可以在 VC6 种打开这个 Symbian 工程了。

2.2 编译
我们可以直接使用 SDK 提供的工具编译 Symbian 工程，也可以使用 VC6 提供的集成环境来编译转化过的 Symbian 工程。编译的结果存放在 /Symbian/6.1/Series60/Epoc32/ Release/wins/UDEB/Z/SYSTEM/apps 目录中。

2.2.1 使用 SDK 提供的工具编译 Symbian 工程
我们在上一节的那个位置继续输入：

abld build wins udeb

这个命令会编译我们的程序，最后在 /Symbian/6.1/Series60/Epoc32/Release/wins/UDEB 目录下生成我们的 helloworld ，然后我们可以从开始菜单里运行模拟器的 debug 版，在模拟其中就可以运行 helloworld 了。

2.2.2 使用 VC6 编译 Symbian 工程
我们直接打开运行 abld makefile vc6 后生成的 dsw 文件， VC 自动装载转化过的工程。按 F7 便可以直接编译工程，编译结果同样放在 /Symbian/6.1/Series60/Epoc32/Release/ wins/UDEB 目录中。然后我们打开模拟器 debug 版，就可以看到我们编译好的工程了。

2.3 打包
我们以 SDK 1.2 提供的 HelloWorld 为例，制作可以在手机中安装的 .SIS 文件：

2.3.1 ．检查程序
首先，在命令行格式下，进入 HelloWorld 工程 mmp 文件所在目录，输入 bldmake bldfiles 和 abld build wins udeb ，然后打开模拟器，检测程序有无错误。

2.3.2 ．编译工程
在程序无错误后，在命令行输入 abld build armi urel 。执行这个命令之后会在目录 d:/symbian/6.1/series60/epoc32/release/armi/urel 生成 HELLOWORLD.APP 和 HELLOWORLD.RSC 两个文件。

2.3.3 ．建立 .pkg 文件
在 d:/Symbian/6.1/Series60/Series60Ex/helloworld/sis   用记事本建立或者修改工程的 pkg 文件，内容如下：

; HelloWorld.pkg

;

;Language - standard language definitions

&EN



; standard SIS file header

#{"HelloWorld"},(0x10005B91),1,0,0



;Supports Series 60 v 1.2

(0x101F8202), 0, 0, 0, {"Series60ProductID"}

;

"d:/symbian/6.1/series60/epoc32/release/armi/urel/HelloWorld.APP"-"!:/system/apps/HelloWorld/HelloWorld.app"

"d:/symbian/6.1/series60/epoc32/release/armi/urel/HELLOWORLD.rSC"-"!:/system/apps/HelloWorld/HELLOWORLD.rSC"

其中，前面 "d:/symbian/6.1/series60/epoc32/release/armi/urel/HELLOWORLD.rSC" 是要打包安装的文件， "!:/system/apps/HelloWorld/HELLOWORLD.rSC" 是安装的目标位置。在其中要注意的是，我们在目标位置中用 “ ！ ” 代替了实际的盘符。这样做得好处是在用户安装的时候，手机系统会提示用户选择要安装的位置，这就给了用户更大的灵活度。另外，在 Symbian 系统中，安装的应用程序默认位置是 “!:/system/apps ” 。

编辑好 pkg 文件后，保存至相应目录。

2.3.4 ．打包程序
在命令行中，转至 pkg 文件所在目录，运行命令 makesis HelloWorld.pkg 。之后我们就在同一目录下得到了打包好的 .sis 文件。


2.4 手机测试
将打包好地 .sis 文件上传至手机中，然后在手机的应用程序管理器中就可以看到我们打包好的文件。选择 “ 安装 ” 命令，系统会提示用户要安装的位置，选择安装位置后，我们制作的应用程序就安装到手机中了。

我们回到手机的主菜单，就会发现新安装的 HelloWorld 应用程序。打开运行，结果和在模拟器中看到的基本是一样的。

 注意： SDK1.2 以下版本需要 EPOCROOT

SDK 以上用 DEVICES 设置

传递到目标硬件上的应用程序的形式为 Symbian 安装系统（ .sis ）文件。 .sis 文件是一个压缩的存档文件，它包含了安装所需要的所有文件，还包括了安装过程的选项信息。 Symbian 安装系统为把应用程序、数据或配置信息安装到基于 Symbian 操作系统的设备上提供了简单的和一致的用户界面。开发者（或最终用户）安装的组件都包含在 .sis 文件中。

　　我们可以使用 Series 60 SDK 提供的交互式工具 sisar 来执行 .sis 文件的生成工作。为了容易在目标硬件上安装应用程序， sisar 把所有的应用程序文件打包到一个 .sis 文件中。

　　制作安装（ .sis ）文件所有需要的信息都在示例项目 HelloWorld 中提供了 -- 它们位于 /install folder 下。在示例项目中我们使用了一个专用的安装包源文件（ HelloWorld.pkg ）和 Symbian 提供的一个工具 makesis.exe 。

　　建立 SIS 安装文件

　　在你建立了 HelloWorld 应用程序的 armi 发布版之后，你需要把所有的应用程序组件打包到一个安装程序包（ .sis ）文件之中。打开命令提示符并导航到 HelloWorld 项目的 SDK 文件夹。切换到 /install folder ，接着输入下面内容建立 .sis 文件：

makesis helloworld.pkg

　　成功的建立将会输出类似 "Created helloworld.sis" 的消息。安装程序包（ .sis ）文件将建立在 /install folder 下面。现在你必须它把传输到设备上。

　　 SIS 文件的安装

　　你可以在三种潜在的安装选项中作出选择，这依赖于你使用的设备和其它可以使用的工具 -- 例如，你是否能够通过红外线或蓝牙设备访问 PC ，或访问基于 Symbian Connect （ Nokia PC Suite ，或其它设备厂商提供的这类东西）的一些软件：

　　 · 安装通过调用 PC 上的 .sis 文件进行，后续的 Series 60 设备的应用程序安装过程通过 PC 与目标设备之间的红外线或蓝牙对话，由软件（例如 Symbian Connect ）建立连接来完成。

　　 · 安装通过 OBEX （ OBject EXchange ），经由红外线或蓝牙，从任何设备（例如 PC 、 Symbian OS 电话或其它任何可以使用 OBEX 的设备）把 .sis 文件传输过去。这个过程可以由 Messaging 应用程序来管理，它可以截取附加在消息上的文件 -- 当你打开消息的时候，它会在电话上自动启动应用程序安装过程。

　　 · 作为选择， .sis 文件可以作为电子邮件附件发送。应用程序安装也是通过电话上的 Messaging 应用程序管理的。当你打开消息的时候，它自动地启动安装程序。

　　前面两种方法依赖于你在开发项目的 PC 和 Series 60 设备之间建立连接。典型情况下设备厂商提供了适当的通讯软件，你必须参考连接软件提供的特定指令。

　　在安装之后， .sis 文件大幅度简化的版本依然保留在 Series 60 设备上用于控制应用程序的卸载，如果需要，请使用应用程序 "Manager （管理器） " 。这个简化的 .sis 文件仅仅包含卸载应用程序所需要的信息，典型情况下比原始文件小很多。

　　如果 .sis 文件作为消息附件传递，而且原始消息没有从 Messaging 应用程序的 Inbox 文件夹中删除，那么原始的 .sis 文件也可能存在于设备上。

　　在目标设备上运行

　　把 helloworld.sis 文件使用上述的方法之一传输到目标硬件上。在传输之后，你就可以在设备上安装应用程序了。运行应用程序按照 " 定位和运行应用程序 " 一节列举的进行。你会确信目标设备上定位和运行的应用程序于模拟器上的是一样的 -- 只有一个小小的差别：应用程序不会位于 "Other" 文件夹中。