Symbian3/PDK/Source/GUID-8B91B12A-2275-52BF-B747-914550E225D0.dita
author Dominic Pinkman <dominic.pinkman@nokia.com>
Fri, 16 Jul 2010 17:23:46 +0100
changeset 12 80ef3a206772
parent 9 59758314f811
child 14 578be2adaf3e
permissions -rw-r--r--
Week 28 contribution of PDK documentation content. See release notes for details. Fixes bugs Bug 1897, Bug 344, Bug 2681, Bug 463, Bug 1522.

<?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 reference
  PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
<reference id="GUID-8B91B12A-2275-52BF-B747-914550E225D0" xml:lang="en"><title>Console-based
SWI Tool Reference</title><abstract><p>Console-based SWI tool is used to install or uninstall native
software on the device using an EShell interface. </p><p> <b>Note</b>: The
following sections are applicable only for S60 emulator.</p></abstract><prolog><metadata><keywords/></metadata></prolog><refbody>
<section><title>Installing a SIS file using console-based SWI example</title><p>If
you want to install <filepath>simple.sis</filepath> file on the device then,
place this file at <codeph>epoc32\winscw\c</codeph> and perform the following
steps: </p> <ol id="GUID-FB6A5CA8-7882-54D5-962E-E0FADCDB27EB">
<li id="GUID-B8571A5E-A306-5157-8380-CDCAA53724EE"><p>Launch EShell within
the S60 emulator and enter <codeph>swiconsole /i                 c:\simple.sis</codeph>.
The following screenshot appears which displays the application details and
provides the following options: </p> <fig id="GUID-66ADA2C6-F1C2-5ACE-9434-F18D0BC7D6C1">
<image href="GUID-6B231E96-CD4B-5D8E-9AAC-D533784E0E3B_d0e22942_href.jpg" placement="inline"/>
</fig> </li>
<li id="GUID-D31262D9-A59B-5461-9A72-A7E6E93B6AA5"><p>Press <b>y</b>, the
signature is validated and installation continues only if the signature is
valid. The following screenshot shows that the signature has been validated
successfully and allows the user to continue with the installation. </p> <fig id="GUID-90086889-B023-572E-9BFB-4D518BDCF4C0">
<image href="GUID-66CF7E30-010D-5A7A-95EF-41620CD49BF9_d0e22955_href.jpg" placement="inline"/>
</fig> </li>
<li id="GUID-75750A14-4358-5683-8054-5AAB16F31B55"><p>Press <b>y</b> to continue
installation and select the drive you want to install. </p> <fig id="GUID-537B05D6-9F31-5461-B212-8E3168572831">
<image href="GUID-8C5F32CC-CA2A-586A-B3B1-339494255042_d0e22968_href.jpg" placement="inline"/>
</fig> </li>
<li id="GUID-68BAE41E-C692-5559-B7D2-38C7C1D1ACEA"><p>Press <b>n</b> to continue
with the installation. The following screenshot shows that the installation
is completed successfully. </p> <fig id="GUID-B487223A-9EB8-5A27-82CA-6F6308F8DA11">
<image href="GUID-8C826292-C8DC-55CA-A79F-3254A417BF64_d0e22981_href.jpg" placement="inline"/>
</fig> </li>
</ol> <p> <b>Result</b>: The <filepath>simple.sis</filepath> file is successfully
installed on the device. </p>  </section>
<section><title>Uninstalling a SIS file using console-based SWI example</title> <p>If
you want to uninstall <filepath>simple.sis</filepath> file from the device
then, enter the following command on eshell:</p><p><userinput>swiconsole /u
/uid 80008880 /pkg testrun_exe /vendor &lt;Unique Vendor Name&gt;</userinput> </p> <p> <b>Result</b>:
The <filepath>simple.sis</filepath> file is successfully uninstalled from
the device. </p> </section>
</refbody><related-links>
<link href="GUID-DA8908E9-28C7-5200-A5B2-EC1ED60ABE90.dita"><linktext>Using Console-based
SWI</linktext></link>
</related-links></reference>