Building a PCSL Reference Port (phoneME Feature MR4)
This document contains instructions for building a PCSL reference port. It has the following sections:
* Building PCSL Software on a Windows x86 Build Platform
* Building PCSL Documentation
PCSL libraries are used to build CLDC and the phoneME Feature software client. PCSL contains several individual services, including file, network, memory, and print. Follow the procedures in this section to build a default PCSL reference port containing libraries, tools, tests, and documentation bundles for the following target platforms:
* Windows x86
Note: Although each PCSL service can be individually built, this document describes how to build the full PCSL only.
Building PCSL Software on a Windows x86 Build Platform
This section describes how to build PCSL on the Windows x86 build platform, for a JavaCall porting layer on a Windows x86 target platform, as shown in Table 3-1.
Note: Make a note of the values you choose for these variables. When building the CLDC and phoneME Feature software client, you must set corresponding values.
Setting PCSL Environment Variables for a Windows x86 Build Platform
TABLE 3-1Required PCSL Build Variables for Windows x86
Name
Description
PCSL_PLATFORM
Identifies the target operating system, the target CPU, and the compiler that the build system uses to create the PCSL library. Its value has the form os_cpu_compiler.
The value of this variable is javacall_i386_vc. The vc indicates the Microsoft Visual Studio compiler.
PCSL_OUTPUT_DIR
Specifies the location where the build system puts PCSL output. For example, this could be %BUILD_OUTPUT_DIR%/pcsl.
JAVACALL_OUTPUT_DIR
If you are building a JavaCall porting layer implementation, this specifies the location of the JavaCall porting layer output.
TOOLS_DIR
Defines the directory where needed build tools are located. For example, TOOLS_DIR=%COMPONENTS_DIR%/tools.
TOOLS_OUTPUT_DIR
Defines a directory location for tools-specific output. For example, TOOLS_OUTPUT_DIR=%BUILD_OUTPUT_SIR%/tools.
USE_VS2005
Tells the build system to use Microsoft Visual Studio 2005 as the default compiler. For example, USE_VS2005=true.
Building for a Windows x86 Target Platform
1. Run the make command as a single command-line string, as shown here.
$ make -C %COMPONENTS_DIR%/pcsl PCSL_PLATFORM=javacall_i386_vc PCSL_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/pcsl JAVACALL_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/javacall TOOLS_DIR=%COMPONENTS_DIR%/tools TOOLS_OUTPUT_DIR=%BUILD_OUTPUT_DIR%/tools USE_VS2005=true
The PCSL build output is found under %PCSL_OUTPUT_DIR%/javacall_i386
Building PCSL Documentation
To build Doxygen API documentation in HTML format from PCSL porting interfaces, you must install the Doxygen tool. It can be acquired from http://www.doxygen.org
Generating Doxygen Documentation
The procedure for building Doxygen documentation is the same for both Linux and Windows build platforms.
1. Change to the PCSL directory:
$ cd %COMPONENTS_DIR%/pcsl
2. Run the make doc command:
$ make doc
Note: The build system assumes that the Doxygen executable is in the directory /usr/bin/doxygen. If your executable is installed in a different location, use the DOXYGEN_CMD variable to define the new location. For example:
$ make DOXYGEN_CMD=doxygen_dir doc
where doxygen_dir is the location of your Doxygen executable.
Viewing PCSL Documents
Use any browser to display the Doxygen output file at the following URL:
file://%PCSL_OUTPUT_DIR%/doc/doxygen/html/index.html