NetBeans Mobility Pack 5.0 Release Notes

Last Updated: 2 February 2006

Supported Platforms

Note: NetBeans™ Mobility Pack 5.0 requires Java SE 5.0_06 or later v. 5.0_x platform or optionally J2SE SDK v. 1.4.2_09 or later v. 1.4.x platform.

Java ME MIDP Development is supported on the following platforms:
• Microsoft Windows 2000 Professional SP3
• Microsoft Windows XP Professional SP2
• Fedora Core 3

The Mobility Pack includes the J2ME Wireless Toolkit, version 2.2.

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

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: https://netbeans.org/bugzilla/enter_bug.cgi?component=3rd-party.
The Component is "3rd-Party". The Subcomponent is "mobility pack".

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 J2ME Wireless Toolkit will not run if the name of, or path to, the Toolkit installation directory or user directory contains non-ASCII characters.
  
• The J2ME Wireless Toolkit 2.2 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 J2ME Wireless Toolkit 2.2 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.

• The Update Center does not work after you uninstall the Mobility Pack.
  

  Workaround: After you uninstall the Mobility Pack, remove the Java ME Platform SDK Catalog from the list of AutoUpdate Types. To do this, choose Tools >Options. Click Advanced Options. Expand IDE Configuration > System > AutoUpdate Types. Right click Java ME Platform SDK Catalog and delete it. Restart the NetBeans IDE.

• You cannot add external J2ME 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 J2ME 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 J2ME 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.

• Visual Mobile Designer projects saved in Mobility Pack 5.0 are not backwards-compatible with Mobility Pack 4.1 projects. Once you save a project in version 5.0, it cannot be reopened in version 4.1.
  
• 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 J2ME Wireless Toolkit 2.2.

  Workaround: Turn off hyperthreading while debugging.

Redistribution

DISTRIBUTION BY DEVELOPERS. Subject to the terms and conditions of the Software License Agreement and the obligation, restrictions, and exceptions set forth below, You may reproduce and distribute the Software (and also portions of Software identified below as Redistributable), provided that you:

(a) distribute the Software complete and unmodified and only bundled as
part of your Programs,

(b) do not distribute additional software intended to replace any
component(s) of the Software,

(c) if a Redistributable contains J2ME Wireless Toolkit (J2ME WTK), you represent and warrant that you have a valid agreement with Sun authorizing the commercial redistribution of the J2ME Wireless Toolkit (J2ME WTK),

(d) do not remove or alter any proprietary legends or notices contained in or on the Software.

(e) only distribute the Software subject to a license agreement that
protects Sun's interests consistent with the terms contained in this
Agreement, and

(f) agree to defend and indemnify Sun and its licensors from and against
any damages, costs, liabilities, settlement amounts and/or expenses
(including attorneys' fees) incurred in connection with any claim,
lawsuit or action by any third party that arises or results from the use
or distribution of any and all Programs and/or Software.

The following Software components are Redistributables:

NETBEANS MOBILITY PACK 5.0

• mobility7.2/LICENSE.txt
• mobility7.2/ant/nblib/org-netbeans-modules-kjava-j2meproject.jar
• mobility7.2/modules/org-netbeans-modules-kjava.jar
• mobility7.2/modules/org-netbeans-modules-kjava-antext.jar
• mobility7.2/modules/org-netbeans-modules-kjava-j2meplatform.jar
• mobility7.2/modules/org-netbeans-modules-kjava-j2meplatform-catalog.jar
• mobility7.2/modules/org-netbeans-modules-kjava-j2meproject.jar
• mobility7.2/modules/org-netbeans-modules-kjava-j2mejavahelp.jar
• mobility7.2/modules/org-netbeans-modules-kjava-examples.jar
• mobility7.2/modules/org-netbeans-modules-kjava-editor.jar
• mobility7.2/modules/org-netbeans-modules-kjava-obfuscators-proguard.jar
• mobility7.2/modules/org-netbeans-modules-kjava-j2meunit.jar
• mobility7.2/modules/org-netbeans-modules-kjava-emulators.jar
• mobility7.2/modules/org-netbeans-modules-mvd.jar
• mobility7.2/modules/org-netbeans-modules-vmd-components-nbmidp.jar
• mobility7.2/modules/org-netbeans-modules-e2e-end2end.jar
• mobility7.2/modules/org-netbeans-modules-e2e-jsr172.jar
• mobility7.2/modules/org-netbeans-modules-deployment-ftpscp.jar
• mobility7.2/modules/org-netbeans-modules-deployment-webdav.jar
• mobility7.2/modules/org-netbeans-modules-deployment-sonyericsson.jar
• mobility7.2/modules/docs/org-netbeans-modules-kjava-j2mejavahelp.jar
• mobility7.2/modules/scr/deploy-copy-impl.xml
• mobility7.2/modules/scr/deploy-scp-impl.xml
• mobility7.2/modules/scr/deploy-ftp-impl.xml
• mobility7.2/modules/scr/deploy-webdav-impl.xml
• mobility7.2/modules/scr/deploy-sonyericsson-impl.xml
• mobility7.2/modules/ext/j2meunit-1.1.1.jar
• mobility7.2/modules/ext/graphlib.jar
• mobility7.2/modules/ext/nb_midp_components.jar
• mobility7.2/modules/ext/j2mewcw-core.jar
• mobility7.2/modules/ext/commons-net-1.4.1.jar
• mobility7.2/modules/ext/jakarta-oro-2.0.8.jar
• mobility7.2/modules/ext/activation.jar
• mobility7.2/modules/ext/saaj-impl.jar
• mobility7.2/modules/ext/mail.jar
• mobility7.2/modules/ext/jaxrpc-api.jar
• mobility7.2/modules/ext/jaxrpc-impl.jar
• mobility7.2/modules/ext/xsdlib.jar
• mobility7.2/modules/ext/schema2beansdev.jar
• mobility7.2/modules/ext/j2me_sg_ri.jar
• mobility7.2/modules/ext/saaj-api.jar
• mobility7.2/modules/ext/xml-helper.jar
• mobility7.2/modules/ext/jaxrpc-spi.jar

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.0 Features and Download Page
• NetBeans Mobility Pack Quick Start Guide
• Importing Existing Java ME MIDP Source Code into NetBeans IDE 50