Before You Begin (MR3)

first I prev | next | last

This document contains the following sections:

Note: This section contains information you might find useful while working through the phoneME Feature installation process. It is for your information only. If you want to begin downloading and installing the phoneME Feature software right away, see Downloading the phoneME Feature Software Source Code.


Document Notes and Conventions

For your ease of use, this guide uses the following conventions:


Setting Variables for Your Build Environment

Preparing your build environment requires you to set environment variables for your Windows x86 build platforms. The specific variables that need to be set are described in the remainder of this document.

Build environment variables can be set in two ways:

Setting System Variables

On a Windows x86 build platform, a system variable is set in the following way:

Setting Command-Line Variables

On a Windows x86 build platform, a command-line variable is set in the following way:

Note: Typing make on the command-line by itself is the same as typing make all.


Including Optional Packages in Your Builds

Optional packages can be included in the JavaCall porting layer and phoneME Feature software client builds by adding the appropriate optional package variable pairs to the make command line.

To do this, use the following variable format, where XXX is the JSR number:

For example, to build the JavaCall porting layer to include JSR 120 (Wireless Messaging APIs), the make command-line looks like this:

    $ make USE_JSR_120=true JSR_120_DIR=%COMPONENTS_DIR%/jsr120

Note: For optional packages with two-digit numbers, the format is USE_JSR_XX and JSR_XX_DIR.

In addition to the JSR variables shown above, you must also use the following variables when building optional packages:

Certain JSRs have dependencies that must be taken into consideration when building optional packages. For example, to properly build JSR 234, Advanced Multimedia Supplements API, you must also build JSR 135, Mobile Media API.

For more information on using optional package variables and the dependencies between specific optional packages, see Sun Java Wireless Client Software Build Guide.

Note: Builds for PCSL and CLDC do not require optional packages to be included, even if they are built in the JavaCall porting layer and the phoneME Feature software client. However, if optional packages are included in the build for the phoneME Feature client software, the same optional packages must be included in the JavaCall porting layer build.


Building With the make -C Option

When using make to build the JavaCall porting layer, PCSL, CLDC, and phoneME Feature software, the -C option is used to specify the directory where the build is performed. Using the -C option enables you to build in the correct location without changing to the build directory before the build is launched.

For improved usability, this guide directs you to change to the build directory before building a component. However, if you choose, you can launch your build from any directory using the make -C option.

For example, if the build directory for building the JavaCall porting layer on an Windows x86 target platform in the phoneME Feature client is %COMPONENTS_DIR%/midp/build/javacall, enter the following:

    $ make -C %COMPONENTS_DIR%/midp/build/javacall flag1 flag2 flag3


first | prev | next | last