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:

  1. Download the installer file from http://services.netbeans.org/downloads/index.php
  2. Navigate through your system to the installer file location and double-click the installer's icon to launch the installer.
  3. At the Welcome page of the installation wizard, click Next.
  4. Accept the license agreement and click Next.
  5. At the installation directory page of the installation wizard, specify the location of your NetBeans IDE 5.5.1 installation.
  6. 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.
  7. 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:

  1. Download the Sun Java Toolkit for CDC 1.0 from the Sun Developer Network (download).
  2. Install the platform emulator according to the instructions provided.
  3. From the Main Menu, choose Tools > Java Platform Manager.
  4. Click Add Platform. The Add Java Platform dialog opens.
  5. Select Java Micro Edition CDC Platform Emulator and click Next.
  6. Select the folder that contains the platform SDK. The default directory is C:\CDCTK10\. Click Next.
  7. If desired, use the Platform Name dialog to add or remove additional resource libraries.
  8. 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:

  1. Download the following files from the Ricoh Developer Program Site web site:
    • Embedded Software Architecture Emulator (login required for download)
  2. Unzip the file Embedded_Software_Architecture_Emulator_1.14c.zip.
    The files are extracted to a folder <root>\Embedded_Software_Architecture_Emulator_1.14c\.
  3. From the Main Menu of the NetBeans IDE, choose Tools > Java Platform Manager.
  4. Click Add Platform. The Add Java Platform dialog opens.
  5. Select Java Micro Edition CDC Platform Emulator and click Next.
  6. Select the folder that contains the platform SDK. The default directory is C:\Embedded_Software_Architecture_Emulator_1.14c\. Click Next.
  7. If desired, use the Platform Name dialog to add or remove additional resource libraries.
  8. 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:

  1. 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)
  2. Unzip the UIQ3SDK_final.zip file.
  3. 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.
  4. Follow the Wizard instructions to install the SDK.
    The default directory for the installation is C:\Symbian\UIQ3SDK\
  5. 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.
  6. Follow the wizard instructions to install each SDK.
  7. From the Main Menu of the NetBeans IDE, choose Tools > Java Platform Manager.
  8. Click Add Platform. The Add Java Platform dialog opens.
  9. Select Java Micro Edition CDC Platform Emulator and click Next.
  10. Select the folder that contains the platform SDK. The default directory is C:\Symbian\UIQ3SDK\. Click Next.
  11. 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:
    1. Click on the Configurations tab and click the SDK Configuration Tool button.
    2. In the SDK Configuration, Click the Style tab and choose a style from the Emulator Styles. Choose Apply Styles.
    3. Close the SDK Configurator.
  12. 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:

  1. 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.
  2. Unzip the file.
  3. 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.
  4. 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.
  5. From the Main Menu of the NetBeans IDE, choose Tools > Java Platform Manager.
  6. Click Add Platform. The Add Java Platform dialog opens.
  7. Select Java Micro Edition CDC Platform Emulator and click Next.
  8. Select the folder that contains the platform SDK. The default directory is C:\Symbian\S80_DP2_0_PP_SDK. Click Next.
  9. If desired, use the Platform Name dialog to add or remove additional resource libraries.
  10. 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.

  1. Download the CrEme 4.10 platform from NSIcom (download).
  2. Navigate to the location on your system where you downloaded the file CrEmeDevSup410.exe. Double-click on the file.
  3. Follow the instructions of the NSI.com InstallShield wizard to install the Developer Kit.
  4. From the Main Menu of the NetBeans IDE, choose Tools > Java Platform Manager.
  5. Click Add Platform. The Add Java Platform dialog opens.
  6. Select Java Micro Edition CDC Platform Emulator and click Next.
  7. Select the folder that contains the platform SDK. The default directory is C:\Program Files\NSIcom\CrE-ME V4.10. Click Next.
  8. If desired, use the Platform Name dialog to add or remove additional resource libraries.
  9. 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.

  1. Download the V1Emulator.zip file for the emulator (download).
  2. 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.
  3. Download efp.msi (download). The install wizard for the Device Emulator will guide you through the installation process.
  4. 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.

  1. Download setup.msi for the ActiveSync VM (download)
  2. 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.

  1. Extract (unzip) the zip file containing the desired build to the root of the mini-SD card.
  2. Connect a USB/power cable to the handset.
  3. Power the handset while holding the Camera key down.
  4. 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.
  5. 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

Uninstalling the Software

This section contains information for uninstalling NetBeans Mobility Pack for CDC 5.5.1 from your system.

  1. Shut down the IDE.
  2. From the Control Panel, start Add or Remove Programs, select NetBeans Mobility Pack for CDC 5.5.1 and click Change/Remove.
  3. Follow the instructions in the uninstaller.

Note: You can also uninstall any or all of the Emulator platforms through the Windows Control Panel.

top

Troubleshooting

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.

Not logged in. Log in, Register

By use of this website, you agree to the NetBeans Policies and Terms of Use. © 2016, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo