• These procedures and the code at this location are provided under the EPL-1.0.

The BlackBerry® Java® Plug-in for Eclipse® lets you develop, test, and debug BlackBerry Java applications using the Eclipse IDE, in combination with the BlackBerry SDK appropriate for the device OS your app is targeting.

You can download BlackBerry SDKs through Eclipse update sites maintained by RIM for Windows and Mac OS.

• Simple BlackBerry Java development
• Effective testing and debugging
• Powerful application profiling

You can find tools and documentation, including full installers for Eclipse Plug-in for BlackBerry Java development Windows and Mac OSX, and other reference materials here:

Tools for BlackBerry Java Development

Support community for open source development

You can build the plug-ins on any Git Bash, Ant, Maven, or Eclipse supported environment, however we recommend Windows 7 + MINGW32 + Eclipse 3.7.2 32b to build the full installer.

-Windows 7 (64b or 32b)

-Java SDK 6 SE Update26 (or newer) ( export /set JAVA_HOME= | PATH=%PATH%;%JAVA_HOME%\bin )

-MINGW32 / git 1.7.10 (or newer)

-Apache Maven 3.0.1 (or newer) ( export /set M2_HOME= | PATH=%PATH%;%M2_HOME%\bin )

-Apache Ant 1.8.2 (or newer) ( export /set ANT_HOME= | PATH=%PATH%;%ANT_HOME%\bin )

-Eclipse classic 3.7.2 32b (export /set ECLIPSE_HOME=|Eclipse root path| )

To check the versions of Maven, Ant, and Java that you have installed, enter the following commands in the Command Line window:

 mvn –version
 ant –version
 java –version

• The full installer cannot be built on the Mac OS tool development environment.

-Mac OSX 10.6 / 10.7 -Java Development Kit version 1.6 installed -git 1.7.10 for Mac OSx

You can download MacPorts from http://www.macports.org/install.php. To verify that it is installed correctly, run the following command:

sudo port install maven3
 mvn --version 

1. Download and extract the distribution archive apache-maven-3.0.3-bin.tar.gz to an install directory, for example /usr/local/apache-maven. The subdirectory apache-maven-3.0.3 will be created from the archive.

2. In a command terminal, add the M2_HOME environment variable, for example, export M2_HOME=/usr/local/apache-maven/apache-maven-3.0.3.

3. Add the M2 environment variable, for example, export M2=$M2_HOME/bin.

4. Optional: Add the MAVEN_OPTS environment variable to specify JVM properties, for example, export MAVEN_OPTS="-Xms256m -Xmx512m".

5. Add M2 environment variable to your path, for example, export PATH=$M2:$PATH.

6. Make sure that JAVA_HOME is set to the location of your JDK, for example, export JAVA_HOME=/usr/java/jdk1.6.0_26 and that $JAVA_HOME/bin is in your PATH environment variable.

7. Run mvn --version to verify that it is correctly installed.

• To use the plug-in built using this procedure, you must install the required BlackBerry Java SDK separately.

From the command line, change to the root directory of the eJDE git repository and run the following command:

 mvn clean package [-Declipse.target=|Eclipse Target|] 

The Eclipse target is "helios" or "indigo" (default). The first time the build is run it may take about 5 minutes to complete and requires an internet connection. Subsequent builds take around 2 minutes.

If the build is successful the update site can be found at ejde-update-site.win/site (for Windows) and ejde-udpate-site.mac/site (for Mac OS).

1. Set the "ECLIPSE_HOME" environment variable to the path of a valid indigo Eclipse standard installation

 export | set ECLIPSE_HOME= 

Note: This step is required to allow the org.eclipse.ant.core.antRunner to run the task p2.mirror to download the chosen BlackBerry SDKs.

2. (Optional) If you want to change the defaults, configure the following properties in root pom.xml, or they can also be provided as properties invoking
   mvn ... -D|prop|=|value|

"jde.version.family" to the BlackBerry SDK version family (e.g. 7.1.0)
"jde.version" to the BlackBerry SDK version (e.g. 7.1.0.10)
"bb.sdk.local.repo.win | mac" to the correspondent folder containing the P2 mirror of the BlackBerry SDK artifacts

"jde.keystore.path" to your keystore you want to use (Java Keytool to generate) to sign the built jars (default is ../keystore_foo.jks | Note that the path is pointing from one level beneath the root, from where it's being used but the .jks resides in the root of the project.)
"jde.keystore.password" to your kestore pass

3. From the command line, change to the root directory of the eJDE git repository and run the following commands:

a) mvn clean install –Dfull_site=true (building 1st time required - this may take a bit longer as the BB SDKs for Windows and Mac OS are downloaded)
b) mvn clean package –Dfull_site=true (consecutive builds)

If the build is successful, the update site can be found at ejde-update-site.win/site (for Windows) and ejde-udpate-site.mac/site (for Mac OS).

Note: If you plan to build the full installer, you must build step 3.a first.

• You must build the full installer in a Windows development environment.

• The installer build scripts and custom Ant tasks are provided under the Apache License Version 2.0.

1. Build the full site as indicated in step 3.a in the procedure above.

2. Configure or review the "mount-point" property of the "mount-point-windows" profile in the root pom.xml to the folder that should contain 3rd party installer related artifacts: (default is /eJDE_install_artifacts ) The folder structure should look something like this:

…
 Eclipse Platform/
  mac/
    indigo/
      eclipse-SDK-3.7.2-macosx-cocoa.tar.gz   (downloaded Eclipse 3.7.2 classic for Mac OSX archive)

  win/
    indigo/
      eclipse-SDK-3.7.2-win32.zip   (downloaded Eclipse 3.7.2 classic for Win 32b archive)

 InstallAnywhere 8.0 Enterprise/

(valid IA8 installed dir; Visit Flexera Software for license and terms)

 Resources/
  [mac/]
  win/
    vcredist_x86.exe	

(MS VC++ 2008 Redistributable used by BlackBerry simulator 6.0 and up)

3. From the command line, change to the root directory of the eJDE git repository and run the following commands:

 mvn clean package -P installer 

• Alternatively to the default /eJDE_install_artifacts structure, other parameters could be specified, like -Djde.eclipse.bundles="path to Eclipse platform dir"
  If the build is successful, the installer BlackBerry_JDE_PluginFull_2.0.0_indigo.exe (for Windows) and BlackBerry_JDE_PluginFull_2.0.0_indigo.zip (for Mac) can be found at |eJDE repo root|/installer/target folder.

To further develop the provided plug-in sources in Eclipse, you need to refer an instance of the org.eclipse.osgi plugin, which can be downloaded by invoking the mvn clean -P get-osgi, or run directly cvs_checkout_org.eclipse.osgi.cmd.

Then, import all of the projects, including org.eclipse.osgi, in your Eclipse 3.7 dev environment.

To launch the eJDE2.0 as an Eclipse application, set the following VM arguments: -Dosgi.framework.extensions=net.rim.ejde.preprocessing.hook -Dosgi.requiredJavaVersion=1.5 -Xms40m -Xmx512m -XX:MaxPermSize=512m.

Once started, you must add a BlackBerry Java SDK to the runtime environment, either by using Help > Install New Software and point to the update site (local or web), or Preferences > Java > Installed JREs > Add > BlackBerry Execution Environment VM , and point to a local expanded BlackBerry Java SDK ../components/BlackBerry.ee file.