Downloading phoneME Feature Software Source Code (MR4)

Taken together, the phoneME Feature source files, plus the emulator and Qsound binary plugins, provide everything needed to build the phoneME Feature software.

Note: To build JSR 239, you also need an OpenGL ES engine. For instructions on how to build JSR 239, see the engine documentation and Sun Java Wireless Client Software Build Guide.

To check out the source code from the Subversion repository you must have a Subversion client installed on your platform. For more information on using Subversion, see the phoneME Feature Access page.

For more information on the structure of the phoneME Feature source code repository and how to work with it, see the phoneME Repository Structure page.

Downloading the Source Code Zip Archive File

To download the source code zip file, take the following steps:

1. Create a top-level directory on your platform in which to unzip the phoneME Feature source zip file. Name this directory whatever you choose. For example:

   C:\> mkdir mr4

2. Go to the phoneME Feature Downloads page and click the MR4 zip file name to copy it to your platform.

3. Once the file is downloaded, unzip the file into the directory you have assigned as your top-level source directory.

   C:\> unzip phoneme_feature-mr4-rel-src-buildnum-date.zip -d C:\mr4

4. Once you have unpacked your phoneME Feature sources, assign your <top_level_source_dir>/phoneme_feature directory to the variable %COMPONENTS_DIR%, as shown in the following example. For more information on setting variables, see Setting Variables for Your Build Environment.

   C:\> set COMPONENTS_DIR=C:/mr4/phoneme_feature

   For more information on setting the %COMPONENTS_DIR% variable, see Table 1-1.

Downloading the Qsound and Emulator Binary Files

Once you have created the phoneme_feature directory and installed the phoneME Feature source files, follow these steps to install the Qsound and emulator binary files:

1. Go to the phoneME Feature downloads page and click the Qsound zip file name to copy it to your platform.

2. Once the file is downloaded, unzip the file into the top-level directory you have created.

   C:\> unzip qsound.zip -d C:\mr4

3. Make another top-level directory for the phoneME Feature emulator. This directory should be different than the top-level directory you created for the phoneME Feature source. For example:

   C:\> mkdir mr4_emulator

4. Go to the phoneME Feature downloads page and click the emulator zip file name to copy it to your platform.

5. Once the emulator file is downloaded, unzip the file into the newly-created emulator directory. For example:

   C:\> unzip phoneme_feature_-mr4-rel-emulator-buildnum-win-date.zip -d C:\mr4_emulator

6. Once you have unpacked your emulator files, assign the <top_level_emulator_dir>/phoneme_feature directory to the variable %EMULATOR_DIR%, as shown in the following example.

   C:\> set EMULATOR_DIR=C:/mr4_emulator/phoneme_feature

   For more information on setting the %EMULATOR_DIR% variable, see Table 5-1.

Checking Out the Source Code Repository

To check out the phoneME Feature source code repository, you must first install a Subversion client on your platform. Once the client is installed, take the following steps:

1. Create a top-level directory on your platform and change To it. For example:

   C:\> mkdir mr4

2. In your top-level directory, create a sub-directory for your source. For example:

   C:\> mkdir phoneme_feature

3. Assign your top-level and sub-directory to the variable %COMPONENTS_DIR%. For example:

   C:\> set COMPONENTS_DIR=C:/mr4/phoneme_feature

   Note: Checking out phoneME Feature code from the source repository is a different process than downloading and unzipping the phoneME Feature zip file. Therefore, the directory location you set for the %COMPONENTS_DIR% variable may differ for each operation.

4. Change directory to %COMPONENTS_DIR%

   C:\> cd mr4/phoneme_feature

5. Check out the source code using the following command:

   % svn co https://phoneme.dev.java.net/svn/phoneme/components/component_name/trunk component_name

   Note: In the phoneME Feature URL command string, component_name is the name of the component you are working with. For example, if you are checking out the MIDP component, substitute midp for component_name in both places.

6. Go to the phoneME Feature downloads page and click the Qsound zip file name to copy it to your platform.

7. Unzip the Qsound file into your phoneME Feature source repository location. For example:

   C:\> unzip qsound.zip -d C:\mr4

8. Follow steps 3-6 in the section Downloading the Qsound and Emulator Binary Files to install the emulator with your phoneME Feature source.

Updating the Source Code

If you are working in the phoneME Feature software source code repository, you can periodically update your code to get the latest checkins and improvements. Do the following:

1. Change to the directory for the component you want to update, for example, MIDP.

   C:\> cd mr4/phoneme_feature/midp

2. Enter the update command to update the component, as shown here.

   C:\> svn update

If you want to update other components, repeat the above steps for those components.

Copyright © 2009 Sun Microsystems, Inc. All rights reserved.