PKG文件格式 (sis嵌入,安装过程中提示)

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

CODE:
;Languages
&EN,FR


语言代号:
EN   英语 PO   葡萄牙语 
FR   法语 SP   西班牙语 
GE   德语 RU   俄语 
IT   意大利语 DU   荷兰语 
SW   瑞典语 DA   丹麦语 
FI   芬兰语 NO   挪威语 
ZH 中文
更多的代码可以参考SDK

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

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

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


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

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

接下来的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 :在卸载的时候执行--RR
RUNBOTH :安装和卸载的时候都执行

安装一个共享组件(SISX嵌入)
一个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,用户将不能安装该安装包。

pkg中
;Package dependency
@"***.sisx",(XXX's UID)

这个方法是两个程序一起安装,卸载主程序的时候一起卸载,卸载副程序的时候,只卸载副程序。
;embedded-sis("@")
@"C:/MyDLL_Symbian/Symbian4/Symbian4/sis/Symbian4_signed.SIS", (0xeac2d980)


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

为了确保这些文件在你卸载应用程序时也被删除,你需要使用 FILENULL 选项:

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


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


Pkg的高级设置:
http://wiki.forum.nokia.com/index.php/Advanced_Package_File_Options

你可能感兴趣的:(dll,Build,语言,手机,Symbian,平台)