如何创建sis文件——PKG文件格式

转自开发视界（www.sf.org.cn）

语言支持

PKG文件的第一行将指明应用程序的语言。每种语言用两个字母表示，如下：

 

CODE:

;Languages
&EN,FR

语言代号：
EN  英语     PO  葡萄牙语  
FR  法语    SP  西班牙语  
GE  德语    RU  俄语  
IT  意大利语    DU  荷兰语  
SW  瑞典语    DA  丹麦语  
FI  芬兰语    NO  挪威语  

更多的代码可以参考 SDK

语言行可以忽略，这样的话，将使用默认的英语。

包头

PKG文件的下一个组成部分是包头。它详细什么包的名字，应用程序的UID， 版本信息荷包的类型：

 

CODE:

#{"DummyLC","BetaLC"},(0x0010D003),1,01,12,TYPE=SISAPP

第一部分{"DummyLC","BetaLC"}是应用程序的名称。必须为语言行的每中语言指定相应名称，DummyLC是应用程序的英文名称；而BetaLC 是法语名称。

接下来是应用程序的UID（0x0010D003）。如果你打算发布你的应用程序，这个值应该从Symbian公司 获得（参考为你的应用程序请求UID）。

The next three values represent the major, minor , build version number (we have here version 1.01, build 12).
接下来的3个值，描叙主次和bulid版本号（这个版本是1.01,Build 12)。

最后的一个值可选，它指定SIS的类型，可能的值如下：
SISAPP：包含一个应用（如果没填将被指定）。
SISSYSTEM：包含一个共享 /系统组件，像DLL或者OPX，他们可以被其他的应用程序所使用。当最终的应用程序卸载的时候组件也将被卸载。
SISOPTION：包含一个扩展或可选的组件（动态载入代码，数据文件，等）。用户可以选择是否安装或者稍后删除，该组件不依赖主程序而工作。
SISCONFIG：配置一个已经存在的应用程序或服务 . 该包不能够包含任何新文件，就算有也只能显示在安装时期，或者添加一个已存在的组件。该包安装后也不会出现在卸载中。
SISPATCH：增补已经存在的组件，它可以被用户卸载。
SISUPGRADE  更新已经存在的组件。该包安装完后也不列在卸载程序中，用户要重装或者卸载必须改变其关联的程序。

产品/平台兼容性

接下来的行指定应用程序目标平台或产品:

 

CODE:

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

0x101F6F88 代表是Series 60 v0.9。它支持大多数的的现有S60设备。当然，如果你使用一些特定的API，你将使用响应的代号代替。查看我们的通用产UID页面获得更多代号。

0, 0, 0 是主版本号、次版本号和build号。你不用修改它。

{"Series60ProductID","Series60ProductID"} 是平台识别串。你在S60设备上应该使用“Series60ProductID”。注意：该字符串将重复你语言行所指定的语言中。

显示文字通知

在安装过程中，可以显示一些文字窗口。这里可以显示，程序使用的授权，一些发布通知等（新版本的特性等）
以下是FILETEXT的使用：

 

CODE:

;
; Display new features
;
"release.txt" - "", FILETEXT, TEXTCONTINUE

上面一行自定了：release.txt文件的内容将在安装过程中被显示。该文件跟PKG文件在同一个目录下（如果不是同一个目录你必须指定路径），在这个例子中，该文件不会被安装在手机上。

TEXTCONTINUE：指定用户只能操作“继续”
TEXTSKIP：出现“是”和“否”文字对话框。如果“是”，对话框消失，继续安装程序，如果“不是”对话框消失，安装继续，接下来的文件和组件将不被安装。
TEXTEXIT：出现“是”和“否”文字对话框。选折“是”继续安装，选折“否”将取消安装，所有的 文件将被删除。
TEXTABORT : 出现“是”和“否”文字对话框。选折“是”，对话框取消，安装继续；选择“否”，安装被取消，通常导致部分被安装。
这部分也可以集成在文件部分。TEXTSKIP选项可以用来询问用户选择文件是否想被安装。

语言依存文件
应用程序可以包含一些语言依赖的文件（数据文件，资源 文件等），你能指定那些依赖的文件被安装：

 

CODE:

;
; Install language dependent data
;
{
""Symbian"6.1"Series60"Epoc32"release"thumb"urel"DummyLC.r01"
""Symbian"6.1"Series60"Epoc32"release"thumb"urel"DummyLC.r02"
}-"!:"system"apps"DummyLC"DummyLC.rsc"

如果用户选择英文，DummyLC.r01将作为DummyLC.rsc文件被安装；用户选择法文DummyLC.r02将被安装。有趣的是，仅仅只有一个文件将被安装到手机上，他们总是一个名字，内容和用户语言一致。

如果用户使用了存储卡，"!:" 用来指定，用户能选择的目标位置，如果不想用户选择路径，你可以用绝对路径来替换它（例如：C：）。

在这一步你要注意大括号中的所有内容，用来指定语言选项。

独立语言文件
文件中的接下来这部分将不论用户使用什么语言，将安装这些文件：

 

CODE:

;
; Files to install
;
""Symbian"6.1"Series60"Epoc32"release"thumb"urel"DummyLC.app"           - "!:"system"apps"DummyLC"DummyLC.app"
""Symbian"6.1"Series60"Epoc32"release"thumb"urel"DummyLC.aif"          - "!:"system"apps"DummyLC"DummyLC.aif"

上 面的内容将添加SIS文件中的2个文件到手机上，DummyLC.app 和 DummyLC.aif 他们位于 C:"Symbian"6.1"Series60"Epoc32"release"thumb"urel" 文件夹下面。这些文件将被安装到手机设备的所安装盘符的"system"apps"DummyLC 目录下。

安装时运行一个文件
在运行一个安装或卸载程序时运行一个文件有时显得非常有用。典型用处：
1. 安装完后启动一个服务（recognizer 注册者也可以用到）。
2. 卸载后做一些清理工作。
...

可以用 FILERUN 命令来实现：

 

CODE:

;
; Install and run an exe
;
""Symbian"6.1"Series60"Epoc32"release"thumb"urel"RunMe.exe"         -"!:"system"apps"DummyLC"RunMe.exe",FILERUN,RUNINSTALL

在上面的例子中，RunMe.exe将在安装的过程中自动被执行。

其他的命令：
RUNREMOVE：在卸载的时候执行
RUNBOTH：安装和卸载的时候都执行

安装一个共享组件

一个SIS文件，它包含一个组件可以共享给其他应用程序：

 

CODE:

;
; Install shared component
;
@"..".."Common"DLL"Install"newlcdll.sis",(0x1000EB00)

这个共享组件将被包含在应用程序中，和该应用程序一起安装，除非它已经被安装。当有一个应用程序在使用该共享组件时，它都不能被卸载。

我们的 EzBoot 是共享组件的一个很好的例子。

接下来的代码也能使用指定的外部组件

 

CODE:

(0x1000EB00), 1, 0, 12, {"NewLC DLL","NewLC DLL"}

上面的代码将请求安装已经存在的组件，它的UID是“0x1000EB00”版本1.0 Build 12，然而，如果手机上不存在这个DLL，用户将不能安装该安装包。

运行时产生的文件

应用程序可能也会产生一个数据文件在运行的时候（例如，参数，高分榜等）。

为了确保这些文件在你卸载应用沉许时也被删除，你需要使用 FILENULL 选项：

 

CODE:

;
; Make sure the configuration file is removed on uninstall
;
""-"C:"system"apps"DummyLC"DummyLC.ini",FILENULL

注意：在更新版本时，DummyLC.ini 将不会被删除。这样做是为了确保想ini 这样的文件（记录一些相关参数）在更新时不会被删除。