PKG語法詳細說明 常用高級選項

連接：http://www.yuelongr.cn/post/880.html

另一篇PKG文章鏈接：

[symbian編程中pkg文件詳細解密](http://www.yuelongr.cn/post/39.html)

Contents

1 文本警告

2 多語言文本提示

3 刪除運行時生成的文件

4 內嵌SIS文件

5 在安裝或卸載時運行執行文件

6 必備程序選項

7 語言支持

8 手機支持

9 安裝特定手機所需文件

10 安裝指定平臺的文件

11 安裝條件

12 外部鏈接

13 內部鏈接

 

 

文本警告

在安裝時你可以指定一段文本顯示，這段文本不會復制到手機上，只是在安裝時顯示需知信息或相關協議。在pkg中增加如下代碼：

"license.txt" - "", FILETEXT, TEXTCONTINUE

FILETEXT 表明這個文件在安裝時顯示. TEXTCONTINUE提供了一個“繼續”按鈕用來關閉文本內容，繼續安裝程序。

你也可以將TEXTCONTINUE替換為如下選項：

• TEXTSKIP 顯示“是/否”選項，如果選擇是，那么就會繼續安裝，如果選擇否，那么下段文本就會跳過，但安裝還是會正常繼續。

• TEXTEXIT 顯示“是/否”選項，如果選擇是，那么安裝就會繼續，反之安裝就會終止，任何你已安裝的文件會被移除。

• TEXTABORT 顯示“是/否”選項，如果選擇否，那么安裝會終止，但是已經安裝的將不會刪除，刪除運行時生成的文件。

 

多語言文本提示

文本提示的語言可以根據手機缺省語言自己適配，如：

IF (LANGUAGE=2) ; If the language is French, then display mytext.t02
"mytext.t02"-"", FILETEXT, TEXTABORT
ELSEIF (LANGUAGE=3) ; If the language is German, then display mytext.t03
"mytext.t03"-"", FILETEXT, TEXTABORT
ELSE ; Otherwise display mytext.t01
"mytext.t01"-"", FILETEXT, TEXTABORT
ENDIF

上述示例當手機缺省語言為法語時將顯示mytext.t02，當為德語時則顯示mytext.t03，其他語種則為mytext.t01

此外，你需要有相應語言定義在PKG

;Language - standard language definitions
&EN,FR,GE

 

刪除運行時生成的文件

當你要卸載一個sis文件時，卸載程序將會移除所有在安裝時已經拷貝到手機上的文件。但那些運行時生成的文件怎么辦？

如果程序生成文件名在安裝時就要知道，那么需要在pkg文件中增加'null files'，pkg中這些文件的格式（與語言無關）如下：

"" - "C\system\data\my_runtime_generated_file", FILENULL

這里my_runtime_generated_file是個程序生成的文件，FN(FILENULL)參數表示這個文件尚未存在，所以沒有包含在sis文件中。是程序運行時才會生成的，而在程序卸載時將會被刪除。注意源文件并不重要，只要為空即可（""）。同樣注意這個文件在升級為新版時不會被刪除，這樣就可以確保一些如ini等存儲程序參數的文件不會在升級時丟失。

FILENULL選項在Symbian OS v9.x中并不支持，建議開發者在程序的data cage中生成文件，這樣可以在卸載時徹底刪除。

如果程序生成文件的數目（或文件名）不可知，這樣的情況就比較復雜了。有一個解決方案，sis可以包含一個卸載程序，可以用來查找并刪除相關文件。這樣程序需要在卸載時自動運行它：

"\epoc32\release\armi\urel\uninst.app" - "!:\system\apps\myapp\uninst.app", RR, RW

RR (RUNREMOVE)參數設置該文件在卸載時自動運行. RW (RUNWAITEND)表明系統將會等待該程序完成后才繼續卸載過程。

 

內嵌SIS文件

你可以包含另一個sis文件，按照如下代碼設置：

@”sis file name”,(UID)

例如@”prog1.sis”,(0x12341234)表示安裝prog1.sis，它的UID為0x12341234。注意在卸載時，這里內嵌的sis將要等系統判定沒有其他程序使用它才會被刪除（即沒有其他安裝組件包括這個內嵌sis在他們的pkg文件中）

 

在安裝或卸載時運行執行文件

你可以在指定可執行文件那行的末尾添加FILERUN (FR)和RUNINSTALL (RI)讓它在安裝時運行

例如:

"\Symbian\9.1\S60_3rd_MR\Epoc32\release\gcce\urel\myprogram.exe"-"!:\sys\bin\myprogram.exe",FR,RI

將會安裝myprogram.exe，并在安裝過程執行它。這里RUNINSTALL關鍵字也可以被下列選項取代：

• RUNREMOVE (RR) 指定程序只在卸載時執行它；

• RUNBOTH (RB)在安裝和卸載時都要執行這個程序

上述三個選項最好配以RUNWAITEND (RW)關鍵字，它指明安裝程序要等候該程序執行完畢再繼續。如果沒有指明這個關鍵字，那么程序啟動后，安裝就將繼續了。

FILERUN (FR) RUNINSTALL (RI) 選項無法工作于自簽名軟件，它需要一個受信簽名(Open Signed Online or Open Signed Offline during R&D stage and Symbian Signed when

released)，否則程序所需能力將不能得以安裝。

 

必備程序選項

你可以指定一個必備程序選項，它表明系統必須先安裝有它，才能繼續下面的安裝，它的格式如下：

{UID}, Major_Version_#,Minor_Version_#,Build_#,{“Product Name”}

它表明這個組件的UID和名稱，以及所需最早版本號，否則將不能繼續下面的安裝。

例如:

{0x10000123},1,0,0,{"MyDll"}

表明組件名為MyDll，UID為0x10000123，以及最小版本號1.0.0，表明系統至少要安裝有該版本。必備程序選項也可以如下，這里表明所需的目標平臺：

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

這里所需的組件就是Series60ProductID, 而版本號至少為0.0.0或更高，都是安裝所必需的條件。

從第三版開始，S60平臺標識將顯示在方括號中，具體如下：

[0x101F7961], 0, 0, 0, {"S60ProductID"}

備注：第五版必須是[0x1028315F]否則在安裝的過程中會提示版本不兼容的問題。 

語言支持

程序可以多個語言版本，而只要一個sis包即可。當用戶安裝sis文件時，將被提示選擇安裝語言。要增加語言，就要在你的pkg文件里添加語言支持行。它以&開始，包含下列語言列表中的一個：

AM– US English

AS – Austrian German

AU – Australian English

BF – Belgian French

BL – Belgian Flemish

CS – Czech

DA – Danish

DU – Dutch

EN – UK English

FI – Finnish

FR – French

GE – German

HK – Hong Kong Chinese

HU – Hungarian

IC – Icelandic

IF – International French

IT – Italian

JA – Japanese

NO – Norwegian

NZ – New Zealand

PL – Polish

PO – Portuguese

RO - Romanian

RU – Russian

SF – Swiss French

SG – Swiss German

SK – Slovak

SL – Slovenian

SP – Spanish

SW – Swedish

TC – Taiwan Chinese

TH – Thai

TU – Turkish

ZH – Prc Chinese

下面是一個實例:

&EN, FR, FI

它表明sis包含有英語，法語和芬蘭語，如果沒有語言項，則&EN是默認的。

 

手機支持

我們有可能需要指明安裝程序只為部分手機支持。如，如果一個程序需要WiFi，那么就只能安裝到有wifi的手機。如果到非wifi手機，那么安裝將顯示一個警告表示程序不兼容。

下列代碼演示了程序只能安裝到Nokia N80, N93, N93和N95手機上。

[0x200005F9], 0, 0, 0, {"Nokia N80 ID"}
[0x20000600], 0, 0, 0, {"Nokia N93 ID"}
[0x20000605], 0, 0, 0, {"Nokia N93i ID"}
[0x2000060B], 0, 0, 0, {"Nokia N95 ID"}

手機型號的標識可以參考S60 Platform and device identification codes.

 

安裝特定手機所需文件

可能我們的部分安裝文件需要依賴用戶手機而定，例如一個游戲開發者可能需要生成一個指定的DLL，以便支持3D加速。那么對沒有3D加速的手機，

就只能安裝標準的DLL，示例代碼如下：

IF (MachineUID=0x20000600) OR (MachineUID=0x2000060B)
 
 ; If the device is Nokia N93 or N95, then install files in this block.
"\epoc32\release\armv5\urel\mydll_3d" -"!:\sys\bin\mydll.dll"
 
ELSE
 
 ; Otherwise install any files in this block.
"\epoc32\release\armv5\urel\mydll" -"!:\sys\bin\mydll.dll"
 
ENDIF

手機標識代碼可以在這里找到S60 Platform and device identification codes.

 

安裝指定平臺的文件

可能我們部分安裝文件依賴于手機的操作系統，例如第三版FP2就去掉了一些藍牙連接庫，這樣的不同導致我們在安裝時也需要區別對待，手機平臺可以在z:\system\install文件夾中獲?。?/font>

if exists("z:\system\install\Series60v3.2.sis")
"\Epoc32\release\gcce\UREL\Common_0x123123123_fp2.dll"-"C:\sys\bin\common_0x123123123.dll"
else
"\Epoc32\release\gcce\UREL\Common_0x123123123.dll"-"C:\sys\bin\common_0x123123123.dll"
endif

 

安裝條件

下列函數也可以使用在pkg中:

package()用來測試一個安裝包是否存在；

exists()用來測試給定文件是否存在

appprop()獲得注冊表中的相關屬性

DevProp()函數用來詢問手機能力值，注意不是直接提供的名字屬性
 

package():如果指定UID已經安裝將返回true，否則返回false，下列代碼表示如果UID為0x11223344那么將安裝foo.txt文件

IF package(0x11223344)
"foo.txt"-"c:\foo.txt"
ENDIF

exists(): 如果test.txt存在則返回true，將安裝新的

if exists("c:\test.txt")
"text\exists.txt"-"!:\private\0x01234567\exists.txt"

appprop(): 該函數的第一個參數是package UID.第二個參數是獲取的propid(property id). 下列代碼測試了其他包的能力

;Dependencies
(0x10000003), 1, 2, 3, {"Depend-EN"}
 
if (appprop(0x10000003,0) = 1)
"text\appprop1.txt"-"!:\Documents\appprop1.txt"
elseif (appprop(0x10000003,0) = 2)
"text\appprop2.txt"-"!:\Documents\appprop2.txt"
endif

DevProp(): 手機支持能力函數，它提供了直接訪問HAL API的能力，即HAL::Get()函數。這個函數可以有條件項使用，用來詢問手機的能力。注意這個能力不是名字屬性

+(0=1,1=2,3=-1)
 
if DevProp(1)
"text\appprop1.txt"-"", FT, TC
endif