Sign a BlackBerry 10 app
You can sign your BlackBerry 10 application by using the Ripple emulator or the BlackBerry 10 WebWorks SDK. The BlackBerry 10 WebWorks SDK is a command-line tool, whereas the Ripple emulator is a Google Chrome browser extension.
Before you begin: Make sure that you have performed the setup to sign applications. This setup needs to be performed only once. For more information, see Set up for signing BlackBerry 10 apps. In early implementations of BlackBerry 10, you would have needed two distinct passwords for signing, but this is no longer necessary. If you did the set up step early that you needed two passwords, you should re-register so that you only need one password when you sign and package your app from now on.
Using the BlackBerry 10 WebWorks SDK to sign your app
You can sign your application at the same time that you package it by adding the -g <KeystorePassword> option to the package command.
- At a
command prompt, navigate to the installation folder for the BlackBerry 10 WebWorks SDK. The
file path may vary based on where you installed the BlackBerry 10 WebWorks SDK. For Windows:
cd C:\Program Files\Research In Motion\BlackBerry 10 WebWorks SDK <version>For Mac OS:
cd "/Applications/Research In Motion/BlackBerry 10 WebWorks SDK <version>"
- Package and
sign the application by using the following syntax:
bbwp <archive_file OR app_folder_location> -g <KeystorePassword> --buildId <num> -o <output_location>where:
- <archive_file OR app_folder_location> is the name and location of the application's archive file or application's folder location.
- <KeystorePassword> is the password that you specified when you registered your code signing keys with the RIM Signing Authority.
- <num> is the build version number of your application. Typically, this number should be incremented from the previous signed version.
- <output_location> is the location where you want the output files to be created.
bbwp C:\myapp\myarchive.zip -g myKeystorePassword --buildId 10 -o C:\myapp\output
Mac OS example
./bbwp ~/myapp/myarchive.zip -g myKeystorePassword --buildId 10 -o ~/myapp/output
When you execute this command, the BlackBerry 10 WebWorks SDK creates a signed .bar file in the specified output location. Note that you can also use -b in place of --buildId.
Using the Ripple emulator to sign your app
In the Ripple emulator, you can sign your application at the same time that you build it.
First, you need to fill in some settings for signing:
- Select the Build panel.
- Select Settings.
- In the Signing Password field, type the password you specified for your keystore (when you registered with the RIM Signing Authority).
- In the Bundle Number field, type the bundle number for your application (for example, 1.0.0.x, where x is the bundle number). After you sign the application, this number automatically increases by 1.
- Close the
Settings window to save your changes.
The fields in the Build section need to be filled in as well because you are building the application, then signing it. For more information about the build settings, see Package with Ripple.
Now, you can sign the app:
- Select the Build panel.
- If the build and deploy services are not currently running, click Start Services.
- 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.
After the process completes successfully, the .zip and signed .bar files for the application are stored in the output folder that you specified in the settings.
Last modified: 2013-05-02