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 concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-7A7254E3-A03A-5B38-B2B5-FFEEE70F5E93" xml:lang="en"><title>Embedded

    13 SIS Files</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>An embedded SIS file is a file that is placed in another SIS file. Embedded

    15 SIS files are useful for packaging multiple components into a single SIS file.

    16 These components can be removed independent of one another. For example, if

    17 a SIS file needs to install an application and a library that is shared with

    18 other installed applications, the shared library can be installed as an embedded

    19 SIS file, so that when the application is uninstalled, the shared library

    20 remains on the Symbian device if required. </p>

    21 <p>Embedded SIS files are installed and removed along with the file that is

    22 embedding the SIS file. However, an embedded SIS file cannot be removed if

    23 another installed component has declared a <xref href="GUID-DB220677-5998-529C-BE35-0D66F588E057.dita">dependency</xref> on

    24 it. This depends on the security policy setting, <codeph>RemoveOnlyWithLastDependent</codeph> defined

    25 in the installation policy file.</p>

    26 

    27 <p>The Nested (embedding and the embedded) SIS files are processed as separate

    28 installations. This means that the Embedding (outer) SIS file does not propagate

    29 capabilities to the embedded (inner) SIS file. However, an Embedding (outer)

    30 SIS file can be dependent on an embedded SIS file. </p>

    31 <p> <b>Note</b>: If the installation of the embedded SIS fails, the entire

    32 installation fails. </p>

    33 <p>An embedded SIS file can be a partial upgrade (<codeph>PU</codeph>) or

    34 patch upgrade (<codeph>SP</codeph>) package type. However, the base package

    35 must have already been installed on the Symbian device. This implies that

    36 if the base package and the upgrade are both embedded in the same SIS file,

    37 the statement that installs the base package must occur in the source PKG

    38 file before the statement that installs the upgrade or patch. </p>

    39 </conbody></concept>