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 task

    11   PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">

    12 <task id="GUID-92459911-6FD1-47D7-8FBD-63BB43106757" xml:lang="en"><title>Installing an installer</title><shortdesc>The Software Installation Framework (SIF) enables you to

    13 create installers for installing software. An installer is generally

    14 made up of an install server and plug-in. The plug-in encapsulates

    15 the logic for the management of the software type and the install

    16 server performs the installation whenever there is a request from

    17 SIF. Installers can be In-ROM (pre-provisioned in the device during

    18 device creation) or Post-Market (installed and registered using USIF

    19 after the device is shipped).</shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

    20 <steps id="GUID-4DD07DEC-6017-4237-BE46-1D69E5FBD744-GENID-1-12-1-5-1-1-6-1-4-1-4-1-4-1-3-1">

    21 <step id="GUID-98FE9F77-6B47-489D-99B1-51FAA5575015"><cmd>To register

    22 the installer with USIF:</cmd>

    23 <substeps id="GUID-AE447EC5-5254-4819-991D-18E54BA09206">

    24 <substep id="GUID-58F469FB-4511-40BC-9DA0-B71CC2E3D0B5"><cmd>For In-ROM

    25 Installers, the developer must inform the AppInstall Package Owner

    26 about the installer details to be configured. For more details, refer<xref href="http://developer.symbian.org/main/source/packages/appinstall" scope="external">Application Installation</xref> </cmd>

    27 <info><p>The installer registration details that must be delivered

    28 to the AppInstall team are <ul id="599B1032-5CD0-4577-9DDA-B754DB4340BA">

    29 <li><p>unique software type name (such as ”native”, “java”)</p></li>

    30 <li><p>Sif plug-in uid ( ECom implementation ID)</p></li>

    31 <li><p> launcher executable (native executable to be used by apparc

    32 to launch non-native applications of given type)</p></li>

    33 <li><p>custom access secure Id(s)</p></li>

    34 <li><p>MIME Type(s)</p></li>

    35 <li><p>localized software type names (optional)</p></li>

    36 </ul></p></info>

    37 </substep>

    38 <substep id="GUID-4C83506C-C334-420E-92BF-84EA613098D0"><cmd>For Post-Market

    39 Installers, the <xref href="GUID-92459911-6FD1-47D7-8FBD-63BB43106757.dita#GUID-92459911-6FD1-47D7-8FBD-63BB43106757/599B1032-5CD0-4577-9DDA-B754DB4340BA">installer details</xref> must be configured using a

    40 Software Type Registration file. This is a<filepath>.xml</filepath> file. The file must be a part of the installer SIS package. For

    41 example, if the package UID is  0x77534946, the Software Type Registration

    42 file must be copied to <filepath>\resource\usif\leestore\77534946.xml</filepath> using the installer package.</cmd>

    43 <info><p>A sample Software Type Registration file is described below.</p><codeblock xml:space="preserve">&lt;?xml version="1.0" encoding="UTF-8"?&gt;

    44 <!DOCTYPE LayeredExecutionEnvironments SYSTEM "swtype.dtd">

    45 <LayeredExecutionEnvironments>

    46 <softwareType name="native">

    47 <localizedName language="15">testSwTypeLoc15</localizedName>

    48 <localizedName language="31">testSwTypeLoc31</localizedName>

    49 <mimeType>binary/sif-testpkg</mimeType>

    50 <sifPluginUid>102866EF</sifPluginUid>

    51 <CustomAcess SecureId="10285BCB" AccessMode="1"/>

    52 <CustomAcess SecureId="80285DE0" AccessMode="1"/>

    53 <launcherExecutable>testLauncherExecutable</launcherExecutable>

    54 </softwareType>

    55 &lt;/LayeredExecutionEnvironments&gt;</codeblock></info>

    56 <info><p>For more details about the install server and the plug-in,

    57 refer to <xref href="GUID-51EDBA17-41AF-58FB-A96F-D5A136F83977.dita">Creating

    58 an Installer</xref>.</p></info>

    59 </substep>

    60 </substeps>

    61 </step>

    62 </steps>

    63 </taskbody></task>