Setting Up Your Build phoneME Feature Environment (MR4)

Setting Up Your Build phoneME Feature Environment (MR4)

This section describes how to prepare your Windows x86 build environment for building the JavaCall porting layer, PCSL, CLDC, and phoneME Feature client software.

This document contains the following sections:

* Setting Up the Windows x86 Build Environment

To properly use this document, two kinds of variables are set:

* Optional - Not required by the phoneME Feature build scripts. However, setting them makes this document easier to follow and use.

* Required - Required by the phoneME Feature build scripts.

Both kinds of variables are described in the following sections.

Setting Up the Windows x86 Build Environment

To set up your Windows x86 platform, you must take the following general steps:

* Install Cyg4Me
* Set up your Windows x86 work environment
* Set Windows x86 platform environment variables

Installing Cyg4Me

Before you build phoneME Feature on a Windows x86 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 Windows x86 platform.

2. Unzip the file.

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

Setting Up Your Windows Work Environment

To properly set up your Windows work environment, you must run the Windows batch file, vcvars32.bat, as shown here:

"C:\Program Files\Microsoft Visual Studio 8\VC\bin\vcvars32.bat"

The vcvars32.bat file sets several Windows variables, including LIB, INCLUDE, and others.

Due to variations in Windows system configuration, the directory path to the vcvars32.bat file might differ from that shown here. If so, use the Windows Explorer to search for vcvars32.bat.

Note: If using a Windows path with spaces, as shown above, doesn't work, try entering a substitute path using Windows short names.

To find the short names for your directory path, change to each directory that has spaces and type:

$ dir /x

You can use also the cygpath utility (from Cyg4me) to get the Windows short name. For example:

$ cygpath -ms "C:\Program Files\Microsoft Visual Studio 8\VC\bin"

delivers the short name

C:/PROGRA~1/MICROS~2/VC/bin

If your compiler is Microsoft Visual Studio 2003, you might better set up your Windows work environment using the file vsvars32.bat. Run this Windows batch file as shown here:

C:\Program Files\Microsoft Visual Studio .NET 2003\Common7\Tools\vsvars32.bat

Note: Building phoneME Feature using Microsoft Visual Studio .NET 2003 may work, but it is not fully supported. For best results, use Microsoft Visual Studio 2005, as described in Requirements for Building on a Windows x86 Platform.

Setting Build Platform Environment Variables

To set up the Windows x86 build environment to build phoneME Feature software for the JavaCall porting layer on Windows x86 target platform, set the optional build variables shown in Table1-1 and the required build variables as shown Table1-2.

TABLE 1-1Optional Windows x86 Build Platform Variables

Name


Description

COMPONENTS_DIR


The location where you install the phoneME Feature software. For example, COMPONENTS_DIR=C:/home/chocolate/phoneME_feature.

Note: The sample directory /home/chocolate can also be referred to by the convention InstallDir. For example, InstallDir/phoneME_feature.

BUILD_OUTPUT_DIR


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

TABLE 1-2Required Windows x86 Build Platform Variables

Name


Description

JDK_DIR


Directory that contains the JDK software release. For example, JDK_DIR=C:/java/j2sdk1.6.0_07.

CYG4ME


Location where you download and unzip Cyg4Me. For example, CYG4ME=C:\cyg4me.

PATH


Must be set to include Cyg4Me and other tools used in the Windows x86 build process.

Setting Build Variables

1. Set your COMPONENTS_DIR environment variable to the location where you install the phoneME_feature directory.

$ set COMPONENTS_DIR=C:/InstallDir/phoneME_feature

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

$ set BUILD_OUTPUT_DIR=%COMPONENTS_DIR%/build_output

3. Set the JDK_DIR variable.

$ set JDK_DIR=C:/java/j2sdk1.6.0_07

Note: As shown in this command line, the JDK_DIR path must be set using Linux (forward) slashes.

4. Set the CYG4ME variable, as shown here:

$ set CYG4ME=C:\cyg4me

5. 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=%CYG4ME%\bin;%JDK_DIR%/bin;%PATH%

Note: If you previously installed Cygwin on your Windows x86 platform, remove all PATH elements that point to those previous versions.