Sign a BlackBerry PlayBook app
You can sign your tablet application by using the Ripple emulator or the BlackBerry WebWorks SDK. The BlackBerry WebWorks SDK is a command-line tool, whereas the Ripple emulator is a UI-based tool.
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 PlayBook apps.
Using the BlackBerry 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 bbwp folder that's in the
installation folder for the BlackBerry WebWorks
SDK. The file path may vary based on where you installed the BlackBerry WebWorks
SDK. For Windows XP:
cd C:\Program Files\Research In Motion\BlackBerry WebWorks SDK for TabletOS<x.x.x.x>\bbwpFor Windows 7:
cd C:\Program Files (x86)\Research In Motion\BlackBerry WebWorks SDK for TabletOS<x.x.x.x>\bbwpFor Mac OS:
cd "/Developer/SDKs/Research In Motion/BlackBerry WebWorks SDK for TabletOS<x.x.x.x>/bbwp"
- Package and
sign the application by using the following syntax:
bbwp <archive_file> -g <KeystorePassword> -buildId <num> -o <output_location>where:
- <archive_file> is the name and location of the application archive file
- <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 WebWorks SDK creates a signed .bar file in the specified output location.
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 CSK password field, type the password you specified for your keystore (when you registered with the RIM Signing Authority).
- In the P12 Password field, type the password you specified when you created your developer certificate. Otherwise, this is your keystore password.
- 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:
- 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.