Building the JavaCall Porting Layer (MR2 - Win32 on i386 Only)

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 three 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, if you picked up the JavaCall porting layer source code from the repository, set this variable as BuildDir=%MEHOME%/javacall/configuration/phoneMEFeature/win32_x86.

If you picked up the JavaCall porting layer source code from the download zip archive, set this variable as BuildDir=%MEHOME%/javacall-com/configuration/phoneMEFeature/win32_x86.

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)
ABB parts of Mobile Media APIs (JSR 135)
Security and Trust Services (JSR 177)
Content Handler API (JSR 211)

For example, JAVACALL_DIR=%MEHOME%/javacall.

JAVACALL_PROJECT_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)
Win32-only pieces of Mobile Media APIs (JSR 135)
Location API (JSR 179)
Wireless Messaging (JSR 205)
Mobile Internationalization (JSR 238)

For example, JAVACALL_PROJECT_DIR=%MEHOME%/javacall-com.

JAVACALL_OUTPUT_DIR

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

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 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.

    If you picked up the JavaCall porting layer source code from the repository, use the following command-line string:

      $ make -C %BuildDir% JAVACALL_DIR=%MEHOME%/javacall JAVACALL_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/javacall

    If you picked up the JavaCall porting layer source code from the zip archive, use the following command-line string:

      $ make -C %BuildDir% JAVACALL_DIR=%MEHOME%/javacall JAVACALL_PROJECT_DIR=%MEHOME%/javacall-com JAVACALL_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/javacall

    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