Qt

Connecting BlackBerry 10 Devices

Qt Creator provides a plugin that enables you to develop for QNX and BlackBerry 10 platforms. This page explains the basic steps to develop for BlackBerry 10 using Qt Creator.

The native BlackBerry 10 NDK includes Qt 4 (4.8.4 or newer) for both simulator (x86) and device (arm) targets available for development. Compared with the development for the PlayBook, Qt libraries are integrated in the BlackBerry 10 device firmware and can be used by Qt applications as shared libraries.

Before starting to develop for BlackBerry 10 you need to download the following tools:

Setting Up BlackBerry 10 Environment in Qt Creator

To set up your BlackBerry 10 environment in Qt Creator:

  1. Select Tools > Options > BlackBerry > NDK to set your NDK path.
  2. Select Tools > Options > BlackBerry > Keys to register and create a developer certificate.
  3. Select Tools > Options > Devices > Add > Blackberry Device to add a BlackBerry Device. You can add either the physical device or the simulator.
  4. Create and upload a debug token bar file when adding the device from the wizard.

Obtaining New Keys

To request keys from the BlackBerry Signing Authority, select Tools > Options > BlackBerry > Keys > Register. Then select the visiting this page link, and follow the instructions.

"Requesting new keys"

Registering Newly Obtained Keys

After a couple of hours, you should receive two CSJ files, the PBDT and the RDK files. Once you have received them, you can begin the key registration using the Register Key dialog mentioned above, located at Tools > Options > BlackBerry > Keys > Register.

"Register Key Dialog"

All you need to do is to browse for the PBDT CSJ file, and the RDK CSJ file. If both files are located within the same directory, Qt Creator will be able to guess the path of one of them based on the path of the other one.

  • PBDT CSJ file

    The path of the PBDT CSJ file that you received from BlackBerry.

  • RDK CSJ file

    The path of the RDK CSJ file that you received from BlackBerry.

  • CSJ PIN

    The PIN you entered on the key request form.

  • CSK PIN

    This is going to be the password used by the CSK keys.

If this is your first run and you do not have a developer certificate yet, make sure you check the Generate developer certificate automatically checkbox. Keystore password refers to the password used to open the container where the certificate will be stored. It is common practice to use the same password used for the CSK file, but not mandatory.

Once you have filled in all the relevant information, simply press OK and your keys will then be registered with the BlackBerry Signing Authority, and will be ready to use.

Creating a New Certificate

To create a new developer certificate, click the Create button to launch the Create Certificate dialog.

"Create Certificate Dialog"

The fields you will need to fill in are:

  • Path

    The path to the new certificate, including the filename.

  • Author

    The author, or owner of the certificate.

  • Password

    The password which will be used to unlock the certificate from they keystore.

After filling in these fields, simply click OK and the certificate will be created.

Importing an Existing Certificate

If you already happen to have a certificate, and would like to use it instead of for example having a new one automatically generated, all you need to do is to launch the Import Certificate dialog, clicking the Import button.

"Import Certificate Dialog"

Once the dialog pops up, all you need to do is to browse for your new certificate and fill in the password field.

For more details please refer to the Qt-Project wiki page: http://qt-project.org/wiki/BlackBerry.