1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE reference

    11   PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">

    12 <reference xml:lang="en" id="GUID-255653B8-DACF-552C-8F33-7F6552824F4F"><title>Embedded SIS</title><shortdesc>An embedded SIS file is a file that is embedded in another SIS files. A SIS file can contain multiple embedded SIS files. </shortdesc><prolog><metadata><keywords/></metadata></prolog><refbody><refsyn><title>Syntax</title> <p>To include a SIS file within another SIS file, the PKG file must specify the name and location of the embedded install files along with their package UID, prefixed with the <codeph>@</codeph> symbol. </p> <codeblock id="GUID-CAF95CA2-823E-5D3F-9AA1-5C43FBE56D04" xml:space="preserve">@"source-filename", (package-uid)</codeblock> <p>For example: </p> <codeblock id="GUID-F861B457-A92F-5B2C-9833-AE182580BADD" xml:space="preserve">IF NOT package(0xE8000097)

    13 ; install minimal.sis only if not already installed

    14 @"minimal.sis", (0xE8000097)

    15 endif</codeblock> <p>During installation, <filepath>minimal.sis</filepath> is extracted and installed, unless it has already been installed. </p> <p>The <codeph>package()</codeph> function must be used only if you have to install an embedded package if it has not already been installed. For more information on Embedded SIS files see, <xref href="GUID-7A7254E3-A03A-5B38-B2B5-FFEEE70F5E93.dita">Embedded SIS Files</xref>. </p> <p>Language-specific embedded SIS files can be included in a language block, as shown in the following example: </p> <codeblock id="GUID-D09CD6DF-A680-5370-AA1C-6B2CE740D965" xml:space="preserve">{

    16 @"foo_en.sis"

    17 @"foo_fr.sis"

    18 @"foo_ge.sis"

    19 },(0x11223344)</codeblock> </refsyn> <section id="GUID-CA9350B6-832E-5CD0-95A6-8564FAD2DB6D"><title>Example</title> <ul><li id="GUID-E4AA1E8E-E421-5EA5-8565-CF4F6E9B1F78"><p>Example to illustrate an embedded SIS file within the parent SIS file </p> <codeblock id="GUID-B6DEBB50-2183-599A-AD74-694242296FD8" xml:space="preserve">; A SIS file which embeds another

    20 

    21 ;Languages

    22 &EN,GE

    23 

    24 ;Header

    25 #{"Embedding-EN", "Embedding-GE"}, (0x10000017), 1, 2, 3

    26 

    27 %{"Vendor", "Verkaufer"}

    28 :"Vendor"

    29 

    30 ;Embedded component

    31 IF NOT package(0x80000002)

    32 @"sub.sis",(0x80000002)

    33 endif

    34 

    35 ;Ordinary file to system drive

    36 {

    37 "text\englishfile.txt"

    38 "text\germanfile.txt"

    39 }-"$:\private\10000018\import\lang.txt"

    40 

    41 ;Ordinary file to selected drive

    42 "text\file1.txt"-"!:\private\10000018\import\file1.txt"

    43 

    44 ;Display a text file

    45 "text\textfilec.txt"-"", FT, TC</codeblock> </li> <li id="GUID-C0917322-85C3-5D5C-8B8F-3944F8EB4A89"><p>Example to illustrate the format of the SIS file that needs to be embedded into another file </p> <codeblock id="GUID-9AC3E987-EA8E-53D0-80F8-F9CA56F0781B" xml:space="preserve">; A SIS file which is embedded in another

    46 

    47 ;Languages

    48 &EN,GE

    49 

    50 ;Header

    51 #{"Sub-EN", "Sub-GE"}, (0x80000002), 1, 2, 3

    52 

    53 %{"Vendor", "Verkaufer"}

    54 :"Vendor"

    55 

    56 ;Ordinary file to fixed drive

    57 {

    58 "text\englishfile.txt"

    59 "text\germanfile.txt"

    60 }-"C:\private\80000003\import\InstTest\sub-lang.txt"

    61 

    62 ;Ordinary file to selected drive

    63 "text\file1.txt"-"!:\private\80000003\import\InstTest\sub-file1.txt", FF

    64 

    65 ;Display a text file

    66 "text\textfilesc.txt"-"", FT, TC</codeblock> </li> </ul> </section> </refbody></reference>