| <DOCTYPE HTML PUBLIC"-//W3C//DTD HTML 4.01 Transitional//EN"> | |
| <html> | |
| <head> | |
| <title>NetBeans Mobility Pack for CDC 5.5 Installation Guide</title> | |
| <link rel="stylesheet" type="text/css" href="../../../netbeans.css"> | |
| </head> | |
| <body> | |
| <a name=top></a> | |
| <h1>NetBeans Mobility Pack for CDC 5.5 Installation Guide</h1> | |
| <p>The NetBeans Mobility Pack for CDC 5.5 provides an environment for rapidly | |
| building Java Micro Edition (Java ME) applications that support devices using | |
| the Connected Device Configuration (CDC) and the Personal, Foundation, and AGUI | |
| Profiles. </p> | |
| <p><b>Contents</b></p> | |
| <ul> | |
| <li> <a href="#prerequisites" title="Prerequisites">Prerequisites</a> </li> | |
| <li> <a href="#installation" title="Installing the Software">Installing the | |
| Software</a> </li> | |
| <li><a href="#emulators">Installing Emulator Platforms</a></li> | |
| <li> <a href="#uninstallation" title="Uninstalling the Software">Uninstalling | |
| the Software</a> </li> | |
| <li> <a href="#troubleshoot" title="Troubleshooting">Troubleshooting</a> </li> | |
| </ul> | |
| <p><b>Note:</b> For information about system requirements for the software included | |
| in this bundle, see the <a href="relnotes-mobilitycdc.html">NetBeans Mobility Pack for CDC 5.5 Release Notes</a>.</p> | |
| <h2><a name=prerequisites></a>Prerequisites</h2> | |
| <p>This topic specifies the prerequisites that must be met before you start to | |
| install NetBeans Mobility Pack for CDC 5.5. </p> | |
| <blockquote> | |
| <h3>Required Software</h3> | |
| <p>Hardware, software, and operating system requirements are detailed in the | |
| <a href="relnotes-mobilitycdc.html">NetBeans Mobility Pack for CDC 5.5 Release | |
| Notes</a>.</p> | |
| <p>You will need to have the following software installed before you install | |
| the NetBeans Mobility Pack for CDC 5.5.</p> | |
| <ul> | |
| <li><a href="http://java.sun.com/javase/downloads/index.jsp" target="_blank">Java | |
| SE Development Kit (JDK) 5.0</a></li> | |
| <li><a href="http://services.netbeans.org/downloads/index.php" target="_blank">NetBeans | |
| IDE 5.5</a></li> | |
| </ul> | |
| <p>The Sun Java Toolkit for CDC is integrated within the NetBeans Mobility Pack. | |
| However, if you want to program applications for other supported platforms, | |
| you need to download and install one or more of the following SDKs:</p> | |
| <ul> | |
| <li>Ricoh | |
| <ul> | |
| <li>Embedded Software Architecture Emulator (Registration required for | |
| <a href="http://www.ricoh.com/esa/index.html">download</a>)</li> | |
| </ul> | |
| </li> | |
| <li>Sony Ericsson | |
| <ul> | |
| <li>UIQ 3 SDK (login required for <a href="http://developer.uiq.com/">download</a>)</li> | |
| <li>M600 Extension Package for the UIQ 3 SDK Beta 3 (<a href="http://developer.sonymobile.com/downloads/sdks/">download</a>)</li> | |
| <li>P990 Extension Package for the UIQ 3 SDK Beta 3 (<a href="http://developer.sonymobile.com/downloads/sdks/">download</a>)</li> | |
| </ul> | |
| </li> | |
| <li>Nokia | |
| <ul> | |
| <li>Nokia Series 80 Platform SDK for Symbian OS, for Java, Personal Profile | |
| (<a href="http://www.forum.nokia.com/info/sw.nokia.com/id/449a2f84-2a8a-44fa-a7f4-93b53cb9c89a/Series_80_Platform_SDK_s_for_Symbian_OS_for_Java.html">download</a>) | |
| </li> | |
| </ul> | |
| </li> | |
| <li> SavaJe | |
| <ul> | |
| <li> The SavaJe Operating System (OS) (Registration Required for download)<br> | |
| <br> | |
| </li> | |
| </ul> | |
| </li> | |
| </ul> | |
| </blockquote> | |
| <p align=center><a href="#top">top</a></p> | |
| <h2><a name=installation></a>Installing the Software</h2> | |
| <p>Following are instructions for installing the NetBeans Mobility Pack for CDC | |
| 5.5. These instructions assume that you have already installed the<a href="http://java.sun.com/javase/downloads/index.jsp"> | |
| Java SE Development Kit</a> and the <a href="https://netbeans.org/community/releases/55/install.html">NetBeans | |
| IDE 5.5</a>. | |
| <blockquote> | |
| <p><b>To install the NetBeans Mobility Pack 5.5 for CDC:</b></p> | |
| <ol> | |
| <li> Download the installer file from <a href="http://services.netbeans.org/downloads/index.php?rs=11&p=10">http://services.netbeans.org/downloads/index.php?rs=11&p=10</a></li> | |
| <li>Navigate through your system to the installer file location and double-click | |
| the installer's icon to launch the installer. </li> | |
| <li> At the Welcome page of the installation wizard, click Next. </li> | |
| <li> Accept the license agreement and click Next. </li> | |
| <li> At the installation directory page of the installation wizard, specify | |
| the location of your NetBeans IDE 5.5 installation. </li> | |
| <li> The installation wizard searches for compatible JDK installations. If | |
| your JDK is not in the default location, you will need to specify the location | |
| of your Java JDK 1.5.0 or higher. You can also type the path to another | |
| installed JDK or use the Browse button to navigate to and select another | |
| installation. </li> | |
| <li>When installation is complete, click Finish to exit the wizard.</li> | |
| </ol> | |
| <p>The default projects directory is <tt>C:\Documents and Settings\<i>username</i></tt>. | |
| If you uninstall NetBeans Mobility Pack for CDC, this directory is not deleted, | |
| and will be identified the next time you install the Mobility Pack for CDC.</p> | |
| <div class=greybox> | |
| <p><b>Note: </b>If you encounter problems during software installation, | |
| see <a href="#troubleshoot">Troubleshooting</a> for full descriptions and | |
| suggested workarounds for unresolved issues that could affect the installation | |
| process.</p> | |
| </div> | |
| <p> </p> | |
| <p><b>Installing NetBeans Mobility Pack 5.5 for CDC to non-Windows platforms</b></p> | |
| <p>Currently the Mobility Pack for CDC is not available for non-Windows platforms due to a lack of | |
| 3rd party emulator support for other platforms. However, we do offer an unsupported binary zip of the pack | |
| for those who wish to install the pack on other operating systems. Please note that there is no documentation | |
| or support for the binary zip. For information about downloading and installing the binary zip, please visit | |
| the <a href="http://wiki.netbeans.org/wiki/view/MobilityFromZipToNB">FAQ page</a> for this topic. The | |
| <a href="https://netbeans.org/projects/mobility/lists/users/archive">Mobility Users mailing list</a> | |
| is also available for further questions related to this topic.</p> | |
| </blockquote> | |
| <p align=center><a href="#top">top</a></p> | |
| <h2><a name="emulators"></a>Installing Emulator Platforms</h2> | |
| <p>To develop CDC applications, you need to have the CDC platform registered in | |
| the IDE. The following instructions describe the process for installing each | |
| emulator platform currently supported by the IDE.</p> | |
| <blockquote> | |
| <h3>Sun Java Toolkit for CDC<a name="cdctk"></a></h3> | |
| <p>The Sun Java Toolkit for CDC comes integrated with the NetBeans Mobility | |
| Pack, so there is no need to download and install this emulator. </p> | |
| <p>However, if you do want to have a separate installation of the Toolkit, you | |
| can follow these instructions: </p> | |
| <ol> | |
| <li>Download the Sun Java Toolkit for CDC<font color="#FF0000"> </font>1.0 | |
| from the Sun Developer Network (<a href="http://java.sun.com/products/cdctoolkit/overview.html">download</a>).</li> | |
| <li>Install the platform emulator according to the instructions provided. | |
| </li> | |
| <li>From the Main Menu, choose Tools > Java Platform Manager. </li> | |
| <li>Click Add Platform. The Add Java Platform dialog opens. </li> | |
| <li>Select Java Micro Edition CDC Platform Emulator and click Next. </li> | |
| <li>Select the folder that contains the platform SDK. The default directory | |
| is <code>C:\CDCTK10\.</code> Click Next.<code> </code></li> | |
| <li>If desired, use the Platform Name dialog to add or remove additional resource | |
| libraries. </li> | |
| <li>Click Finish. The IDE registers the CDC platform.</li> | |
| </ol> | |
| <p align=center><a href="#top">top</a></p> | |
| <h3>Ricoh Embedded Software Architecture</h3> | |
| <p>The Mobility Pack for CDC supports the Ricoh Embedded Software Architecture. | |
| To integrate support for this architecture, follow these instructions: </p> | |
| <ol> | |
| <li>Download the following files from the <a href="http://www.ricoh.com/esa/index.html">Ricoh | |
| Developer Program Site</a> web site: </li></ul> | |
| <ul> | |
| <li><a href="http://developer.sonyericsson.com/site/global/docstools/symbian/p_symbian.jsp"> | |
| </a>Embedded Software Architecture Emulator (login required for <a href="http://www.ricoh.com/esa/index.html">download</a>)<font color="#FF0000"></font></li> | |
| </ul> | |
| <li>Unzip the file <code>Embedded_Software_Architecture_Emulator_1.14c.zip.<br> | |
| </code>The files are extracted to a folder<code> <em><root></em>\Embedded_Software_Architecture_Emulator_1.14c\.</code></li> | |
| <li> From the Main Menu of the NetBeans IDE, choose Tools > Java Platform | |
| Manager. </li> | |
| <li>Click Add Platform. The Add Java Platform dialog opens. </li> | |
| <li>Select Java Micro Edition CDC Platform Emulator and click Next. </li> | |
| <li>Select the folder that contains the platform SDK. The default directory | |
| is <code>C:\Embedded_Software_Architecture_Emulator_1.14c\.</code> Click | |
| Next.<code> </code></li> | |
| <li>If desired, use the Platform Name dialog to add or remove additional resource | |
| libraries. </li> | |
| <li>Click Finish. The IDE registers the CDC platform.</li> | |
| </ol> | |
| <p align=center><a href="#top">top</a></p> | |
| <h3>Sony Ericsson CDC Platform for the UIQ SDK 3</h3> | |
| <p>The Mobility Pack for CDC supports the Sony Ericsson CDC Platform 1. To integrate | |
| support for the M600 and P990 series devices, follow these instructions: </p> | |
| <ol> | |
| <li>Download the following files from the <a href="http://developer.sonyericsson.com">developer.sonyericsson.com</a> | |
| web site: </li> | |
| <ul> | |
| <li><a href="http://developer.sonyericsson.com/site/global/docstools/symbian/p_symbian.jsp"> | |
| </a>UIQ 3 SDK (login required for <a href="http://developer.uiq.com/">download</a>)<font color="#FF0000"></font></li> | |
| <li>M600 Extension Package for the UIQ 3 SDK (<a href="http://developer.sonymobile.com/downloads/sdks/">download</a>)</li> | |
| <li>P990 Extension Package for the UIQ 3 SDK (<a href="http://developer.sonymobile.com/downloads/sdks/">download</a>)</li> | |
| </ul> | |
| <li>Unzip the <code>UIQ3SDK_final.zip</code> file. </li> | |
| <li>Navigate to the location on your system where the files were extracted | |
| and double-click on <code>UIQS3SDK.exe</code>.<br> | |
| The UIQ 3 SDK Installation Wizard opens. </li> | |
| <li>Follow the Wizard instructions to install the SDK. <br> | |
| The default directory for the installation is <code>C:\Symbian\UIQ3SDK\</code></li> | |
| <li>To install the M600 and P990 extension packages, navigate to the download | |
| locations on your system and double-click on the installer icons to start | |
| the installation wizards. </li> | |
| <li>Follow the wizard instructions to install each SDK. </li> | |
| <li>From the Main Menu of the NetBeans IDE, choose Tools > Java Platform | |
| Manager. </li> | |
| <li>Click Add Platform. The Add Java Platform dialog opens. </li> | |
| <li>Select Java Micro Edition CDC Platform Emulator and click Next. </li> | |
| <li>Select the folder that contains the platform SDK. The default directory | |
| is <code>C:\Symbian\UIQ3SDK\.</code> Click Next.</li> | |
| <li>If desired, use the Platform Name dialog to add or remove additional resource | |
| libraries. <br> | |
| <br> | |
| <strong>Note:</strong> If you see the message, "Platform is not correctly | |
| configured. Use SDK Configuration tools to install mandatory tools," | |
| an emulator style has not been selected.<br> | |
| <br> | |
| To fix this: | |
| <ol> | |
| <li>Click on the Configurations tab and click the SDK Configuration Tool | |
| button. </li> | |
| <li>In the SDK Configuration, Click the Style tab and choose a style from | |
| the Emulator Styles. Choose Apply Styles. </li> | |
| <li>Close the SDK Configurator. </li> | |
| </ol> | |
| </li> | |
| <li>Click Finish. The IDE registers the CDC platforms.</li> | |
| </ol> | |
| <p align=center><a href="#top">top</a></p> | |
| <h3>Nokia Series 80 Platform SDK for Symbian OS, for Java, Personal Profile</h3> | |
| <p>The Mobility Pack for CDC supports Series 80 Platform SDK for Symbian OS, | |
| for Java, Personal Profile. To integrate support for Nokia Series 80 devices, | |
| follow these instructions: </p> | |
| <ol> | |
| <li>Download the Nokia Series 80 Platform SDK for Symbian OS, for Java, Personal | |
| Profile from the Sun Developer Network (<a href="http://www.forum.nokia.com/info/sw.nokia.com/id/449a2f84-2a8a-44fa-a7f4-93b53cb9c89a/Series_80_Platform_SDK_s_for_Symbian_OS_for_Java.html">download</a>). | |
| The file name is <code>S80_DP_2_0_PP_SDK.zip.</code></li> | |
| <li>Unzip the file. </li> | |
| <li>Navigate to the location on your system where you unzipped the file. Double-click | |
| on the <code>setup.exe</code> file icon. <br> | |
| The Nokia installer wizard opens. </li> | |
| <li>Follow the wizard instructions to install the SDK. <br> | |
| The wizard will prompt you to choose the device you want to be the default | |
| device. Choose the <code>Series80_DP2_0_PP_SDK</code>.</li> | |
| <li>From the Main Menu of the NetBeans IDE, choose Tools > Java Platform | |
| Manager. </li> | |
| <li>Click Add Platform. The Add Java Platform dialog opens. </li> | |
| <li>Select Java Micro Edition CDC Platform Emulator and click Next. </li> | |
| <li>Select the folder that contains the platform SDK. The default directory | |
| is <code>C:\Symbian\S80_DP2_0_PP_SDK.</code> Click Next.<code> </code></li> | |
| <li>If desired, use the Platform Name dialog to add or remove additional resource | |
| libraries. </li> | |
| <li>Click Finish. The IDE registers the CDC platform.</li> | |
| </ol> | |
| <p align=center><a href="#top">top</a></p> | |
| <h3 align=center>SavaJe Mobile Platform</h3> | |
| <p>The Mobility Pack for CDC supports the creation of Xlets using the SavaJe | |
| Operating System. Support for the SavaJe OS is built into the Sun Java Wireless | |
| Toolkit for CDC. Because the Jasper S20 is currently available only as a preview | |
| edition, there is no emulator skin available for the Jasper S20. You can, | |
| instead, use the <code>DefaultColorPhone</code> device to simulate the behavior | |
| of the Jasper S20.</p> | |
| <div class="indent"> | |
| <p>If you do have a Jasper S20, these instructions show you how to deploy | |
| the application to your device. Here is what you need: </p> | |
| <ul> | |
| <li> The Jasper S20 phone. </li> <li> The SavaJe Operating System (OS) (Registration Required) </li> | |
| <li> | |
| GSPDA Mobile Device Software (MCCI USB drivers). | |
| </li> | |
| </ul> | |
| <h4></a>Setting Up the Handset </h4> | |
| <p>The following steps describe the process for installing the software you | |
| need for the tutorial on the Jasper S20 phone. </p> | |
| <h4 class="tutorial">Installing the SavaJE OS</h4> | |
| <p><strong>NOTE: </strong>This procedure is for Jasper S20 handsets that have | |
| a previous version of the SavaJe OS installed and you want to retain existing | |
| calibration and factory settings.</p> | |
| <p>There are three builds of the SavaJe OS that might be available from www.SavaJe.com: | |
| </p> | |
| <ul> | |
| <li> | |
| <code>JasperS20.zip</code><br> | |
| The commercial build that ships on the phone. | |
| </li> | |
| <li> | |
| <code>JasperS20_EA_Developer.zip</code><br> | |
| JavaOne Early Access developer build without the Java Debug Wire Protocol | |
| (JDWP) enabled. | |
| </li> | |
| <li> | |
| <code>JasperS20_EA_Developer_debug.zip</code><br> | |
| JavaOne early access developer build with JDWP enables. To run a bundle | |
| with JDWP debugging, you need to load this build. | |
| </li> | |
| </ul> | |
| <p>Follow these steps to install a different build of the SavaJE OS on the | |
| phone. </p> | |
| <ol> | |
| <li> Extract (unzip) the zip file containing the desired build to the root | |
| of the mini-SD card. </li> | |
| <li>Connect a USB/power cable to the handset.</li> | |
| <li>Power the handset while holding the Camera key down.</li> | |
| <li>At the updater menu screen, select Factory Reset by moving the joystick | |
| down until "Factory Reset" is highlighted. Initiate the factory | |
| reset by moving the joystick to the right. Use the joystick to navigate | |
| to Yes and then select Yes by moving the joystick to the right. <br> | |
| The phone should begin loading the new build. After the load is complete, | |
| you may be prompted to press any key to reboot the phone. </li> | |
| <li>The handset then reboots and displays the Xplore screen. If the battery | |
| charging screen displays during the reboot, press the power button to | |
| continue rebooting the phone. </li> | |
| </ol> | |
| <p>The first time the handset boots after a factory reset, a Language/Locale | |
| selection menu displays. Make your selections by navigating with the joystick | |
| and pressing the joystick button. You are also prompted to set the time. | |
| </p> | |
| <h4 class="tutorial">Registering the CDC Platform</h4> | |
| <p>Follow the instructions provided for the <a href="#cdctk"> Sun Java Wireless | |
| Toolkit for CDC 1.0</a>. <br> | |
| </p> | |
| </div> | |
| <p align=center><a href="#top">top</a></p> | |
| </blockquote> | |
| <h2><a name=uninstallation>Uninstalling the Software</a></h2> | |
| <p>This section contains information for uninstalling NetBeans Mobility Pack for CDC 5.5 from your system. | |
| <blockquote> | |
| <ol> | |
| <li> Shut down the IDE. </li> | |
| <li> From the Control Panel, start Add or Remove Programs, select NetBeans Mobility Pack for CDC 5.5 and click Change/Remove. </li> | |
| <li> Follow the instructions in the uninstaller. </li> | |
| </ol> | |
| </blockquote> | |
| <p><strong>Note:</strong> You can also uninstall any or all of the Emulator | |
| platforms through the Windows Control Panel. </p> | |
| <p align=center><a href="#top">top</a></p> | |
| <h2><a name=troubleshoot>Troubleshooting</a></h2> | |
| <p>If you experience problems installing or running the software, see the list | |
| of issues below for workarounds. For a complete list of known issues, system | |
| requirements, and configuration information, see the <a href="relnotes-mobilitycdc.html">Release | |
| Notes</a>. </p> | |
| <p> If you encounter a problem not listed in the release notes or wish to request | |
| an enhancement, file an issue in the NetBeans bug tracking system, IssueZilla, | |
| at <a href="https://netbeans.org/community/issues.html">https://netbeans.org/community/issues.html</a>. | |
| For NetBeans Mobility Pack issues, select the "mobility" component, select version | |
| "5.5", and then select the "cdc pack" subcomponent. If you | |
| are not sure of the right subcomponent name, choose "other".</p> | |
| <p>If you are already logged in to netbeans.org, you can go directly to the Mobility | |
| Pack issue entry screen: <a href="https://netbeans.org/bugzilla/enter_bug.cgi?component=mobility&version=5.5">https://netbeans.org/bugzilla/enter_bug.cgi?component=mobility&version=5.5</a>.</p> | |
| <ul> | |
| <p align=center><a href="#top">top</a></p> | |
| </ul> | |
| </body> | |
| </html> |