Google Git
Sign in
apache / netbeans-website-cleanup / refs/heads/master / . / src / content / community / releases / 55 / 1 / mobilitycdc-install.html
blob: 121522ce9eef510f5d235742a45a2318912958ab [file] [log] [blame]
<!DOCTYPE HTML PUBLIC"-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>NetBeans Mobility Pack for CDC 5.5.1 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.1 Installation Guide</h1>
<p>The NetBeans Mobility Pack for CDC 5.5.1 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>&nbsp;</p>
<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.1 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.1.</p>
<p>Please note that the NetBeans Mobility Pack for CDC cannot be run on NetBeans
IDE 5.5. You <em>must</em> use NetBeans IDE 5.5.1. </p>
<p>Download NetBeans Mobility Pack for CDC 5.5.1 from the <a href="http://services.netbeans.org/downloads/index.php?p=10">netbeans.org Downloads Page</a>.</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.1 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.1.</p>
<ul>
<li><a href="http://java.sun.com/javase/downloads/index.jsp" target="_blank">Java
SE Development Kit (JDK) 5.0 or 6.0</a></li>
<li><a href="http://services.netbeans.org/downloads/index.php" target="_blank">NetBeans
IDE 5.5.1</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.sonymobile.com/downloads/sdks/">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> NSIcom (CrEme for Windows CE)
<ul>
<li> CrEme 4.10 Developer Support (<a href="http://nsicom.com/shared/CrEmeDevSup410.exe">download</a>)</li>
<li>Microsoft Device Emulator 1.0 (<a href="http://www.microsoft.com/downloads/details.aspx?FamilyId=C62D54A5-183A-4A1E-A7E2-CC500ED1F19A&displaylang=en#Instructions">download</a>)
</li>
<li>Virtual Machine Network Driver for Microsoft Device Emulator (<a href="http://www.microsoft.com/downloads/details.aspx?familyid=DC8332D6-565F-4A57-BE8C-1D4718D3AF65&displaylang=en">download</a>)</li>
<li>ActiveSync (<a href="http://www.microsoft.com/downloads/details.aspx?FamilyID=9e641c34-6f7f-404d-a04b-dc09f8141141&DisplayLang=en">download</a>)</li>
</ul>
</li>
<li> SavaJe
<ul>
<li> The SavaJe Mobile Platform (no longer available)</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.1. 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="http://services.netbeans.org/downloads/index.php">NetBeans
IDE 5.5.1</a>.
<blockquote>
<p><b>To install the NetBeans Mobility Pack for CDC 5.5.1:</b></p>
<ol>
<li> Download the installer file from <a href="http://services.netbeans.org/downloads/index.php">http://services.netbeans.org/downloads/index.php</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.1 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="https://netbeans.org/kb/archive/index.html">Troubleshooting</a> <i>(File: trouble-mobility-cdc.html)</i>
for full descriptions and suggested workarounds for unresolved issues that
could affect the installation process.</p>
</div>
<p>&nbsp;</p>
<p><b>Installing NetBeans Mobility Pack for CDC 5.5.1 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 want 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 &gt; 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-usa.com/products/">Ricoh
Developer Program Site</a> web site: </li></ul>
<ul>
<li>Embedded Software Architecture Emulator (login required for download)<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>&lt;root&gt;</em>\Embedded_Software_Architecture_Emulator_1.14c\.</code></li>
<li> From the Main Menu of the NetBeans IDE, choose Tools &gt; 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.sonymobile.com/">developer.sonymobile.com</a>
web site: </li>
<ul>
<li><a href="http://developer.sonymobile.com/downloads/sdks/">
</a>UIQ 3 SDK (login required for <a href="http://developer.sonymobile.com/downloads/sdks/">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 &gt; 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, &quot;Platform is not correctly
configured. Use SDK Configuration tools to install mandatory tools,&quot;
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 &gt; 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>
</blockquote>
<p align=center><a href="#top">top</a></p>
<blockquote>
<h3>CrEme VM for Windows CE<a name="creme"></a></h3>
<p>The Mobility Pack for CDC supports the NSIcom CrEme VM for Windows CE. To
integrate support for Windows CE devices, follow these instructions.</p>
<ol>
<li>Download the CrEme 4.10 platform from NSIcom (<a href="http://nsicom.com/shared/CrEmeDevSup410.exe">download</a>).
</li>
<li>Navigate to the location on your system where you downloaded the file <code>CrEmeDevSup410.exe</code>.
Double-click on the file. </li>
<li>Follow the instructions of the NSI.com InstallShield wizard to install the
Developer Kit. </li>
<li>From the Main Menu of the NetBeans IDE, choose Tools &gt; 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:\Program Files\NSIcom\CrE-ME V4.10.</code> Click Next.</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>
</blockquote>
<p align=center><a href="#top">top</a></p>
<blockquote>
<h3>Microsoft Device Emulator 1.0</h3>
<p>The Mobility Pack for CDC supports the Microsoft Device Emulator 1.0 in conjunction
with the NSIcom CrEme VM for Windows CE. To integrate the Microsoft Device
Emulator 1.0, follow these instructions.</p>
<ol>
<li>Download the <code>V1Emulator.zip</code> file for the emulator (<a href="http://www.microsoft.com/en-us/download/details.aspx?id=20259">download</a>).
</li>
<li>Unzip the file and double-click on <code>standalone_emulator_V1.exe</code>.
The install wizard for the Device Emulator will guide you through the installation
process. </li>
<li>Download <code>efp.msi (</code><a href="http://www.microsoft.com/en-us/download/details.aspx?id=20259">download</a><code>)</code>.<code>
</code>The install wizard for the Device Emulator will guide you through
the installation process. </li>
<li>It may also be necessary to install the Virtual Machine Network Driver
for Microsoft Device Emulator (<a href="http://www.microsoft.com/en-us/download/details.aspx?id=2863">download</a>).
Download the file and double-click the <code>netsvwrap.msi</code> file.
The install wizard will guide you through the installation process. </li>
</ol>
<p align=center><a href="#top">top</a></p>
<h3>ActiveSync </h3>
<p>The ActiveSync VM supports the NSIcom CrEme VM for running Java on Windows
CE devices. </p>
<ol>
<li>Download <code>setup.msi</code> for the ActiveSync VM (<a href="http://www.microsoft.com/downloads/details.aspx?FamilyID=9e641c34-6f7f-404d-a04b-dc09f8141141&DisplayLang=en">download</a>)</li>
<li>Double-click on the file to install it. </li>
</ol>
<p align=center><a href="#top">top</a></p>
<h3>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) (no longer available) </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> Unfortunately, the SavaJe OS is no longer available for download. These instructions are made available for those who have access to the SavaJe Mobile Platform software via CD or other sources. This procedure was written for the Jasper S20 handset that had
an earlier version of the SavaJe OS installed and allows you to retain existing
preferences and factory settings.</p>
<p>Three builds of the SavaJe OS were produced:</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 enabled. To run a bundle
with JDWP debugging, you need to load this build. </li>
</ul>
<p>&nbsp;</p>
<p>Follow these steps to install an updated 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 &quot;Factory Reset&quot; 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>
</blockquote>
<p align=center><a href="#top">top</a></p>
<h2><a name=uninstallation>Uninstalling the Software</a></h2>
<p>This section contains information for uninstalling NetBeans Mobility Pack for CDC 5.5.1 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.1 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
&quot;5.5.1&quot;, and then select the &quot;cdc pack&quot; 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.1">https://netbeans.org/bugzilla/enter_bug.cgi?component=mobility&amp;version=5.5.1</a>.</p>
<ul>
<p align=center><a href="#top">top</a></p>
</ul>
</body>
</html>