BlackBerry Setup

Before you can build your mobile application for BlackBerry, you will need to setup BlackBerry WebWorks SDK and some additional software.

Java SE Development Kit (32-bit)

Note: If you installed the Android SDK Tools along with HTML5 Builder, you probably installed the 32-bit Java SDK, and may skip this step.

Install the 32-bit version of the Java SE Development Kit, even if you are on a 64-bit system. In the folder or CD where you first run HTML5 Builder installer, you will find 32-bit Java installer under Java directory, by the name of jdk-6u26-windows-i586.exe. Start it and follow the steps below:

1. In the Java SE Development Kit wizard, click Next to start installation setup.
2. On the Custom Setup page, you can customize what parts will be installed in your system, and where.
   1. Optionally, you can skip source code installation:
      1. Right-click Source Code.
      2. Click Don’t install this feature now.
   2. Optionally too, you can change installation path for any item:
      1. Select an item, and click Change.
      2. Choose a new installation path, and click OK.
   3. Click Next.
3. On the Destination Folder page, you can customize JRE installation page.
   1. Optionally change installation path:
      1. Click Change.
      2. Browse to a new path, and click OK.
   2. Click Next, installation will start.
4. On the last page, click Finish.

Note: An Oracle web page might be loaded in your web browser, asking you to register. You do not need to register, you can safely close the page.

JAVA_HOME

You might lack a JAVA_HOME environment variable, or such a variable might be pointing to a version of Java different from the one you have just installed (different version number or architecture), so after installing the Java SDK:

1. Open Environment Variables dialog:
   • On Windows Vista, Windows 7 and Windows 8: Go to Start, right-click Computer, click on Properties, open Advanced system settings link on the left sidebar, and click Environment Variables… at the bottom of the page.
   • On Windows XP: Right-click My Computer, then click Properties, go to the Advanced tab and click Environment variables.
2. Check both user and system environment variables for the JAVA_HOME entry:
   • If it does exist, point it to the installation location you used during Java installation.
   • If it does not, create it with the Java installation path as value.

     Note: For example, on Windows 7 64-bit default path could be C:\Program Files (x86)\Java\jdk1.6.0_26.

Whether you set it as a user or system environment variable should not matter, although system-wide variables are usually preferred if you have permissions enough.

BlackBerry WebWorks SDK

First, download the installer from here (under BlackBerry OS 7 or earlier), where you must choose the Smartphone SDK version. Once downloaded:

1. Run the installer.
   • On Windows 8, right-click the installer, select Troubleshoot compatibility, then Try the recommended settings, and finally Test program.
2. On the Introduction page, click Next.
3. On the License Agreement page, check I accept the terms of the License Agreement and click Next.
4. On the Choose Install Folder page:
   1. Optionally change installation path:
      1. Click Choose….
      2. Go to the desired path, and click OK.
   2. Click Next.
5. On the Pre-Installation Summary, check everything is right and click Install.
6. Once installation is complete, click Done.
   • On Windows 8, back to the troubleshoot compatibility window, click Cancel. There is no need to click Next since the SDK is already installed.

BlackBerry Drivers and Emulator

To test your application in either an emulator or a real device, you will need BlackBerry drivers. They are included in the BlackBerry Desktop Software, which you can download from us.blackberry.com/apps-software/desktop/.

You will also need that software to run your application on the emulator, since the USB cable simulation is not available otherwise.

BlackBerry Signatures

In order to deploy your application for real devices, it must be signed, so you must have a signing key. If you do not have one already, go to bdsc.webapps.blackberry.com/html5/signingkey and follow the instructions you will find there.