<?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-7A7254E3-A03A-5B38-B2B5-FFEEE70F5E93" xml:lang="en"><title>Embedded

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

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

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

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

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

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

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

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

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

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

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

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

in the installation policy file.</p>

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

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

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

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

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

installation fails. </p>

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

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

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

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

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

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

</conbody></concept>