Getting Started with phoneME Feature Software (MR2)

# 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: Setting Up the Linux/i386 Build Environment Setting Up the Win32/i386 Build Environment 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.
Set your HOME environment variable to the location where you have installed the `phoneME_feature` directory. `$ export HOME=`your_install_dir`/phoneME_feature` Create the directory `build_output` and set the `BUILD_OUTPUT_DIR` variable. `$ mkdir $HOME/build_output` `$ export BUILD_OUTPUT_DIR=$HOME/build_output` Set the `JDK_DIR` variable. `$ export JDK_DIR=/usr/java/j2sdk1.4.2_08` 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. GNU Make 3.79.1 or later GNU Compiler GCC 3.4.6 or later Trolltech QT Toolkit, version 3 graphic support package 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: MontaVista CEE 3.1 ADK developer tools 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. Set the `QTDIR` variable. `$ export QTDIR=/usr/lib/qt3` 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: Install Cyg4Me Set win32/i386 platform environment variables 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`. 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. Unzip the file. 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.
Set your HOME environment variable to the location where you have installed the `phoneME_feature` directory. `$ set HOME=C:\`your_install_dir`\phoneME_feature` Create the directory `build_output` as a folder and set the `BUILD_OUTPUT_DIR` variable. `$ set BUILD_OUTPUT_DIR=%HOME%\build_output` Set the `JDK_DIR` variable. `$ set JDK_DIR=C:\java\j2sdk1.4.2_08` 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