Deploy to a device

You can load a BlackBerry WebWorks application on a BlackBerry smartphone by using the JavaLoader.exe file that is by default located in the following location:
  • For Windows: \Program Files\Research In Motion\BlackBerry WebWorks Packager\bin
  • For Mac OS: /Developer/SDKs/Research In Motion/BlackBerry WebWorks Packager/bin

Before you begin: Package and sign your BlackBerry WebWorks application successfully. You have two options for this process:

  • Package and sign from Ripple

    Make sure you configure the "Build" and "Sign" settings in the Ripple emulator, and that you have your config.xml file stored in the project root.

    1. Select the Build panel.
    2. If the build and deploy services are not currently running, click Start Services.
    3. Select Package & Sign.

    The Ripple emulator builds and signs your application. Make sure that you pay attention to the console messages to determine whether signing is successful. The Ripple emulator indicates when the package and build is completed successfully, but does not determine the status of application signing.

    For smartphone applications developed for the BlackBerry OS, the .zip and signed .cod files for the application are stored in the specified output folder. For BlackBerry PlayBook OS applications and BlackBerry 10 OS applications, the .zip and signed .bar files for the application are stored in the specified output folder.

  • Package and sign from the WebWorks SDK

    You can sign your application at the same time that you package it by adding the -g <password> option to the packaging command.

    Here's the command:

    bbwp <archive_file> -g <password> -o <output_location>
    where:
    • <archive_file> is the name and location of the application archive file
    • <password> is the password that you specified when you registered your code signing keys with the RIM Signing Authority.
    • <output_location> is the location where you want the output files to be created

    Windows example:

    bbwp C:\myapp\test.zip -g mypassword -o C:\myapp\output

    Mac OS example:

    ./bbwp ~/myapp/test.zip -g mypassword -o ~/myapp/output

    When you execute this command, the BlackBerry WebWorks Packager creates a signed .cod file in the specified output location.

  1. Connect a BlackBerry smartphone to the computer.
  2. At the command prompt, navigate to the location of the JavaLoader.exe file.
  3. Type the following command and pass in the parameters below:
    JavaLoader [-w<password>] load <.cod file>

    Example: C\Program Files\Research In Motion\BlackBerry WebWorks Packager\bin\JavaLoader load "C:\TestApps\HelloWorld.cod"

    Parameter Description

    password

    This is an optional parameter that specifies the password for the device, if it is set. If you do not specify this parameter, and the device has a set password, JavaLoader will prompt you for the password.

    file

    This parameter specifies one or more .cod files to load onto the device. If the application .cod file is not in the same folder as the JavaLoader.exe file, make sure that you provide the full path to the .cod file.

Last modified: 2013-10-02