Setting Up Your Build Environment

first | prev | next | last

This section describes how to prepare your Linux/i386 or Win32/i386 build environment for building the JavaCall porting layer, PCSL and CLDC reference ports, and the phoneME Feature client. You do this by downloading and installing required software tools (if needed) and setting important build environment variables.

This document contains the following sections:

Note: This document is part of the MR2 development release version of phoneME Feature software. The instructions have not been verified or tested. The contents will continue to change as development moves forward.

Setting Up the Linux/i386 Build Environment

To set up the Linux/i386 build environment to build phoneME Feature software for both Linux/i386 and Linux/ARM target platforms, set the environment variables shown in Table1-1 as system variables.

TABLE 1-1 Linux/i386 Build Platform Environment Variables

Name

Description

HOME

The location where you have installed the phoneME Feature software. For example, HOME=/home/chocolate/phoneME_feature.

BUILD_OUTPUT_DIR

The location where executables and other build output for phoneME Feature components are stored. For example, BUILD_OUTPUT_DIR=$HOME/build_output.

JDK_DIR

The directory that contains the JDK release. For example, JDK_DIR=/usr/java/j2sdk1.4.2_08.

PATH

Software development tools used in the Linux/i386 and Linux/ARM build processes, such as JDK, must be included in your PATH.

  1. Set your HOME environment variable to the location where you have installed the phoneME_feature directory.

    $ export HOME=your_install_dir/phoneME_feature

  2. Create the directory build_output and set the BUILD_OUTPUT_DIR variable.

    $ mkdir $HOME/build_output
    $ export BUILD_OUTPUT_DIR=$HOME/build_output

  3. Set the JDK_DIR variable.

    $ export JDK_DIR=/usr/java/j2sdk1.4.2_08

  4. Add JDK_DIR to your PATH.

    $ export PATH=$JDK_DIR/bin:$PATH

Acquiring and Installing Supporting Software

Depending upon how your Linux/i386 build platform is set up, you may (or may not) need to acquire the following additional software tools. To properly build phoneME Feature software on a Linux/i386 build platform, these tools need to be present in your build environment.

Note: Instructions for installing supporting software are provided with the software packages.

In addition, to cross-commpile phoneME Feature software for the Linux/ARM (P2 board) target platform, you must acquire and install the following software:

Setting Build Platform Environment Variables for Supporting Software

Once you have acquired additional build support tools for your Linux/i386 build platfom, set additional environment variables as shown in TABLE 1-2.

TABLE 1-2 Linux/i386 Build Platform Environment Variables

Name

Description

QTDIR

Points to the location where the Trolltech QT Toolkit graphics support package is installed. For example, QTDIR=/usr/lib/qt3.

GNU_TOOLS_DIR

Points to the location of MontaVista software development tools, which are used to build for a Linux/ARM target platform. For example, GNU_TOOLS_DIR=/opt/montavista/cee/devkit/arm/v4t_le/armv4tl-hardhat-linux.

Note: Set QTDIR as a system variable and set GNU_TOOLS_DIR on the command line when building for the Linux/ARM target platform.

  1. Set the QTDIR variable.

    $ export QTDIR=/usr/lib/qt3

  2. Add QTDIR to your PATH.

    $ export PATH=$PATH:$QTDIR/bin

Note: For ease of use, set the path to the MontaVista tools to a system variable not called by the make files. Then, on the Linux/ARM make command line, you can assign this variable to GNU_TOOLS_DIR. For example,

    $ export MONTAVISTA=/opt/montavista/cee/devkit/arm/v4t_le/armv4tl-hardhat-linux

    Then, on the make command line, to call the MontaVista development tools, you simply enter:

    GNU_TOOLS_DIR=$MONTAVISTA

    An example of this variable method is provided here.

Setting Up the Win32/i386 Build Environment

To set up your Win32/i386 platform, you must take the following steps:

Installing Cyg4Me

Before you build phoneME Feature on a Win32/i386 platform, download and install Cyg4Me, version 1.1. Cyg4Me is a standardized version of Cygwin for building Java ME platform products on Windows. It provides the necessary UNIX® system tools, such as sh and gnumake.

  1. Download the Cyg4Me zip file cyg4me1_1_full.zip.

    This file contains all the executables and libraries needed to build on the Win32/i386 platform.

  2. Unzip the file.

    3. For example, you could unzip the file into C:\cyg4me.

Setting Build Platform Environment Variables

To build the phoneME Feature software on a Win32/i386 platform, you must set the environment variables shown in TABLE 1-3.

TABLE 1-3 Win32/i386 Platform Environment Variables

Name

Description

HOME

The location where you have installed the phoneME Feature software. For example, HOME=C:\home\chocolate\phoneME_feature.

BUILD_OUTPUT_DIR

The location where executables and other build output for phoneME Feature components are stored. For example, BUILD_OUTPUT_DIR=%HOME%\build_output.

JDK_DIR

Directory that contains the JDK release. For example, JDK_DIR=C:\java\j2sdk1.4.2_08.

PATH

Must be set to include Cyg4Me and other tools used in the Win32/i386 build process.

  1. Set your HOME environment variable to the location where you have installed the phoneME_feature directory.

    $ set HOME=C:\your_install_dir\phoneME_feature

  2. Create the directory build_output as a folder and set the BUILD_OUTPUT_DIR variable.

    $ set BUILD_OUTPUT_DIR=%HOME%\build_output

  3. Set the JDK_DIR variable.

    $ set JDK_DIR=C:\java\j2sdk1.4.2_08

  4. You must add Cyg4Me and JDK_DIR to your PATH environment variable. Make the bin directory of your Cyg4Me installation the first element of your PATH, as shown here.

    $ set PATH=C:\cyg4me\bin;%JDK_DIR%\bin;%PATH%

Note: If you have previously installed Cygwin on your Win32/i386 platform, remove all PATH elements that point to those previous versions.
first | prev | next | last