HelloWorldBasic .pkg file

Package (pkg) files specify the information required to create sis files.

This example uses the package file for the release build created with the GCCE compiler. Since the outputs for each compiler are different, you need a package file for each type of release that you make.

; helloworldbasic_gcce.pkg
;

Comment used to indicate which package file this is. For more information, see "Building".

;Language - standard language definitions
&EN,FI,ZH,JA

The HelloWorldBasic application supports UK English, Finnish, Chinese for the People's Republic of China, and Japanese, and thus they are declared here. For the list of the language codes that can be used here, see (language code table) in the Symbian OS Library.

; standard SIS file header
#{"HelloWorldBasic", "HelloWorldBasic", "HelloWorldBasic", "HelloWorldBasic"},(0xA000017F),1,0,0

The name of the application in each supported language, the UID of the application, and version number for this application are declared here. Note that there needs to be the same number of names for the application as there are languages declared.

;Localised Vendor name
%{"Vendor-EN", "Vendor-FI", "Vendor-ZH", "Vendor-JA"}

Vendor name for each language supported by the application. Note that the languages are listed in the same order as the languages were declared. For more information, see Vendor in the Symbian OS Library.

;Unique Vendor name
:"Vendor"

Non-localised vendor name, which is used along with signing to prevent unauthorised upgrades of a package by someone who is not the actual vendor.

;Supports S60 v 3.0
[0x101F7961], 0, 0, 0, {"S60ProductID", "S60ProductID", "S60ProductID", "S60ProductID"}

0x101F7961 is the platform UID for the S60 3rd Edition platform version. For more information on UIDs, see "UID". The example does not assign a version number to the package. In addition, the component is given the same name for each language.

;Files to install
"..\..\..\epoc32\release\gcce\urel\HelloWorldBasic.exe" -"!:\sys\bin\HelloWorldBasic.exe"

"..\..\..\epoc32\data\z\resource\apps\HelloWorldBasic.rsc" -"!:\resource\apps\HelloWorldBasic.rsc"
"..\..\..\epoc32\data\z\resource\apps\HelloWorldBasic.r09" -"!:\resource\apps\HelloWorldBasic.r09"
"..\..\..\epoc32\data\z\resource\apps\HelloWorldBasic.r31" -"!:\resource\apps\HelloWorldBasic.r31"
"..\..\..\epoc32\data\z\resource\apps\HelloWorldBasic.r32" -"!:\resource\apps\HelloWorldBasic.r32"

"..\..\..\epoc32\data\z\private\10003a3f\import\apps\HelloWorldBasic_reg.rsc" -"!:\private\10003a3f\import\apps\HelloWorldBasic_reg.rsc"
"..\..\..\epoc32\data\z\resource\apps\helloworldbasic_aif.mif" -"!:\resource\apps\helloworldbasic_aif.mif"

This block tells the sis file creation tool where the files of the HelloWorldBasic application are on the development PC, and where each file should go in the device. The ! character indicates that the user can choose whether to install the application to the target device's c-drive or to the memory card.

;required for application to be covered by backup/restore facility
"backup_registration.xml"
"!:\private\A000017F\backup_registration.xml"

This statement includes the backup_registration.xml configuration file to support the backup of data to and the restoration from a compatible connected PC. The backup registration file is always installed to the application's private folder, private<SECUREID>.

For more information on this backing up and restoring, see How-To Write Backup-aware Software in the Symbian OS Library.

For more information on creating pkg files, see Package file format in the Symbian OS Library.