WordPress for BlackBerry Building HOW-TO:
---------------------------------------
This file contains the instructions to build the source code

1. Required tools

    - Download and install Apache Ant: http://ant.apache.org/ (version 1.7)
    - Download and install Sun Java Wireless Toolkit: http://java.sun.com/products/sjwtoolkit/ (version 2.5.2)
    - Download and install Blackberry JDE ComponentPack 4.5.0_4.5.0.16 or higher : http://na.blackberry.com/eng/developers/ 
    - Download and install Blackberry JDE 4.7: http://na.blackberry.com/eng/developers/ (version 4.7)
    - Download and install Blackberry JDE 5.0: http://na.blackberry.com/eng/developers/ (version 5.0)
    - Download and install Blackberry JDE 6.0: http://na.blackberry.com/eng/developers/ (version 6.0)
    - Download and install Eclipse 3.5 Classic and the Blackberry JDE Plug-in for Eclipse 1.1 or higher. 

Note: Some Ant build tasks are using feature from svnant-1.3.0 library. (to read informations inside svn properties files). 
You should checkout this project from svn server using Subversion 1.6.x client features and working copy format.
If you checkout the project using a previous svn client, such as 1.5.x, you should not be able to build the project.

2. Required certificates

   WordPress for BlackBerry uses restricted APIs provided by RIM. For
   the application to work on real devices, it is necessary to sign it with a
   RIM certificate. Signature keys are provided directly by RIM. The application
   uses all the APIs but the crypto ones.

3. Pre-Build process configuration

3.1 Unzip the package into your working directory (<blackberry-dir>)

3.2 Open build.properties file in your editor

3.3 Set the right values for:
    Your blackberry JDE home:

    - rim.home.os45=<JDE 4.5 - home>
      Example: rim.home=C:/Program Files/Research In Motion/BlackBerry JDE 4.5.0.16
      or if you are using eclipse JDE Plug-in
      C:/opt/eclipseRIM4.2.1/plugins/net.rim.eide.componentpack4.5.0_4.5.0.16/components
  
    - rim.home.os47=<JDE 4.7 - home >
      Example: rim.home=C:/Program Files/Research In Motion/BlackBerry JDE 4.7.0

    - rim.home.os50=<JDE 5.0 - home >
      Example: rim.home=C:/Program Files/Research In Motion/BlackBerry JDE 5.0.0

    - Your signature password. This password is provided by RIM together with
      the certificates.
      Example: bb.sigtool.password=XXXXX

    - Your build type: default value is release but you may want to enable the debug options
      Example: build.type=release

    Save the file and exit.

4. Building the source
4.1 Open a command prompt and go to the directory <blackberry-dir>/build
4.2 Type "ant simulator" (or "ant release") and press ENTER to build the client. The build process
    generates the required cod files. There are two sets of cod files:

    - <blackberry-dir>/output/xxx/release contains cod files which are suitable for
      the emulator (they are not broken into chunks by rapc). xxx can be os45 or
      os47.

    - <blackberry-dir>/output/xxx/release/ota contains the cod files suitable for
      OTA installation. xxx can be os45, os47 or os50.

    In both directories there is a proper jad file for the installation.

4.3 "ant usage" shows the target supported by the common build descriptor.
    This is usually not required by standard building.