Building the JavaCall Porting Layer (MR3)

first | prev | next | last

The JavaCall porting layer provides a uniform set of APIs that improve and simplify the phoneME Feature software porting process.

To build a default implementation of the JavaCall porting layer, you take the following general steps:

Setting JavaCall Porting Layer Environment Variables

The JavaCall has five environment variables that must be set, as shown in Table 2-1.

Note: Make note of the values you choose for these variables. When executing the build procedures for PCSL, CLDC, and the phoneME Feature software client, you must set corresponding values.

TABLE 2-1Required JavaCall Porting Layer Build Variables

Name

Description

BuildDir

The location of your phoneME Feature build directory.

For example, BuildDir=%COMPONENTS_DIR%/javacall-com/configuration/phoneMEFeature/win32_emul.

JAVACALL_DIR

Specifies the location of the base JavaCall API source code and makefiles, which contains MIDP and specific optional packages, including the following:

Java Wireless Messaging (JSR 120)
Mobile Media API (JSR 135)
Security and Trust Services (JSR 177)
Content Handler API (JSR 211)

For example, JAVACALL_DIR=%COMPONENTS_DIR%/javacall.

PROJECT_JAVACALL_DIR

Specifies the location of additional JavaCall API source code and makefiles, which includes additional optional packages, including the following:

Personal Information and File Management (JSR 75)
Bluetooth (JSR 82)
Location API (JSR 179)
Wireless Messaging (JSR 205)
Advanced Multimedia Supplements (JSR 234)
Mobile Sensor API (JSR 256)

For example, PROJECT_JAVACALL_DIR=%COMMPONENTS_DIR%/javacall-com.

JAVACALL_OUTPUT_DIR

Defines the directory where the build system places its output. For example, JAVACALL_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/javacall.

TOOLS_DIR

Defines the directory where needed build tools are located. 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.

Note: The phoneME Feature client software is complex and flexible, and many build options are available. For more information on build options, see Sun Java Wireless Client Software Build Guide.

Building the JavaCall Porting Layer

To build an implementation of the JavaCall porting layer, take the following steps:

  1. Set the BuildDir variable based on where you picked up your JavaCall porting layer source files.

    For more information, see Table 2-1.

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

      $ make -C %BuildDir% JAVACALL_DIR=%COMPONENTS_DIR%/javacall PROJECT_JAVACALL_DIR=%COMPONENTS_DIR%/javacall-com JAVACALL_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/javacall TOOLS_DIR=%COMPONENTS_DIR%/tools TOOLS_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/tools

    Note: It is possible to include optional packages in your JavaCall porting layer build. The makefiles for building these optional packages are picked up from the repository and zip archive with the JavaCall source, but no optional packages are built unless other variables are set. For more information, see Including Optional Packages in Your Build.

When the make command has successfully completed, the JavaCall porting layer output is found in %JAVACALL_OUTPUT_DIR%.
first | prev | next | last