Symbian S60系列---PKG文件范例详解

• 运行maker.bat即可编译位于安装目录下的myapp.pkg，编译成功后将会在目录内产生一个myapp.sis文件，若编译失败（未有sis文件生成），请查看目录内生成的report.txt的错误报告 深红粗体字为注释。注：标识了（非必要）的区段在未设置信息时可以省略不写，其他区段则不可省略。;编译信息开始(文件内注释用 ; 号来标识，如果PKG文件内包含双字节字符（比如中文，日文），则使用文本编辑工具保存时，必须将PKG文件编码保存为UNICODE，否则无法正常编译。)
  
  ;PKG文件头部信息--开始
  
  ;语言支持（非必要）
  &EN,ZH
  
  ;安装程序标题,版本号及SIS文件UID
  #{"Language Name 1","Language Name 2"},(UID),0,0,0,SH,NC,TYPE=SISAPP
  
  ;开发平台兼容性校验
  (UID),0,0,0,{"Series60ProductID","Series60ProductID"}
  ;PKG文件头部信息--结束
  
  ;安装文件信息--开始
  
  ;单语言文件安装
  "PCSourceFile/MyApp.app"-"MobileDestFile/MyApp.app"
  ;多语言文件安装（如果是单语言安装程序，则此段可省略）
  {
  "PCSourceFile/MyApp.rEN"
  "PCSourceFile/MyApp.rZH"
  }-"MobileDestFile/MyApp.rsc"
  
  ;必要组件校验（非必要）
  (UID),0,0,0,{"Language Name 1","Language Name 2"}
  
  ;可选附加组件（非必要）
  !({"Language Name 1 for Add-on 1 (20kb)","Language Name 2 for Add-on 1 (20kb)"},{"Language Name 1 for Add-on 2 (20kb)","Language Name 2 for Add-on 2 (20kb)"})
  
  ;条件判断（非必要，如果可选附加组件部分没有写，那么此部分也不需要写）
  IF option1
  "PCSourceFile/addon/MyPic.gif"-"!:/System/Apps/MyApp/addon/MyPic.gif"
  ENDIF
  ;附加SIS文件（非必要）
  @"PCSourceFile",(0x12345678)
  ;安装文件信息--结束语言支持
  
  界面语言支持行，如果此行不写则取默认值&EN
  一个SIS文件内可以包含多个界面语言版本，但只能安装一种语言（安装时会自动根据你的系统语言来安装相应的界面语言版本）
  多个语言时用,分隔
  多语言安装程序时不可省略界面语言支持行
  ·单一语言：&ZH
  ·多语言：&EN,ZH
  
  参数值说明参数值说明参数值说明参数值说明AF荷兰语(南非)FI芬兰语LS西班牙语(拉丁美洲)SF法语(瑞士)AH埃塞俄比亚语FR法语LT立陶宛语SG德语(瑞士)AM英语(美国)FS瑞典语(芬兰)LV拉脱维亚语SQ阿尔巴尼亚语AR阿拉伯语GA爱尔兰语MK马其顿语SW瑞典语AS奥地利语GD盖尔人语(苏格兰)ML马拉亚拉姆语(印度)SZ意大利语(瑞士)AU英语(澳大利亚)GE德语MN蒙古语TA泰米尔语BE俄语(白俄罗斯)GU古吉拉特语(印度)MO摩尔多瓦语TC中文(台湾)BF法语(比利时)HE希伯来语MR马拉提语(摩剌陀语)TE泰卢固语(印度)BG保加利亚语HI印地语(印度)MS马来语TH泰语BL佛兰德斯语(比利时)HK中文(香港)MY缅甸语TI厄立特里亚语BN孟加拉语HR克罗地亚语NN尼诺斯克语(挪威)TK土库曼语bo藏语HU匈牙利语NO挪威语TL塔加拉语(菲律宾)BP葡萄牙语(巴西)HY亚美尼亚语NZ英语(新西兰)TU土耳其语CA加泰罗尼亚语
  (西班牙)IC冰岛语OS国际西班牙语VI越南语CE英语(加拿大)IE国际英语PL波兰语UK乌克兰语CF法语(加拿大)IF国际法语PO葡萄牙语UR乌尔都语CS捷克语IN印度尼西亚语PA旁遮普语
  (印度、巴基斯坦)ZH中文CT塞浦路斯语IT意大利语RO罗马尼亚语ZU祖鲁语CY威尔士语JA日语RU俄语  DA丹麦语KA格鲁吉亚语(土耳其)SI斯里兰卡语  DU荷兰语KK哈萨克语SK斯洛伐克语  EL希腊语KM柬埔寨语SL斯洛文尼亚语  EN英语(默认值)KN坎拿达语(印度)SO索马里语  ET爱沙尼亚语KO韩语SP西班牙语  FA波斯语LO老挝语SR塞尔维亚语  安装程序信息
  
  以#{"RescoView","RescoView简体汉化版"},(0x11111111),4,10,0为例说明：
  
  1.#{"RescoView","RescoView简体汉化版"}是安装程序标题
  如果是单一语言的安装程序，则只写一个标题即可
  如果是多语言安装程序，则需要按语言支持区段的语言顺序来依次（就是按&EN,ZH那个部分的顺序）输入各语言版本下的标题，标题名称用“,”分割
  ·单一语言：#{"RescoView简体汉化版"}
  ·多语言：#{"RescoView","RescoView简体汉化版"}
  
  2.(0x11111111)是SIS安装文件的UID（自定义，SIS安装文件即是安装完成后在C:/system/install/生成的相应SIS文件）
  
  3.4,10,0是程序安装时显示的版本号，4是主版本号，10是次版本号，0是build版本号；4,10,0在安装时显示的就是4.10
  4.SH,NC是SIS文件选项（此处为非必要参数）
  
  参数值（缩写）参数值（全称）说明SHSHUTDOWNAPPS
  关闭应用程序NCNOCOMPRESS
  不压缩
  5.TYPE=SISAPP是SIS文件的类型（如果未指定，则默认为TYPE=SISAPP）
  
  参数值（缩写）参数值（全称）说明SASISAPP
  标准的安装程序（默认值）SYSISSYSTEM
  此安装程序类型包含系统库或共享库文件注册（DLL或OPX文件），这些库文件在主程序卸载时会一并卸载SOSISOPTION
  此安装程序类型安装时有可选组件，选择安装的组件在主程序卸载时会一并卸载SCSISCONFIG
  此安装程序类型可以配置已存在的程序或服务，此类型打包时不应该包含任何新文件。只能用来配置安装或运行过程中的文件显示及增加新组件等等操作。在程序管理列表中不会显示配置程序的卸载，需要手动卸载SPSISPATCH
  此安装程序类型会修复已存在的的程序，在程序管理列表中不会显示修复程序的卸载，需要手动卸载SUSISUPGRADE
  此安装程序类型可以升级已存在的程序，但在程序管理列表中不会显示升级程序的卸载，需要用户手动删除文件或重新关联程序才能撤销升级兼容性
  
  此区段用来限制程序是否可以被正确安装在目标机型上（比如防止NOKIA Series60的软件安装在UIQ的机型上，避免造成程序错误）
  以(0x101F6F88),0,0,0,{"Series60ProductID","Series60ProductID"}为例说明：
  1.(0x101F6F88)是开发平台SDK的UID，也可以用具体机型的UID来限制
  下表给出几个常见机型的平台UID及机型UID（由于能力问题，UID资料可能存在错误或不完全，请见谅）
  以下对Symbian OS几个版本以及Series60的性能做一下概述
  1.屏幕显示象素：176×2082.支持Java (J2ME/MIDP 1.0)及C++开发3.便于简单短周期的开发程序4.提供多样性并强大的应用程序开发框架5.Series60 v2.x版本提供了对Java (J2ME/MIDP 2.0)及界面主题模式的支持6.Symbian OS8.0提供了对3G网络的支持
  SDK版本UIDSeries60 SDK 0.9
  （Symbian 6.1）Series60 SDK 2.0
  （Symbian 7.0）Series60 SDK 2.0
  （Symbian 8.0）手机型号UID手机型号UID手机型号UIDSeries60 0.9 0x101F6F88Nokia 76500x101F6F87Nokia 66000x101F7963Nokia 66300x101F7964Series60 1.0 0x101F795FNokia 3650/3660/36200x101F7962Nokia 66200x1020216B Series60 1.1 0x101F8201Nokia N-Gage0x101F8A64Nokia 76100x101FD5DBSeries60 1.2 0x101F8202Nokia N-Gage QD   Series60 2.00x101F7960Siemens SX10x101F9071Series60 2.1 0x101F9115Sendo-X0x101FA031Series60 2.2 0x10200BABBenQ P300x101FD279UIQ 2.0 0x101F617B UIQ 2.1 0x101F61CE
  2.2,0,0是平台的版本号，2是主版本号，0是次版本号，0是build版本号，2,0,0显示的版本就是2.0
  注：此处的版本号要根据UID来作相应改动。
  例：如果UID是0x101F6F88（Series60 0.9），则主版本号则需要写成0，次版本号也写0即可

  提示：
  ·如果只是希望安装在某一特定机型上（比如N-Gage），则UID处写N-Gage的UID，而平台版本处写 0 , 0 , 0即可
  ·如果希望安装程序能在多个机型上安装（向老版本机型兼容），则UID处写最老那个机型的平台版本的UID，平台版本号处参照上边第 2条写
  例：假使希望可以安装在N7650,N3650,N-Gage,N-Gage QD,N6600上，则写为 ( 0x101F6F88 ), 0 , 0 , 0
  3. {" Series60ProductID "," Series60ProductID "}是平台类型校验字符串，用来目标机器的平台类型（UIQ或Series或其他类型）
  平台类型字符串Nokia Series60 Series60ProductIDUIQUIQ20PlatformProductID
  如果是单一语言的安装程序，则只写一个字符串即可
  如果是多语言安装程序，则需要按语言支持区段的语言顺序来依次（就是按 & EN , ZH那个部分的顺序）输入各语言版本下的校验字符串，字符串间用“ ,”分割
  ·单一语言： {" Series60ProductID "}
  ·多语言： {" Series60ProductID "," Series60ProductID "}
  
  
  由于WDA上大家汉化的软件常见的只有三种类型（其他包括的机型我没有写，因为论坛上几乎没人用）
  Series60 0.9 & 1.x：包括N7650,N3650,N-GAGE,N-GAGE QD
  Series60 2.x：包括N6600和N7610
  Series60 0.9 & 1.x & Series60 2.x：包括以上所有机型
  所以如果上边的暂时不太懂的话，那就照以下两种类型情况下的例子改写即可
  Series60 0.9 & 1.x： ( 0x101F6F88 ), 0 , 0 , 0 ,{" Series60ProductID "," Series60ProductID "}
  Series60 2.x： ( 0x101F7960 ), 2 , 0 , 0 ,{" Series60ProductID "," Series60ProductID "}
  Series60 0.9 & 1.x & Series60 2.x： ( 0x101F6F88 ), 0 , 0 , 0 ,{" Series60ProductID "," Series60ProductID "} 文件的安装
  
  格式为 " PCSourceFile(PC端源文件) "-" MobileDestFile(手机端目标文件) ", 文件类型 , 操作参数1 , 操作参数2
  以 " D:/sis/files/MyApp.app "-" !:/System/Apps/MyApp/MyApp.app ", 文件类型 , 操作参数1 , 操作参数2为例
  1. PC端源文件可以用相对路径（相对于pkg文件所在路径）也可以用绝对路径
  例：假使你的PC端pkg文件在 D:/sis，需要打包的PC端文件都在 D:/sis/files
  相对路径： files/MyApp.app
  绝对路径： D:/sis/files/MyApp.app
  
  2. 手机端目标文件就是指定文件将被安装在手机的哪个目录中。
  !代表目标盘符，如果有文件必须安在手机的 C盘的话，改为 C即可
  例1： !:/System/Apps/MyApp/MyApp.app
  例2： C:/System/Apps/MyApp/MyApp.app
  3. 文件类型 , 操作参数1 , 操作参数2，如果 文件类型未指定（则默认为 FILE）时可以省略 操作参数；如果 操作参数1未指定时（则默认为 RUNINSTALL） 操作参数2可以省略
  例1： " D:/sis/files/MyApp.app "-" !:/System/Apps/MyApp/MyApp.app ", 文件类型 , 操作参数1 , 操作参数2
  例2： " D:/sis/files/MyApp.app "-" !:/System/Apps/MyApp/MyApp.app ", 文件类型 , 操作参数1
  例3： " D:/sis/files/MyApp.app "-" !:/System/Apps/MyApp/MyApp.app ", 文件类型
  例4： " D:/sis/files/MyApp.app "-" !:/System/Apps/MyApp/MyApp.app "
  
  参数值（缩写）参数值（全称）说明文件类型FFFILE标准程序文件（默认值）FTFILETEXT文本文件，如果指定了文件为文本类型，则在安装过程中会显示一个窗口来显示文本信息。
  如果文本信息窗口的类型不指定，则默认为 TEXTCONTINUE
  如果指定了文件为文本文件，则手机端目标路径处可以选择留空
  （如果你希望该文本文件安装到手机上的话则需填写路径）
  例1： " D:/sis/files/Readme.txt"-" !:/System/Apps/MyApp/Readme.txt", FT例2： " D:/sis/files/Readme.txt"-"", FTFNFILENULL卸载指定文件，该类型不需要 源文件路径参数
  实例（安装时卸载指定路径下的 setting.ini文件：
  ""-" !:/System/Apps/MyApp/setting.ini", FNFMFILEMIME指定安装文件的MIME类型，我们一般用不到，不做说明FRFILERUN指定是运行文件。文件可以是exe文件，app文件或文本文档
  如果文件被指定了非 FILERUN的类型，则可根据需要省略 操作参数1和 操作参数2文本信息窗口类型TCTEXTCONTINUE
  只显示一个确认按钮，用户按下后会继续程序的安装TSTEXTSKIP
  显示一个确认按钮和一个取消按钮，用户按下确认按钮会继续安装
  按下取消也会继续完成安装程序（但pkg文件内此文件行以下指定的安装文件将不会被安装）TETEXTEXIT
  显示一个确认按钮和一个退出按钮，用户按下确认按钮会继续安装
  按下退出按钮则会退出安装程序（已安装的文件会自动删除）TATEXTABORT
  显示一个确认按钮和一个退出按钮，用户按下确认按钮会继续安装
  按下退出按钮则会退出安装程序（之前已安装的文件不会被删除）操作参数1RIRUNINSTALL
  指定文件在安装时运行RRRUNREMOVE
  指定文件在卸载时被运行RBRUNBOTH
  指定文件在安装时运行，卸载时也运行操作参数2RSRUNSENDEND
  运行指定文件，自动运行指定文件，运行完后自动关闭文件来完成安装程序（只有指定为 操作参数1为 RUNINSTALL参数时才能使用此参数）RWRUNWAITEND
  运行指定文件，等待用户按键确认安装程序的完成
  
  4. 安装文件的多语言形式， 手机端目标文件不变， PC端源文件按照如下格式书写即可
  PC端源文件的顺序要按照语言顺序来依次（就是按 & EN , ZH那个部分的顺序）书写（ PC端源文件可用空格或换行分隔），字符串间用“ ,”分割
  书写格式： {
  " D:/sis/files/MyApp.rEN "
  " D:/sis/files/MyApp.rZH "
  }-" !:/System/Apps/MyApp/MyApp.rsc " 必要组件校验
  
  此段是校验指定的程序（每个程序在安装时都会在手机端C:/System/install下生成一个同安装程序文件名的SIS文件，也就是校验这个SIS文件是否存在）是否存在，如果不存在，则pkg文件内，此行以下的安装文件将不会被安装
  
  例： ( 0x123456789 ), 1 , 1 , 0 ,{" C Library "," C语言运行库 "}
  1. 0x123456789是指定的SIS文件的UID（用SeleQ查看APP文件属性显示的 UID1；用SmartFileMan显示的 UID1）
  2. 1 , 1 , 0是用于校验到SIS文件不存在时，错误提示中显示的版本号（假设C Library的SIS文件不存在，则会提示“ C Library 1.1不存在，请安装安装后再安装本程序”）。此版本号不限制文件的校验。
  3. {" C Library "," C语言运行库 "}是用于校验到SIS文件不存在时，错误提示中显示的组件标题。
  如果是多语言安装程序，则需要按语言支持区段的语言顺序来依次（就是按 & EN , ZH那个部分的顺序）输入各语言版本下的标题，标题名称用“ ,”分割。 可选附加组件
  如果包含可选附加组件，则SIS文件类型需要相应变成 TYPE= SISOPTION
  单语言： !({" Add-on 1 (20kb) "},{" Add-on 2 (20kb) "})
  
  Add-on 1 (20kb)是第1个附加组件的显示标题， Add-on 2 (20kb)是第2个附加组件的显示标题；依此类推可设置多个附加组件
  
  多语言： !({" Add-on 1 (20kb) "," 附件1 (20kb) "},{" Add-on 2 (20kb) "," 附件2 (20kb) "})
  Add-on 1 (20kb)是 第1个附加组件的 第1种语言的显示标题， 附件1 (20kb)是 第1个附加组件的 第2种语言的显示标题
  Add-on 2 (20kb)是 第2个附加组件的 第2种语言的显示标题， 附件2 (20kb)是 第2个附加组件的 第2种语言的显示标题
  依此类推可设置多个附加组件；多语言安装程序需要按语言支持区段的语言顺序来依次（就是按 & EN , ZH那个部分的顺序）输入各语言版本下的标题，标题名称用“ ,”分割。 条件判断
  
  如果安装程序内包含可选附加组件，则需要此区段的信息，反之则省略
  
  !({" Add-on 1 (20kb) "},{" Add-on 2 (20kb) "})
  
  IF option 1
  " PCSourceFile/addon/MyPic1.gif "-" !:/System/Apps/MyApp/addon/MyPic1.gif "
  ENDIF
  IF option 2
  " PCSourceFile/addon/MyPic2.gif "-" !:/System/Apps/MyApp/addon/MyPic2.gif "
  ENDIF
  
  IF option 1和 ENDIF之间的信息是选择 Add-on 1 (20kb)后的安装结果
  IF option 2和 ENDIF之间的信息是选择 Add-on 2 (20kb)后的安装结果
  依此类推，有几个附件就按照数字的顺序写几个 IF option（ Add-on 1， Add-on 2， Add-on 3相应的应该有 IF option 1， IF option 2， IF option 3） 附加SIS文件
  
  在SIS安装程序中附加的SIS安装程序，可以用于条件判断语句之内（如果在条件判断语句之外则会被自动安装）
  例： @" D:/sis/files/AutoStart.sis ",( 0x12345678 )
  D:/sis/files/AutoStart.sis是 PC端SIS源文件的位置
  0x12345678是该SIS文件的UID（用SeleQ查看APP文件属性显示的 UID1；用SmartFileMan显示的 UID1）