NetBeans Mobility Pack for CDC 5.5.1 Installation Guide
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.
Contents
Note: For information about system requirements for the software included
in this bundle, see the NetBeans Mobility
Pack for CDC 5.5.1 Release Notes.
Prerequisites
This topic specifies the prerequisites that must be met before you start to
install NetBeans Mobility Pack for CDC 5.5.1.
Please note that the NetBeans Mobility Pack for CDC cannot be run on NetBeans
IDE 5.5. You must use NetBeans IDE 5.5.1.
Download NetBeans Mobility Pack for CDC 5.5.1 from the netbeans.org Downloads Page.
Required Software
Hardware, software, and operating system requirements are detailed in the
NetBeans Mobility Pack for CDC 5.5.1 Release
Notes.
You will need to have the following software installed before you install
the NetBeans Mobility Pack for CDC 5.5.1.
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:
- Ricoh
- Embedded Software Architecture Emulator (Registration required for
download)
- Sony Ericsson
- UIQ 3 SDK (login required for download)
- M600 Extension Package for the UIQ 3 SDK Beta 3 (download)
- P990 Extension Package for the UIQ 3 SDK Beta 3 (download)
- Nokia
- Nokia Series 80 Platform SDK for Symbian OS, for Java, Personal Profile
(download)
- NSIcom (CrEme for Windows CE)
- CrEme 4.10 Developer Support (download)
- Microsoft Device Emulator 1.0 (download)
- Virtual Machine Network Driver for Microsoft Device Emulator (download)
- ActiveSync (download)
- SavaJe
- The SavaJe Mobile Platform (no longer available)
top
Installing the Software
Following are instructions for installing the NetBeans Mobility Pack for CDC
5.5.1. These instructions assume that you have already installed the
Java SE Development Kit and the NetBeans
IDE 5.5.1.
To install the NetBeans Mobility Pack for CDC 5.5.1:
- Download the installer file from http://services.netbeans.org/downloads/index.php
- Navigate through your system to the installer file location and double-click
the installer's icon to launch the installer.
- At the Welcome page of the installation wizard, click Next.
- Accept the license agreement and click Next.
- At the installation directory page of the installation wizard, specify
the location of your NetBeans IDE 5.5.1 installation.
- 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.
- When installation is complete, click Finish to exit the wizard.
The default projects directory is C:\Documents and Settings\username.
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.
Note: If you encounter problems during software installation, see
Troubleshooting (File: trouble-mobility-cdc.html)
for full descriptions and suggested workarounds for unresolved issues that
could affect the installation process.
Installing NetBeans Mobility Pack for CDC 5.5.1 to non-Windows platforms
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 FAQ
page for this topic. The Mobility
Users mailing list is also available for further questions related to
this topic.
top
Installing Emulator Platforms
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.
Sun Java Toolkit for CDC
The Sun Java Toolkit for CDC comes integrated with the NetBeans Mobility
Pack, so there is no need to download and install this emulator.
However, if you do want to have a separate installation of the Toolkit, you
can follow these instructions:
- Download the Sun Java Toolkit for CDC 1.0
from the Sun Developer Network (download).
- Install the platform emulator according to the instructions provided.
- From the Main Menu, choose Tools > Java Platform Manager.
- Click Add Platform. The Add Java Platform dialog opens.
- Select Java Micro Edition CDC Platform Emulator and click Next.
- Select the folder that contains the platform SDK. The default directory
is
C:\CDCTK10\.
Click Next.
- If desired, use the Platform Name dialog to add or remove additional resource
libraries.
- Click Finish. The IDE registers the CDC platform.
top
Ricoh Embedded Software Architecture
The Mobility Pack for CDC supports the Ricoh Embedded Software Architecture.
To integrate support for this architecture, follow these instructions:
- Download the following files from the Ricoh
Developer Program Site web site:
- Embedded Software Architecture Emulator (login required for download)
- Unzip the file
Embedded_Software_Architecture_Emulator_1.14c.zip.
The files are extracted to a folder <root>\Embedded_Software_Architecture_Emulator_1.14c\.
- From the Main Menu of the NetBeans IDE, choose Tools > Java Platform
Manager.
- Click Add Platform. The Add Java Platform dialog opens.
- Select Java Micro Edition CDC Platform Emulator and click Next.
- Select the folder that contains the platform SDK. The default directory
is
C:\Embedded_Software_Architecture_Emulator_1.14c\.
Click
Next.
- If desired, use the Platform Name dialog to add or remove additional resource
libraries.
- Click Finish. The IDE registers the CDC platform.
top
Sony Ericsson CDC Platform for the UIQ SDK 3
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:
- Download the following files from the developer.sonymobile.com
web site:
-
UIQ 3 SDK (login required for download)
- M600 Extension Package for the UIQ 3 SDK (download)
- P990 Extension Package for the UIQ 3 SDK (download)
- Unzip the
UIQ3SDK_final.zip
file.
- Navigate to the location on your system where the files were extracted
and double-click on
UIQS3SDK.exe
.
The UIQ 3 SDK Installation Wizard opens.
- Follow the Wizard instructions to install the SDK.
The default directory for the installation is C:\Symbian\UIQ3SDK\
- 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.
- Follow the wizard instructions to install each SDK.
- From the Main Menu of the NetBeans IDE, choose Tools > Java Platform
Manager.
- Click Add Platform. The Add Java Platform dialog opens.
- Select Java Micro Edition CDC Platform Emulator and click Next.
- Select the folder that contains the platform SDK. The default directory
is
C:\Symbian\UIQ3SDK\.
Click Next.
- If desired, use the Platform Name dialog to add or remove additional resource
libraries.
Note: 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.
To fix this:
- Click on the Configurations tab and click the SDK Configuration Tool
button.
- In the SDK Configuration, Click the Style tab and choose a style from
the Emulator Styles. Choose Apply Styles.
- Close the SDK Configurator.
- Click Finish. The IDE registers the CDC platforms.
top
Nokia Series 80 Platform SDK for Symbian OS, for Java, Personal Profile
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:
- Download the Nokia Series 80 Platform SDK for Symbian OS, for Java, Personal
Profile from the Sun Developer Network (download).
The file name is
S80_DP_2_0_PP_SDK.zip.
- Unzip the file.
- Navigate to the location on your system where you unzipped the file. Double-click
on the
setup.exe
file icon.
The Nokia installer wizard opens.
- Follow the wizard instructions to install the SDK.
The wizard will prompt you to choose the device you want to be the default
device. Choose the Series80_DP2_0_PP_SDK
.
- From the Main Menu of the NetBeans IDE, choose Tools > Java Platform
Manager.
- Click Add Platform. The Add Java Platform dialog opens.
- Select Java Micro Edition CDC Platform Emulator and click Next.
- Select the folder that contains the platform SDK. The default directory
is
C:\Symbian\S80_DP2_0_PP_SDK.
Click Next.
- If desired, use the Platform Name dialog to add or remove additional resource
libraries.
- Click Finish. The IDE registers the CDC platform.
top
CrEme VM for Windows CE
The Mobility Pack for CDC supports the NSIcom CrEme VM for Windows CE. To
integrate support for Windows CE devices, follow these instructions.
- Download the CrEme 4.10 platform from NSIcom (download).
- Navigate to the location on your system where you downloaded the file
CrEmeDevSup410.exe
.
Double-click on the file.
- Follow the instructions of the NSI.com InstallShield wizard to install the
Developer Kit.
- From the Main Menu of the NetBeans IDE, choose Tools > Java Platform
Manager.
- Click Add Platform. The Add Java Platform dialog opens.
- Select Java Micro Edition CDC Platform Emulator and click Next.
- Select the folder that contains the platform SDK. The default directory
is
C:\Program Files\NSIcom\CrE-ME V4.10.
Click Next.
- If desired, use the Platform Name dialog to add or remove additional resource
libraries.
- Click Finish. The IDE registers the CDC platform.
top
Microsoft Device Emulator 1.0
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.
- Download the
V1Emulator.zip
file for the emulator (download).
- Unzip the file and double-click on
standalone_emulator_V1.exe
.
The install wizard for the Device Emulator will guide you through the installation
process.
- Download
efp.msi (
download)
.
The install wizard for the Device Emulator will guide you through
the installation process.
- It may also be necessary to install the Virtual Machine Network Driver
for Microsoft Device Emulator (download).
Download the file and double-click the
netsvwrap.msi
file.
The install wizard will guide you through the installation process.
top
ActiveSync
The ActiveSync VM supports the NSIcom CrEme VM for running Java on Windows
CE devices.
- Download
setup.msi
for the ActiveSync VM (download)
- Double-click on the file to install it.
top
SavaJe Mobile Platform
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 DefaultColorPhone
device to simulate the behavior
of the Jasper S20.
If you do have a Jasper S20, these instructions show you how to deploy
the application to your device. Here is what you need:
- The Jasper S20 phone.
- The SavaJe Operating System (OS) (no longer available)
- GSPDA Mobile Device Software (MCCI USB drivers).
Setting Up the Handset
The following steps describe the process for installing the software you
need for the tutorial on the Jasper S20 phone.
Installing the SavaJE OS
NOTE: 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.
Three builds of the SavaJe OS were produced:
-
JasperS20.zip
The commercial build that ships on the phone.
-
JasperS20_EA_Developer.zip
JavaOne Early Access developer build without the Java Debug Wire Protocol
(JDWP) enabled.
-
JasperS20_EA_Developer_debug.zip
JavaOne early access developer build with JDWP enabled. To run a bundle
with JDWP debugging, you need to load this build.
Follow these steps to install an updated build of the SavaJE OS on the phone.
- Extract (unzip) the zip file containing the desired build to the root
of the mini-SD card.
- Connect a USB/power cable to the handset.
- Power the handset while holding the Camera key down.
- 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.
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.
- 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.
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.
Registering the CDC Platform
Follow the instructions provided for the Sun Java Wireless
Toolkit for CDC 1.0.
top
This section contains information for uninstalling NetBeans Mobility Pack for CDC 5.5.1 from your system.
- Shut down the IDE.
- From the Control Panel, start Add or Remove Programs, select NetBeans Mobility Pack for CDC 5.5.1 and click Change/Remove.
- Follow the instructions in the uninstaller.
Note: You can also uninstall any or all of the Emulator
platforms through the Windows Control Panel.
top
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 Release
Notes.
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 https://netbeans.org/community/issues.html.
For NetBeans Mobility Pack issues, select the "mobility" component, select version
"5.5.1", and then select the "cdc pack" subcomponent. If you
are not sure of the right subcomponent name, choose "other".
If you are already logged in to netbeans.org, you can go directly to the Mobility
Pack issue entry screen: https://netbeans.org/bugzilla/enter_bug.cgi?component=mobility&version=5.5.1.