Preparing for a BlackBerry Workshop: Installing BlackBerry WebWorks tools!

Usually when attending a “Technical” Workshop and or seminar, you have to have your tools installed in order for the event speaker at a certain seminar to save time from technical things and more time for the awesome part, which is coding (or hacking, or whatever you prefer).

This guide will show you how to use install BlackBerry WebWorks tools on your computer. I assume you’re using Windows. Luckily, if you’re using other platforms like: Mac or Linux, BlackBerry has a deeper yet easy to learn technical guide here:

(for Mac)

(for Linux)


I also assume that you’re computer is running on Windows 8 (64-Bit), because a lot of people (On my experience) are using the same type of machine but others can easily follow this guide.

1.)  Installing tools for BlackBerry 10

Simulators & Emulators

BlackBerry WebWorks has TWO testing software: The browser based extension (which is Ripple Simulator, take note: RIPPLE not NIPPLE lol) and the other one is a full featured Virtual Machine Emulator. Both emulator/simulators are useful at their own unique way.

Ripple is the best simulator when it comes to testing your apps U.I by just refreshing the browser. (Think of it like a design mode, but on a browser) While the

VM Simulator works best if you want to emulate your application on a real O.S without having to own a real PlayBook tablet and finally,

Owning a PlayBook Tablet/BB10 Alpha Device (A & B): The best way to test your apps. No questions asked. LOL

How to install Ripple Simulator

Ripple is a web based extension used for testing WebWorks apps. Like the real web browser in BB10/PlayBook it uses the same rendering engine: WebKit. So if you’re not using Google Chrome, you need to use it now.

1.) Download Google Chrome

2.) Download the Ripple Emulator

3.) Open Chrome > Open this link: chrome://chrome/extensions/ > Check the “Developer mode” checkbox > Drag & Drop Ripple to Chrome wait until a modal box appears and then drop, there will be a long time of pause that usually takes 2-3 minutes and then voila! Ripple has been installed)


How to install the BB10/PlayBook  Emulators:

General rule:

These emulators are both Virtual meaning they run simultaneously with your current Operating System. This emulator is somewhat heavy compared to Ripple but still useful if you want to test your apps “Virtually” So here are the steps you need to install this emulator:

Step 1: Download VM Player (It’s free and LEGAL lol)

Step 2: Download and Install the emulators:

Download BlackBerry 10 Dev Alpha Beta 3

Download for PlayBook (The emulator is included in the SDK, so you don’t have to 🙂 )

 Setting up the Simulator:

Step 1: Launch the VM Player

Step 2: Install the BB10 Simulator

Step 3: Open the BlackBerry10Simulator.vmx from where you installed the simulator.

(For the PlayBook, it’s located at: C:\Program Files (x86)\Research In Motion\BlackBerry WebWorks SDK for TabletOS x.x.x.x\bbwp\blackberry-tablet-sdk\BlackBerryPlayBookSimulator-x.x.x and look for BlackBerryPlayBookSimulator.vmx)

Important Note: IF you’re experiencing Java related errors when opening the .exe files you need to download the 32-Bit version of JDK. I repeat: INSTALL THE 32-BIT VERSION AND NOT THE 64-BIT VERSION.

You can download the JDK here.

After installing the JDK, you have to update your environment variables, here’s how:

1.) go to Control panel > Systems and Security >System

2.) On the left side click the “Advanced system settings”

3.) (A new window will appear) Click the “Environment Variables”

4.) (A new window will appear… Again) Look for “System Variables” and click “new”

Variable Name: JAVA_HOME

Variable Value: YOUR 32-BIT JAVA FOLDER HERE. (Example: C:\Program Files (x86)\Java\jdk1.7.0_09)

Take Note: JDK != JRE. So you have to be careful.

Find the “path” variable and insert this code at the end of the long list of strings in the path’s var value: %JAVA_HOME%\bin;

Click OK and OK.

To test if you have the latest JDK: Open cmd.exe on run. Type: java -version

If the response has the same version of JDK you have installed and configured then you’re doing it right.

 Also an Important Note: If you’re using Windows 8 PRO all the installers (event the BlackBerry 10/PlayBook SDK’s) must be in Compatibility mode to Windows 7 and has administrative privileges.


Installing the BlackBerry 10 & PlayBook SDK

Step 1: Download BB10 SDK

No sweat! But… If you want to install the PlayBook SDK you have to do these:

1.) Download Adobe Air SDK (You can get it here

2.) Download the BlackBerry PlayBook SDK

When installing the P.B’s SDK you have to point Adobe Air’s SDK. That’s important because the installation will NOT proceed if it’s not pointed at Air’s SDK.


What about IDE’s? Well you can download Eclipse Classic or just use Notepad++

That’s it! I hope you can use this as a guide to install these important tools. These instructions will help the speaker save more time and focus more on the important topics to be discussed on that day. You can also play with the tools you’ve just installed by following BlackBerry’s awesome documentation for WebWorks available right here.

Questions? Comments? Please write a comment below. 🙂