10 <!DOCTYPE reference |
10 <!DOCTYPE reference |
11 PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd"> |
11 PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd"> |
12 <reference id="GUID-63293544-EACF-5F55-BBB5-7A471B4F9A69" xml:lang="en"><title>PKG |
12 <reference id="GUID-63293544-EACF-5F55-BBB5-7A471B4F9A69" xml:lang="en"><title>PKG |
13 File Format for Preinstallation</title><abstract><p>The SIS files that are installed using <codeph>InterpretSIS</codeph> can |
13 File Format for Preinstallation</title><abstract><p>The SIS files that are installed using <codeph>InterpretSIS</codeph> can |
14 be configured to be non-removable. If an attempt is made to uninstall a non-removable |
14 be configured to be non-removable. If an attempt is made to uninstall a non-removable |
15 package, an error (<codeph>KErrNotSupported</codeph>) is reported to the UI. |
15 package, an error (<codeph>KErrNotSupported</codeph>) is reported to the UI.</p><p>You |
16 In the package header for non-removable packages, an additional <xref href="GUID-D9D20EE0-AC86-512A-91C0-EA0ACF3912A7.dita#GUID-D9D20EE0-AC86-512A-91C0-EA0ACF3912A7/GUID-3C2E7248-23BD-5A9C-BC4F-2F86B1A94002">package-type</xref> of <codeph>NR</codeph> must be specified. For example: </p> <codeblock id="GUID-036D2CCE-53A0-55BC-AB45-6F9265B49CD4" xml:space="preserve">#{"PackageName"}, (0x80000001), 1, 2, 3, TYPE=SA, NR</codeblock> <p>InterpretSIS |
16 can generate a non-removable package using <codeph>InterpretSIS</codeph> by |
17 is the preferred mechanism to install non-removable base packages, as Software |
17 specifying the <codeph>+nonremovablepkg</codeph> within the <codeph>-s</codeph> option. |
|
18 For details, see <xref href="GUID-882DCE58-5E5F-44D2-9E84-093709EAA4BE.dita#GUID-882DCE58-5E5F-44D2-9E84-093709EAA4BE/GUID-E9CC4D6D-599D-4F89-AE0A-448B6D2D11F3">Generating |
|
19 non-removable installation package through command line</xref>.</p> <p><codeph>InterpretSIS</codeph> is |
|
20 the preferred mechanism to install non-removable base packages, as Software |
18 Installer only allows you to install a NR base package if it has been signed |
21 Installer only allows you to install a NR base package if it has been signed |
19 using the System Upgrade certificate. If an attempt is made to install a non-removable |
22 using the System Upgrade certificate. If an attempt is made to install a non-removable |
20 base package not signed with a SU cert using the software installer, an error |
23 base package not signed with a SU cert using the software installer, an error |
21 (<codeph>KErrNotSupported</codeph>) is returned. </p><note>When replacing |
24 (<codeph>KErrNotSupported</codeph>) is returned. </p><note> When replacing |
22 or upgrading a non-removable base package using the software installer, the |
25 or upgrading a non-removable base package using the software installer, the |
23 upgrade package must also be non-removable. See <xref href="GUID-474A9F80-2B3E-5D11-8D2E-95E217BEB84A.dita">Preinstalled |
26 upgrade package must also be non-removable. See <xref href="GUID-474A9F80-2B3E-5D11-8D2E-95E217BEB84A.dita">Preinstalled |
24 Package Upgrades</xref> for more information. </note> <p>The following restrictions |
27 Package Upgrades</xref> for more information. </note> <p>The following restrictions |
25 apply to the syntax of the PKG files used to create the SIS files for input |
28 apply to the syntax of the PKG files used to create the SIS files for input |
26 to <codeph>InterpretSIS</codeph>: </p> <ul> |
29 to <codeph>InterpretSIS</codeph>: </p> <ul> |