Setting up your tools

The BlackBerry WebWorks SDK provides a set of tools that you can run from the command line. With just a little bit of configuration, the Ripple emulator can take care of running these commands for you. The Ripple emulator tool can also act as a local web server for your HTML5 application, and can simulate what your app looks like on a BlackBerry device. Although it's possible to develop BlackBerry WebWorks apps without using the Ripple emulator, for the introductory apps we create in the Getting Started section, we assume that you are using the Ripple emulator.

Before you begin:
  • You need a text editor or IDE for creating HTML5, JavaScript, CSS, and config.xml files.
  • You need to install the Google Chrome browser. (The Ripple emulator runs as a Google Chrome extension.)
  1. Download the tools available on the Downloads page.
    1. Download the Ripple emulator.
    2. Download the BlackBerry WebWorks SDK for Smartphones.
    3. Download a simulator. If you have a BlackBerry device available for testing, downloading a simulator isn't essential, but you will probably find it convenient to have one.
  2. Enable the Ripple emulator.
  3. Create a folder named RippleSites in one of the following locations, so that Ripple can find your app's files.
    • Windows XP: C:\Documents and Settings\Username\RippleSites
    • Windows 7: C:\Users\Username\RippleSites
    • Mac OS: /Users/Username/RippleSites
  4. Set up for signing by requesting code signing keys. Signing keys allow you to test your app on a device and, when you're ready, to distribute it through BlackBerry World. You don't need signing keys to work through the examples in the Getting Started section. If you request them now, you will have them ready when you need them.

Last modified: 2013-10-02