NetBeans Mobility Pack 5.5.1 Release Notes

Welcome to NetBeans Mobility Pack for CLDC 5.5.1, an add-on pack that provides the tools for creating Java Micro Edition (Java ME) applications that support the Connected, Limited Device Configuration (CLDC)/Mobile Information Device Profile (MIDP) technologies. The Mobility Pack for CLDC includes the Sun Java Wireless Toolkit version 2.5.1.

Note: If you are looking for information about installing the NetBeans Mobility Pack for CLDC 5.5.1, see the NetBeans Mobility Pack for CLDC 5.5.1 Installation Guide.

System Requirements

Supported Operating Systems

The NetBeans Mobility Pack for CLDC 5.5.1 runs on the Java SE JDK versions 5.0 or 6.0, which consists of the Java Runtime Environment plus developer tools for compiling, debugging, and running applications written in the Java language.

The NetBeans Mobility pack for CLDC runs on Microsoft Windows systems that support the Java VM. Below is a list of platforms that NetBeans IDE has been tested on.

• Microsoft Windows Vista
• Microsoft Windows XP Professional SP2
• Ubuntu 6.x

Note: The platforms supported by the NetBeans Mobility Pack might differ from those supported by the emulator you plan to use. You should verify that both the Mobility Pack and the emulator you plan to use are supported on your particular platform.

Bugs and Issues

Please remember that NetBeans Mobility Pack 5.5.1 must be run on NetBeans 5.5.1. Some features might not work with NetBeans 5.5.

To file a new bug, request a new feature or feature enhancement, or check on the status of an existing bug, use the Issuezilla bugtracking system: http://www.netbeans.org/issues/enter_bug.cgi?component=mobility&version=5.5.1

Note: Projects created with the Visual Mobile Designer in earlier versions of the Mobility Pack will be upgraded to a new format when opened in version 5.5. For specific details, see http://wiki.netbeans.org/wiki/view/MobilityVisualDesignerVersions.

The major unresolved issues for this release are as follows:

• The NetBeans Mobility Pack will not run if the name of, or path to, the installation directory or user directory contains non-ASCII characters.
  
• The Sun Java Wireless Toolkit will not run if the name of, or path to, the Toolkit installation directory or user directory contains non-ASCII characters.
  
• The Sun Java Wireless Toolkit 2.5.1 emulator does not support multibyte characters in a Mobility project name or in a Java class that will become the name of a MIDlet or MIDlet suite. You can develop such a project using the IDE, but you will not be able build or run the application if you are using the Sun Java Wireless Toolkit 2.5.1 as your target platform.
  

  Workaround: Use ASCII characters only in the name of the project and program class names, or configure the project to use an emulator that supports multibyte characters.

• You cannot add external Sun Java Wireless Toolkit emulators in the Linux distribution under certain permissions.
  
  When adding the platform using the Java Platform Manager (JPM), the tool's browser recognizes any Sun Java Wireless Toolkit directories and marks them with the appropriate icon in the file dialog. If you attempt to add an external Wireless Toolkit on Linux installed under root or a different user account, however, the process fails even though the Wireless Toolkit installation appears valid. This is a known issue and is caused by wrong permissions set on the Wireless Toolkit executables. As a result the JPM cannot execute the emulator executable and get the detailed information it needs about the platform.

  Workaround: Install the external Sun Java Wireless Toolkit under the same user account as the one you use to run the NetBeans IDE. Optionally, if you have root access you can change the permissions on the Wireless Toolkit directories and executables but that is not advisable as it can cause major problems for other users using that Wireless Toolkit installation.

• Issue #79039: Cannot Generate Mobile Client To Web Application for J2EE 5 Web service clients
  
  The Mobile Client to Web Application wizard doesn't work with Web services client created in J2EE 5 format. The wizard doesn't show these Web service clients in the combo box on the first panel.

Workaround: Create a new J2EE 1.4 Web project and add Web service client to your desired service. From the Mobility project just select web service client added to this new project.

• Run through OTA can be very slow.
  
• If you add multiple custom components to the MIDP Visual Designer Component Palette, the last custom component added occasionally becomes unusable.

Workaround: Remove the custom component and add it again using the Component Palette Manager.

• Emulator opens, but no MIDlet is shown when debugging a multi-threaded application, or when an application is being debugged on dual machines. This is due to a bug in the Sun Java Wireless Toolkit 2.5.1.

  Workaround: Turn off hyperthreading while debugging.

• When you create a new Mobile Client to Web Application, a sample MIDlet can not be generated if the parameter of the Web service is a type that can not be easily represented in the Visual Mobile Developer, such as an array.
• Issue #73286: byte[] elements are not recognized in WSDL.
  The stub generator cannot properly generate methods returning an object of type: byte[] (if char is supported by WS-I BP 1.0).
• Issue 75238: A sample MIDlet isn't generated for some return types in a Mobile Client to Web Application.
  This occurs when the return type of the Web service is not suitable for the Visual Mobile Developer, such as an array of bytes.
• Issue #90112: The Mobile Client to Web Application wizard cannot generate a Web service client.
  The Mobile Client to Web Application wizard cannot generate a Web service client if the path for the generated stubs contains a space character.

Documentation

Documentation is provided for the NetBeans Mobility Pack in the form of web-based guides and the IDE's help system. You can use the following documents to get started:

• NetBeans Mobility Pack 5.5 Features and Download Page
• NetBeans Mobility Pack 5.5 Quick Start Guide
• Importing Existing Java ME MIDP Source Code into NetBeans IDE 5.5