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 id="GUID-8B91B12A-2275-52BF-B747-914550E225D0" xml:lang="en"><title>Console-based

    13 SWI Tool Reference</title><abstract><p>Console-based SWI tool is used to install or uninstall native

    14 software on the device using an EShell interface. </p><p> <b>Note</b>: The

    15 following sections are applicable only for S60 emulator.</p></abstract><prolog><metadata><keywords/></metadata></prolog><refbody>

    16 <section><title>Installing a SIS file using console-based SWI example</title><p>If

    17 you want to install <filepath>simple.sis</filepath> file on the device then,

    18 place this file at <codeph>epoc32\winscw\c</codeph> and perform the following

    19 steps: </p> <ol id="GUID-FB6A5CA8-7882-54D5-962E-E0FADCDB27EB">

    20 <li id="GUID-B8571A5E-A306-5157-8380-CDCAA53724EE"><p>Launch EShell within

    21 the S60 emulator and enter <codeph>swiconsole /i                 c:\simple.sis</codeph>.

    22 The following screenshot appears which displays the application details and

    23 provides the following options: </p> <fig id="GUID-66ADA2C6-F1C2-5ACE-9434-F18D0BC7D6C1">

    24 <image href="GUID-6B231E96-CD4B-5D8E-9AAC-D533784E0E3B_d0e20509_href.jpg" placement="inline"/>

    25 </fig> </li>

    26 <li id="GUID-D31262D9-A59B-5461-9A72-A7E6E93B6AA5"><p>Press <b>y</b>, the

    27 signature is validated and installation continues only if the signature is

    28 valid. The following screenshot shows that the signature has been validated

    29 successfully and allows the user to continue with the installation. </p> <fig id="GUID-90086889-B023-572E-9BFB-4D518BDCF4C0">

    30 <image href="GUID-66CF7E30-010D-5A7A-95EF-41620CD49BF9_d0e20522_href.jpg" placement="inline"/>

    31 </fig> </li>

    32 <li id="GUID-75750A14-4358-5683-8054-5AAB16F31B55"><p>Press <b>y</b> to continue

    33 installation and select the drive you want to install. </p> <fig id="GUID-537B05D6-9F31-5461-B212-8E3168572831">

    34 <image href="GUID-8C5F32CC-CA2A-586A-B3B1-339494255042_d0e20535_href.jpg" placement="inline"/>

    35 </fig> </li>

    36 <li id="GUID-68BAE41E-C692-5559-B7D2-38C7C1D1ACEA"><p>Press <b>n</b> to continue

    37 with the installation. The following screenshot shows that the installation

    38 is completed successfully. </p> <fig id="GUID-B487223A-9EB8-5A27-82CA-6F6308F8DA11">

    39 <image href="GUID-8C826292-C8DC-55CA-A79F-3254A417BF64_d0e20548_href.jpg" placement="inline"/>

    40 </fig> </li>

    41 </ol> <p> <b>Result</b>: The <filepath>simple.sis</filepath> file is successfully

    42 installed on the device. </p>  </section>

    43 <section><title>Uninstalling a SIS file using console-based SWI example</title> <p>If

    44 you want to uninstall <filepath>simple.sis</filepath> file from the device

    45 then, enter the following command on eshell:</p><p><userinput>swiconsole /u

    46 /uid 80008880 /pkg testrun_exe /vendor &lt;Unique Vendor Name&gt;</userinput> </p> <p> <b>Result</b>:

    47 The <filepath>simple.sis</filepath> file is successfully uninstalled from

    48 the device. </p> </section>

    49 </refbody><related-links>

    50 <link href="GUID-DA8908E9-28C7-5200-A5B2-EC1ED60ABE90.dita"><linktext>Using Console-based

    51 SWI</linktext></link>

    52 </related-links></reference>