Package (pkg) files specify the information required to
create sis files. The package files are stored in the project's sis folder.
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.
The HelloWorldBasic.pkg file is as follows:
; helloworldbasic_gcce.pkg
;
;Language - standard language definitions
&EN,FI,ZH,JA
; standard SIS file header
#{"HelloWorldBasic", "HelloWorldBasic", "HelloWorldBasic", "HelloWorldBasic"},(0xA000017F),1,0,0
;Localised Vendor name
%{"Vendor-EN", "Vendor-FI", "Vendor-ZH", "Vendor-JA"}
;Unique Vendor name
:"Vendor"
;Supports Series 60 v 3.0
[0x101F7961], 0, 0, 0, {"S60ProductID", "S60ProductID", "S60ProductID", "S60ProductID"}
;Files to install
"..\..\..\epoc32\release\gcce\urel\HelloWorldBasic.exe" -"!:\sys\bin\HelloWorldBasic.exe"
{
"..\..\..\epoc32\data\z\resource\apps\HelloWorldBasic.rsc"
"..\..\..\epoc32\data\z\resource\apps\HelloWorldBasic.r09"
"..\..\..\epoc32\data\z\resource\apps\HelloWorldBasic.r31"
"..\..\..\epoc32\data\z\resource\apps\HelloWorldBasic.r32"
} -"!:\resource\apps\HelloWorldBasic.rsc"
"..\..\..\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"
;required for application to be covered by backup/restore facility
"backup_registration.xml" -"!:\private\A000017F\backup_registration.xml"
The meaning of the lines is as follows:
; 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, Simplified Chinese, 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 Application UIDs 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.
;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 Application UIDs.
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.
For more information on creating pkg files, see Package file format.