org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-2A74FA05-A13B-4133-8E1A-03152B6B1499.html
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/><meta name="copyright" content="(C) Copyright 2009"/><meta name="DC.rights.owner" content="(C) Copyright 2009"/><meta name="DC.Type" content="concept"/><meta name="DC.Title" content="Testing your widget"/><meta name="abstract" content="Test your widget on a compatible S60 mobile device. Alternatively, you can first use an emulator provided with the S60 C++ SDK and then perform the final testing on the target device."/><meta name="description" content="Test your widget on a compatible S60 mobile device. Alternatively, you can first use an emulator provided with the S60 C++ SDK and then perform the final testing on the target device."/><meta name="DC.Relation" scheme="URI" content="GUID-B584CA90-543B-4AED-B134-A3A616259DB9"/><meta name="DC.Relation" scheme="URI" content="GUID-63F4E17E-8895-4054-82AD-762B90610B30"/><meta name="DC.Relation" scheme="URI" content="GUID-1EFD7043-E9B8-4B4E-9EA6-A20B3EECC14A"/><meta name="DC.Format" content="XHTML"/><meta name="DC.Identifier" content="GUID-2A74FA05-A13B-4133-8E1A-03152B6B1499"/><title>Testing your widget </title><script type="text/javascript">
function initPage() {}
</script><link href="../PRODUCT_PLUGIN/book.css" rel="stylesheet" type="text/css"/><link href="css/s60/style.css" rel="stylesheet" type="text/css" media="all"/></head><body onload="initPage();"><div class="body"><div class="contentLeft prTxt"><h1 class="pageHeading" id="GUID-2A74FA05-A13B-4133-8E1A-03152B6B1499">Testing your widget</h1><div><p>Test your widget on a compatible S60 mobile device. Alternatively, you can first use an emulator provided with the S60 C++ SDK and then perform the final testing on the target device.</p>
<div><h3>Testing a widget on a mobile device</h3><p>When you have created your widget functionality and the required <a href="GUID-0E3095DB-03FF-4240-83F2-6D876AD2083A.html#GUID-0E3095DB-03FF-4240-83F2-6D876AD2083A">widget component files</a>, you need to test it on <a href="GUID-1A3ECAC1-3F09-4602-A1CD-82164040A664.html#GUID-1A3ECAC1-3F09-4602-A1CD-82164040A664">a mobile device that can run widgets</a>. Use a device that supports the Web Runtime version for which you created the widget.</p></div>
<div><h3>To run a widget on a mobile device</h3><ol>
<li id="GUID-8E1247AA-1EC4-4896-BFA6-65D48286A779"><a name="GUID-8E1247AA-1EC4-4896-BFA6-65D48286A779"><!----></a><p>Create a connection from your PC to your mobile device.</p><p>You have several options for connecting your mobile device to your PC, such as a USB cable and Bluetooth connection. Check your mobile device user guide for instructions on how to make a connection. If you choose to use <a href="http://europe.nokia.com/software" target="_blank">Nokia PC Suite</a>, check the user guide for more information on using this software.</p></li>
<li id="GUID-D51B4CCD-AD63-4646-89FF-73E1A1491498"><a name="GUID-D51B4CCD-AD63-4646-89FF-73E1A1491498"><!----></a><p>Transfer the widget installation package from your PC to your mobile device, for example, using <a href="http://europe.nokia.com/software" target="_blank">Nokia PC Suite</a>.</p></li>
<li id="GUID-64480811-FDC7-47A5-8161-DB23D14B240F"><a name="GUID-64480811-FDC7-47A5-8161-DB23D14B240F"><!----></a><p>Activate the widget package to complete the installation.</p><p>The location where the widget package is stored on the mobile device after the transfer, as well as the way to activate the installation, depend on the method of transfer, as shown in the following table.</p><div class="tablenoborder"><a name="GUID-381AE359-EFE7-44FB-91D1-58B3746B82E1"><!----></a><table cellpadding="4" cellspacing="0" summary="" id="GUID-381AE359-EFE7-44FB-91D1-58B3746B82E1" frame="border" border="1" rules="all"><caption><strong>Table: </strong>Widget installation methods</caption>
<thead align="left">
<tr class="title ">
<th class="cellrowborder" valign="top" width="31%" id="d0e10232"><p>Method of transfer</p></th>
<th class="cellrowborder" valign="top" width="32.33333333333333%" id="d0e10236"><p>Location on the device</p></th>
<th class="cellrowborder" valign="top" width="36.66666666666667%" id="d0e10240"><p>How to activate the installation</p></th>
</tr>
</thead>
<tbody>
<tr class="">
<td class="cellrowborder" valign="top" width="31%" headers="d0e10232 "><p>Transfer via Bluetooth, email or other communication method</p></td>
<td class="cellrowborder" valign="top" width="32.33333333333333%" headers="d0e10236 "><p><span class="uicontrol">Inbox</span> folder of the <span class="uicontrol">Messaging</span> application</p></td>
<td class="cellrowborder" valign="top" width="36.66666666666667%" headers="d0e10240 "><p>Using the <span class="uicontrol">Messaging</span> application.</p></td>
</tr>
<tr class="bg ">
<td class="cellrowborder" valign="top" width="31%" headers="d0e10232 "><p>Transfer using a USB cable</p></td>
<td class="cellrowborder" valign="top" width="32.33333333333333%" headers="d0e10236 "><p>Phone memory, the <span class="uicontrol">Other</span> folder</p></td>
<td class="cellrowborder" valign="top" width="36.66666666666667%" headers="d0e10240 "><p>Using the File Manager (<span class="uicontrol">File mgr.</span>) application.</p></td>
</tr>
<tr class="">
<td class="cellrowborder" valign="top" width="31%" headers="d0e10232 "><p>Transfer using the Web Browser for S60</p></td>
<td class="cellrowborder" valign="top" width="32.33333333333333%" headers="d0e10236 "> </td>
<td class="cellrowborder" valign="top" width="36.66666666666667%" headers="d0e10240 "><p>If the MIME type is specified correctly for the widget package, the installation will be completed automatically. For more information, see section <a href="GUID-CCA3FA0B-9D75-453A-947C-B3CB2A85C684.html#GUID-CCA3FA0B-9D75-453A-947C-B3CB2A85C684">Deploying widgets</a>.</p></td>
</tr>
</tbody>
</table></div></li>
<li id="GUID-7F3BFF9C-2B01-4F8A-B157-B89FE94B2AF0"><a name="GUID-7F3BFF9C-2B01-4F8A-B157-B89FE94B2AF0"><!----></a><p>After a successful installation, launch the widget by navigating to it and selecting <span class="uicontrol">Open</span>.</p><p>After a successful installation, you can find the widget under the application menu, in the folder that contains installed applications. The name of this folder varies between mobile devices, and can be, for example, <span class="uicontrol">Installations</span> or <span class="uicontrol">Applications</span>.</p><div class="figure" id="GUID-B2CD83AC-9672-42D1-BA7C-2E48F82C0D13"><img src="GUID-CB5F7420-B31B-456E-9148-70B15E082951_d0e10330_href.png"/><p class="figure-title"><strong>Figure: </strong>Installations folder in the application menu</p></div></li>
</ol></div>
<div><h3>Testing a widget on an emulator</h3><p>The benefits of testing a widget on an emulator include:</p><ul>
<li><p>You can test the functionality of the widget for free with the emulator.</p></li>
<li><p>The file system is located on your PC. This makes it easy for you to install the widget package, test it, then modify it and test it again.</p><p>For example, you can test the layout and style of the widget by testing the widget, then modifying the <a href="GUID-0E3095DB-03FF-4240-83F2-6D876AD2083A.html#GUID-0E3095DB-03FF-4240-83F2-6D876AD2083A">CSS or HTML file</a> and then testing again to see how the modifications affected the layout. In the figure below, the color of the menu descriptions is changed from white to red.</p><div class="figure" id="GUID-4AFEDA36-D987-4000-B017-DD1ECE844A03"><img src="GUID-EDB0A0D5-D7D7-460A-8D1B-BB7890B85782_d0e10362_href.png"/><p class="figure-title"><strong>Figure: </strong>Modifying and testing layout changes</p></div></li>
</ul></div>
<div><h3>To run a widget on the emulator</h3><ol>
<li id="GUID-12F52FFA-21C9-4523-8409-467F64DD8604"><a name="GUID-12F52FFA-21C9-4523-8409-467F64DD8604"><!----></a><p>If you have not used the emulator before, launch it by selecting <span class="uicontrol">S60 Developer Tools > [S60 platform version] > [SDK version] > Emulator</span> in the Windows <span class="uicontrol">Start</span> menu and then close it again.</p><p>This step is required only once, when you launch the emulator for the first time. It creates some folders to the emulator file system, such as the destination folder needed in step 2. You can later run widgets on the emulator by starting from step 2.</p><div class="note"><p><strong class="note_title">Note: </strong>Starting the emulator may take a while.</p></div></li>
<li id="GUID-723B9C5A-F2FE-4F3D-832D-868589205FFD"><a name="GUID-723B9C5A-F2FE-4F3D-832D-868589205FFD"><!----></a><p>Copy the widget installation package (<code>wgz</code> file) to the emulator file system, in folder <code><SDK installation folder>\epoc32\winscw\c\Data\Others</code>.</p><div class="note"><p><strong class="note_title">Note: </strong>The <code>Data\Others</code> folder is visible in the emulator file system only when you have launched the emulator for the first time and then closed it.</p></div><div class="figure" id="GUID-12E279E3-CB55-41AF-8305-7AED9D37119F"><img src="GUID-0F6674AB-EE72-4417-8B27-BFEAC28C26D4_d0e10408_href.png"/><p class="figure-title"><strong>Figure: </strong>Others folder in the emulator file system (S60 3rd Edition FP2 SDK)</p></div></li>
<li id="GUID-A7518275-9CE5-4CC6-97F5-26B18C3809F2"><a name="GUID-A7518275-9CE5-4CC6-97F5-26B18C3809F2"><!----></a><p>Launch the emulator by selecting <span class="uicontrol">S60 Developer Tools > [S60 platform version] > [SDK version] > Emulator</span> in the Windows <span class="uicontrol">Start</span> menu.</p></li>
<li id="GUID-ED0699F6-73BC-4C58-8294-7D1BBE124E9C"><a name="GUID-ED0699F6-73BC-4C58-8294-7D1BBE124E9C"><!----></a><p>If you are using the S60 3rd Edition FP2 SDK emulator, open <span class="uicontrol">Organiser</span> in the application menu.</p><p>If you are using the S60 5th Edition SDK emulator, open <span class="uicontrol">Applications</span> in the application menu.</p></li>
<li id="GUID-D3BA5F85-3CA8-45F8-AC7F-4F82BA70C926"><a name="GUID-D3BA5F85-3CA8-45F8-AC7F-4F82BA70C926"><!----></a><p>Open the File Manager (<span class="uicontrol">File mgr.</span>) application.</p><div class="figure" id="GUID-D32E1E02-9F53-4118-A90D-54E2D15EF4C1"><img src="GUID-7471ECB1-EB67-4794-8D85-4F91F4F43742_d0e10446_href.png" longdesc=""/><p class="figure-title"><strong>Figure: </strong>Opening the File Manager application (S60 3rd Edition FP2 SDK)</p></div></li>
<li id="GUID-B07ED0EB-6241-4F0C-AB93-8AA5DE72CAEE"><a name="GUID-B07ED0EB-6241-4F0C-AB93-8AA5DE72CAEE"><!----></a><p>Go to <span class="uicontrol">Phone memory</span> > <span class="uicontrol">Other</span> to manage files in the <code>Others</code> folder of the emulator system.</p></li>
<li id="GUID-83CDDE93-B1D1-4762-81B3-41F5C2DC1828"><a name="GUID-83CDDE93-B1D1-4762-81B3-41F5C2DC1828"><!----></a><p>Open the widget to launch the installation process.</p><p>The emulator handles the installation of the widget.</p><div class="figure" id="GUID-5F9944AF-9952-4CA6-A95E-CBC9E3B8A0C2"><img src="GUID-2F1A1E1D-EC84-4AE1-8980-3F38A3A653EB_d0e10473_href.png"/><p class="figure-title"><strong>Figure: </strong>Launching the installation process (S60 3rd Edition FP2 SDK)</p></div></li>
<li id="GUID-2C19C94B-31A6-4287-BF60-823BE31A3895"><a name="GUID-2C19C94B-31A6-4287-BF60-823BE31A3895"><!----></a><p>When the widget installation is complete, return to the application menu.</p></li>
<li id="GUID-251C8C79-F658-4D50-86AB-0558AC35EA8E"><a name="GUID-251C8C79-F658-4D50-86AB-0558AC35EA8E"><!----></a><p>If you are using the S60 3rd Edition FP2 SDK emulator, open <span class="uicontrol">Installations</span>.</p><p>If you are using the S60 5th Edition SDK emulator, open <span class="uicontrol">Applications</span>.</p><div class="figure" id="GUID-B945A7DB-893E-40CD-BB15-DD9832A56D5F"><img src="GUID-CB5F7420-B31B-456E-9148-70B15E082951_d0e10497_href.png"/><p class="figure-title"><strong>Figure: </strong>Installations folder in the application menu (S60 3rd Edition FP2 SDK)</p></div></li>
<li id="GUID-3E1D51EB-B543-430E-84FE-F1B6A08C5988"><a name="GUID-3E1D51EB-B543-430E-84FE-F1B6A08C5988"><!----></a><p>Locate the widget in the folder and open it.</p><p>Now the widget should be running on the emulator.</p></li>
</ol><div class="note"><p><strong class="note_title">Note: </strong>It is recommended that you test the emulator Internet connectivity with the Web browser to ensure that you can access the Internet before testing your widget communications feature. For more information on how to test the connectivity, see the documentation in the S60 C++ SDK.</p></div></div>
</div></div></div><div class="footer"><hr/><div class="copy">© Nokia 2009.</div></div></body></html>