Building a phoneME Feature Software Reference Port (MR3)

first | prev

The phoneME Feature Software is an Open Source version of Sun Microsystems' commercial implementation, the Sun Java Wireless Client software, version 2.1. The commercial version is based upon, and incorporates code from, the Open Source MR3 version of phoneME Feature software. The phoneME Feature software is built on top of CLDC, an Open Source version of Sun Microsystems' Connected Limited Device Configuration, HotSpot Implementation, version 2.1.

This document has the following sections:

For proper building and performance, your system must meet the requirements provided in Before You Begin.

Building phoneME Feature Software on a Windows x86 Build Platform

This section provides basic instructions for building a default phoneME Feature software implementation for the JavaCall porting layer on a Windows x86 target platform.

Setting Variables for a Windows x86 Build Platform

To properly build the phoneME Feature software on a Windows platform, you must set the environment variables shown in TABLE 5-1.

TABLE 5-1Required Windows x86 Build Variables

Name

Description

MIDP_OUTPUT_DIR

Location where the output from building phoneME Feature is stored. For example, MIDP_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/midp.

PCSL_OUTPUT_DIR

Location where the output from building PCSL is stored. Required for phoneME Feature to pick up PCSL libraries. For example, PCSL_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/pcsl.

CLDC_DIST_DIR

Required for building phoneME Feature software. Must point to the location of CLDC software build output. For example, CLDC_DIST_DIR=%BUILD_OUTPUT_DIR%/cldc/javacall_i386_vc/dist.

TOOLS_DIR

Location of tools generated during build process. Required for building phoneME Feature software. For example, TOOLS_DIR=%COMPONENTS_DIR%/tools.

TOOLS_OUTPUT_DIR

Defines a directory location for tools-specific output. For example, TOOLS_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/tools

USE_MULTIPLE_ISOLATES

Required for phoneME Feature to support multitasking. Must be set to true. If not explicitly set to true, the build defaults to false and phoneME Feature is built without multitasking capability.

Note: If you set USE_MULTIPLE_ISOLATES=true to build phoneME Feature software, you must also set ENABLE_ISOLATES=true to build CLDC, as described in Building a CLDC Reference Port.

JAVACALL_PLATFORM

Defines the JavaCall porting layer platform, cpu, and compiler. For example, JAVACALL_PLATFORM=win32_i386_vc.

JAVACALL_OUTPUT_DIR

Indicates the location where JavaCall porting layer output is stored. For example, JAVACALL_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/javacall.

Building for a Windows x86 Target Platform

To build the phoneME Feature software for a Windows x86 target platform, take the following steps.

  1. Set the MIDP_OUTPUT_DIR variable, as shown here.

    $ set MIDP_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/midp

  2. Change to the build directory, as shown here.

    $ cd %COMPONENTS_DIR%/midp/build/javacall

    Note: You can skip this step and use the make -C build option. For more information, see Building with the make -C Option.

  3. Run the make command as a single command-line string, as shown here.

    $ make PCSL_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/pcsl CLDC_DIST_DIR=%BUILD_OUTPUT_DIR%/cldc/javacall_i386_vc/dist TOOLS_DIR=%COMPONENTS_DIR%/tools TOOLS_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/tools USE_MULTIPLE_ISOLATES=true JAVACALL_PLATFORM=win32_i386_vc JAVACALL_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/javacall

    Note: It is possible to include optional packages in your Windows x86 target build. For more information, see Including Optional Packages in Your Build.

The generated output for Windows x86 target platform is found under %BUILD_OUTPUT_DIR%/midp.

Running phoneME Feature on a Windows x86 Target Platform

Once you build an implementation of phoneME Feature software, you can run a MIDlet using the Wireless Toolkit emulation device. However, before you can do this, you must take a few additional steps.

To prepare your phoneME Feature implementation for running, follow these steps:

  1. Ensure you have Wireless Toolkit (WTK) 2.5.2 installed on your machine.

  2. Copy the contents of the /WTK directory (not the directory itself) into your WTK root directory.

  3. Copy the contents of the /WTK_STORAGE directory (not the directory itself) into the WTK storage directory.

    Note: WTK 2.5.2 storage is located under C:/Documents and Settings/your_user_name/j2mewtk/2.5.2/appdb.

To start your phoneME Feature implementation:

  1. Change to the WTK root directory.

  2. Execute the following command:

    $ bin/emulator.exe

    Note: To get a list of supported parameters, run the bin/emulator.exe command with the -help option.

For additional information on running in the WTK Emulator, see the Sun Java Wireless Client Software Build Guide.

Building phoneME Feature Software Documentation

You can create HTML API documents for phoneME Feature software from porting interfaces. To do this for the phoneME Feature software, use the make docs_html build target.

Generating Javadoc Tool Documentation

Building Javadoc tool documentation is the same for all platforms.

  1. Change to the default build directory for your target platform.

    For example, this could be the Windows x86 target platform, as shown here.

    $ cd %COMPONENTS_DIR%/javacall-com/configuration/phoneMEFeature/win32_emul

  2. Build Javadoc tool HTML documentation.

    $ make docs_html

Viewing phoneME Feature Software Documents

Use any browser to display the Javadoc output file at the following URL:
first | prev