Symbian3/SDK/Source/GUID-AED57265-6106-4217-ADE6-1327CA3FDE7E.dita
changeset 7 51a74ef9ed63
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-AED57265-6106-4217-ADE6-1327CA3FDE7E.dita	Wed Mar 31 11:11:55 2010 +0100
@@ -0,0 +1,63 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
+<!-- This component and the accompanying materials are made available under the terms of the License 
+"Eclipse Public License v1.0" which accompanies this distribution, 
+and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
+<!-- Initial Contributors:
+    Nokia Corporation - initial contribution.
+Contributors: 
+-->
+<!DOCTYPE concept
+  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-AED57265-6106-4217-ADE6-1327CA3FDE7E" xml:lang="en"><title>PKG
+file format to support simple installation</title><abstract><p>The simplest installation file supports a single language version
+only and requires no special capabilities. It installs a fixed list of files
+to the Symbian device and is self-signed. The PKG file must contain
+the following elements: </p> <ul>
+<li id="GUID-9B77CB46-60E1-56CE-8232-BD279E17335F"><p><xref href="GUID-0BE71FC3-4759-50FC-A74F-C3DD42C9FCED.dita">Languages</xref>  </p> </li>
+<li id="GUID-D049FACA-2B95-5705-893F-A4E048112815"><p><xref href="GUID-7664A4D4-C24B-5225-9E0B-7A021DA6A3AF.dita">Vendor
+Names</xref>  </p> </li>
+<li id="GUID-294AFEF8-DD71-5EB0-930B-DC120BDB9879"><p><xref href="GUID-D9D20EE0-AC86-512A-91C0-EA0ACF3912A7.dita">Package-Header</xref>  </p> </li>
+<li id="GUID-28A5B022-61FF-59A2-B003-4F67E8A5D6E7"><p><xref href="GUID-FF39192E-9C93-593F-8F47-DB18DB876F6F.dita">Installation
+Files</xref>  </p> </li>
+</ul> </abstract><prolog><metadata><keywords/></metadata></prolog><conbody>
+<section id="GUID-072DCCAD-86E8-491C-B29C-3F776AEF9456"><title>Example</title><p>The following PKG file is provided in <filepath>examples\HelloWorld\</filepath>.
+The associated files are built from the source code located in the same directory.
+See <xref href="GUID-F64B88E0-49DA-5563-896E-29BAB8A244C9.dita">here</xref> for
+information. </p> <codeblock id="GUID-2541A514-BAA9-54E6-8927-2F0044F28D5B" xml:space="preserve">; List of languages supported
+&amp;EN
+
+; List of localised vendor names
+%{"Nokia Corporation"}
+; Single, non-localised (global) vendor name
+:"Nokia Corporation"
+
+; Package header format: Package Name, UID, Major version, Minor Version, Build Number
+#{"Minimal application"},(0xE8000091),1,0,0
+
+; Files to install for the minimal application: "Files located on PC" - "Target location on the Symbian device"
+"HelloWorld.exe"-"!:\sys\bin\HelloWorld.exe"
+"HelloWorld.rsc"-"!:\resource\apps\HelloWorld.rsc"
+"HelloWorld.mbm" - "!:\resource\apps\HelloWorld.mbm"
+"HelloWorld_reg.rsc" - "!:\private\10003a3f\import\apps\HelloWorld_reg.rsc"</codeblock> <p> <b>Notes</b>: </p> <ul>
+<li id="GUID-44A14482-9E1F-58FE-B09E-90E57A88CB55"><p>The package UID is used
+to uniquely identify the package. It can be requested in the same way as an
+application's third UID, through https://www.symbiansigned.com or for convenience
+it can use the same value as the application's third UID </p> </li>
+<li id="GUID-A04BA1AD-6933-5F4B-A405-6F0D8E9862FB"><p>By default, the contents
+of SIS files are compressed. This can be prevented by using the <codeph>NOCOMPRESS</codeph> option
+in the PKG header. Specifying <codeph>NOCOMPRESS</codeph> is not recommended
+unless you are installing files that are already compressed, for example JPEGs. </p> </li>
+<li id="GUID-9CA46545-2DDD-5257-B9D0-A14097DAC422"><p>The package major and
+minor version numbers are required for version control. </p> </li>
+<li id="GUID-993965FB-D45C-5891-8535-8154E584F554"><p>The build number must
+be incremented whenever the component is rebuilt. </p> </li>
+<li id="GUID-5728DA6F-AF8C-557F-91BF-301C8C0E937C"><p>The <codeph>!</codeph> character
+must be used as the target drive letter to allow the Symbian device user select
+the target drive during installation. To prevent the Symbian device user from
+being able to select the target drive, <codeph>$</codeph> can be used, to
+denote the system drive. </p> </li>
+<li id="GUID-B5916D13-9177-5205-A027-005F1EE8B2E5"><p>If folders in the target
+installation path do not exist, they are automatically created by the installer. </p> </li>
+</ul></section>
+</conbody></concept>
\ No newline at end of file