# Release Notes ## J2ME Wireless Toolkit 2.2 #### October 2004

## Table of Contents

1. Overview
2. System Requirements
3. Installation Instructions
4. Differences Between Linux and Microsoft Windows Versions of the J2ME Wireless Toolkit
5. Running the Toolkit
6. Running the Toolkit in an IDE
7. Known Bugs
8. Frequently Asked Questions

## 1. Overview

The J2ME Wireless Toolkit is a set of tools for creating MIDP applications. It consists of three main components:

- KToolbar automates many of the tasks involved in creating MIDP applications.
- The emulator is a simulated mobile phone. It is useful for testing MIDP applications.
- A collection of utilities provides other useful functionality, including a text messaging console and cryptographic utilities.

The J2ME Wireless Toolkit implements impressive capabilities which are exposed through standard APIs. The APIs are defined through the Java Community Process (JCP):

- Connected Limited Device Configuration (CLDC) 1.1 (JSR 139)
- Mobile Information Device Profile (MIDP) 2.0 (JSR 118)
- Java Technology for the Wireless Industry (JTWI) 1.0 (JSR 185)
- Wireless Messaging API (WMA) 2.0 (JSR 205)
- Mobile Media API (MMAPI) 1.1 (JSR 135)
- PDA Optional Packages for the J2ME Platform (JSR 75)
- Java APIs for Bluetooth (JSR 82)
- J2ME Web Services Specification (JSR 172)
- Mobile 3D Graphics API for J2ME (JSR 184)

For more information on using the J2ME Wireless Toolkit to develop applications, see the User's Guide.

Please send your comments to .

## 2. System Requirements

This section describes the system requirements for running the J2ME Wireless Toolkit.

### 2.1 Required Software

- One of the following operating environments:
  - Microsoft Windows XP
  - Linux (unsupported)
- JavaTM 2 SDK, Standard Edition (J2SE SDK), version 1.4.2 - if you plan to do actual development, or JavaTM 2, Standard Edition Runtime Environment (JRE), version 1.4.2 - if you only plan to run the demonstration applications.

  To download the SDK or JRE you want, go to http://java.sun.com/j2se/downloads.html

NOTE: The Linux version of the toolkit is unsupported and has undergone only limited testing on the Red Hat 9.0 distribution.
We plan to release new Linux versions of the toolkit, however, we cannot commit to doing so with the same frequency as, nor simultaneously with, new Microsoft Windows versions. In addition, we cannot commit to making fully supported Linux versions of the toolkit.

### 2.2 Required Hardware

Minimum hardware requirements are:

- 50 MB hard disk space
- 128 MB system RAM
- 800 MHz Pentium III CPU

## 3. Installation Instructions

### 3.1 Windows

Run the installer, `j2me_wireless_toolkit-2_2-bin-win.exe`. Follow the instructions provided by the installer.

### 3.2 Linux

To install the toolkit, run the self-extracting installer, `j2me_wireless_toolkit-2_2-bin-linuxi386.bin`.

To complete installation of the Wireless Toolkit, you must have the J2SE SDK version 1.4.2 installed. If you only want to use the Wireless Toolkit with the J2SE Runtime Environment (JRE), version 1.4.2, you must have the ZIP utility installed.

If you want to install the toolkit into a directory that requires root access, become the root user before running the installer.

## 4. Differences Between Linux and Microsoft Windows Versions of the J2ME Wireless Toolkit

The Linux version of the J2ME Wireless Toolkit differs from the Microsoft Windows version in the following respects:

- It does not create a filename association for JAD files (`.jad`) in the window manager or web browser.
- The names of some filenames and directories are different:

  Microsoft Windows File or Directory | Linux Equivalent
  --- | ---
  `bin\ktoolbar.exe` | `bin/ktoolbar`
  `bin\emulator.exe` | `bin/emulator`
  `bin\prefs.exe` | `bin/prefs`
  `bin\DefaultDevice.exe` | `bin/defaultdevice`
  `wtklib\Windows\` | `wtklib/Linux/`

The Linux version of the wireless toolkit comes with the same documentation as the Microsoft Windows version. Almost all of the documentation for the Microsoft Windows version can be applied to the Linux version, except that all backslashes ('`\`') in paths should be treated as forward slashes ('`/`').

Although all screen shots in the documentation were taken on Microsoft Windows, the items portrayed in the screen shots look nearly identical, if not exactly the same, on the Linux version of the toolkit.

## 5. Running the Toolkit

### 5.1 Windows

The installer creates a new program group, J2ME Wireless Toolkit 2.2. This group contains the following aliases:

- Default Device Selection can be used to select the default emulator skin.
- Documentation is a link to the documentation home.
- KToolbar is the main entry point for the toolkit. Most other functions in the toolkit are accessible from KToolbar.
- OTA Provisioning is useful for testing the installing of applications.
- Preferences provides a way to directly launch the emulator preferences.
- Run MIDP Application is a shortcut for running a packaged application without having to run KToolbar.
- Utilities launches the toolkit's utilities window.

### 5.2 Linux

You can run the J2ME Wireless Toolkit from the command line using commands from the directory j2mewtk.dir`/bin`, where j2mewtk.dir is the toolkit's installation directory.

Command | Action
--- | ---
`ktoolbar` | Starts the KToolbar.
`defaultdevice` | Enables you to specify the default emulation device.
`prefs` | Enables you to set the toolkit preferences.
`utils` | Enables you to access the toolkit's utilities.
`emulator` | Enables you to run the emulator from the command line.

## 6. Running the Toolkit in an IDE

This release of the J2ME Wireless Toolkit can be integrated with Java integrated development environments (IDEs), such as Sun Java Studio Mobility. For information on how to use the J2ME Wireless Toolkit within an IDE, refer to the documentation for the specific IDE.

## 7. Known Bugs

This is not an exhaustive list of known bugs. It includes those bugs that developers are most likely to encounter in using the toolkit.

Bug ID | Description
--- | ---
5060533 | Recieved MMS text parts are not displayed in the WMA console.
5010166 | Back faces of triangles in `TriangleStripArray` are incorrectly shaded in some instances.
5073838 | The method `RemoteDevice.encrypt(false)` returns `true` even though encrypt is in force mode in the Preferences window.

## 8. Frequently Asked Questions

For answers to common questions, see the FAQ.

For feedback on this release, send email to .

Copyright © 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to the license terms.