Commit efa1d476 authored by David Kaspar's avatar David Kaspar
Browse files

Qnx: Updating BlackBerry 10 documentation



The following pages has been updated:
qnx/creator-deployment-bb10.qdoc
qnx/creator-developing-bb10.qdoc
qnx/creator-key-management-qnx.qdocinc
qnx/creator-projects-running-qnx.qdocinc

Change-Id: I925d14e849bd46e92590c12f8f82071427d42dfc
Reviewed-by: default avatarLeena Miettinen <riitta-leena.miettinen@digia.com>
parent c1225ea3
......@@ -35,12 +35,25 @@
To deploy Qt applications to BlackBerry 10 devices:
\list 1
\li Create a new project. To create an application with the native BlackBerry 10 look and feel,
select \gui File > \gui {New File or Project} > \gui {BlackBerry Qt Gui Application} > \gui Choose.
\li Select a BlackBerry 10 Kit for either device or simulator.
\li \QC will generate an additional application descriptor file to enable the packaging process.
\li Select \gui File > \gui {New File or Project} > \gui {Applications} to create a \gui {Qt Quick Application}, \gui {Qt Widgets Application}, or \gui {BlackBerry Cascades Application}.
\li Select a BlackBerry 10 \l{glossary-buildandrun-kit}{kit} for either device or simulator. For more information about adding kits, see \l{Connecting BlackBerry 10 Devices}.
\li When \QC prompts you to generate a bar descriptor file, answer \gui Yes to generate the file and enable the packaging process.
\li You can use the BAR descriptor editor to customize the appearance and behavior of the application.
\endlist
If you have an existing Cascades project created by QNX Momentics IDE, you can import it to \QC:
\list 1
\li Select \gui File > \gui {New File or Project} > \gui {Import Project} > \gui {Momentics Cascades Project} > \gui Choose.
\li Specify an existing Cascades project created by QNX Momentics IDE.
\li Specify a location for the newly created \QC project.
\endlist
A project import report is generated into import.log file located in your project.
\note \gui {BlackBerry Cascades Application} and \gui {Momentics Cascades Project} projects are available in the \gui {All Templates} filter, so you need to set this filter in the top-right corner of the \gui {New} dialog to enable those templates.
\note Currently, the BlackBerry 10 devices and Simulator have Qt 4.8 libraries preinstalled. To use Qt 5 features, you must compile the Qt libraries for BlackBerry 10 yourself. For more information, see \l {http://qt-project.org/wiki/Building-Qt5-for-Blackberry}{http://qt-p roject.org/wiki/Building-Qt5-for-Blackberry}.
For more details please refer to the Qt-Project wiki page: \l {http://qt-project.org/wiki/BlackBerry} {http://qt-project.org/wiki/BlackBerry}.
*/
......@@ -34,8 +34,8 @@
Before starting to develop for BlackBerry 10 you need to download the following tools:
\list
\li \l {http://developer.blackberry.com/native/} {The BlackBerry 10 Native SDK}
\li \l {http://developer.blackberry.com/native/} {The BlackBerry 10 Dev Alpha Simulator} if you do not have a BlackBerry DevAlpha device
\li \l {http://developer.blackberry.com/native/download/} {QNX Momentics IDE} - it is recommend to download the latest version to enable all \QC features
\li \l {http://developer.blackberry.com/native/download/} {BlackBerry 10 Simulator} if you do not have a BlackBerry 10 device
\li BlackBerry code signing keys (https://www.blackberry.com/SignedKeys/)
\endlist
......@@ -45,10 +45,33 @@
To set up your BlackBerry 10 environment in \QC:
\list 1
\li Select \gui Tools > \gui Options > \gui BlackBerry > \gui NDK to set your NDK path.
\li Select \gui Tools > \gui Options > \gui BlackBerry > \gui Keys to register and create a developer certificate.
\li Select \gui Tools > \gui Options > \gui Devices > \gui Add > \gui {Blackberry Device} to add a BlackBerry Device. You can add either the physical device or the simulator.
\li Create and upload a debug token bar file when adding the device from the wizard.
\li Set up API Levels:
\list 1
\li Select \gui Tools > \gui Options > \gui BlackBerry > \gui NDK to list all registered API Levels automatically detected by \QC.
\li The API Levels printed with a bold font are active. Use \gui Activate and \gui Deactivate to change it. When an API Level is active, \QC registers kits, Qt versions, tool chains, and debuggers to enable BlackBerry 10 development against the API Level.
\li Use \gui Add to install a new API Level or to register an existing one.
\li It is recommended to install the latest API Level too even though you are not going to use it. This will enable all \QC features including device auto-detection and the new BlackBerry Signing Keys process.
\endlist
\li Set up your Signing Keys:
\list 1
\li Select \gui Tools > \gui Options > \gui BlackBerry > \gui Keys.
\li Register a BlackBerry Signing Authority - if you do not have any, the page will guide you to an online web form to request one.
\li Select \gui {Create Certificate} to create a Developer Certificate.
\endlist
\li Register your device:
\list 1
\li On the device, select \gui Settings > \gui {Security and Privacy} > \gui {Development Mode} to switch the BlackBerry 10 device to development mode.
\li Select \gui Tools > \gui Options > \gui Devices > \gui Add > \gui {Blackberry Device} to add a BlackBerry Device. You can add either the physical device or the simulator.
\li Select \gui Upload to upload your debug token to the device.
\li Select \gui Tools > \gui Options > \gui {Build & Run} > \gui Kits to add your device to compatible BlackBerry 10 kits.
\endlist
\endlist
\include qnx/creator-key-management-qnx.qdocinc
......
\section2 Obtaining New Keys
To request keys from the BlackBerry Signing Authority, select
\gui {Tools > Options > BlackBerry > Keys} > \gui {Register}.
Then select the \gui {visiting this page} link, and follow the
\gui Tools > \gui Options > \gui BlackBerry > \gui Keys > \gui Register.
Then select the \gui {BlackBerry website} link, and follow the
instructions.
\image qtcreator-blackberry-obtain-keys.png "Requesting new keys"
\section2 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 \gui {Register Key} dialog mentioned above, located
at \gui {Tools > Options > BlackBerry > Keys > Register}.
After a few hours, you should receive an email with bbidtoken.csk file. Once you stored it at the proper location as described in the email, you can check that signing keys are registered in \QC by visiting \gui Tools > \gui Options > \gui BlackBerry > \gui Keys.
\image qtcreator-blackberry-registerkeydialog.png "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, \QC will be
able to guess the path of one of them based on the path of the other one.
\list
\li PBDT CSJ file
The path of the PBDT CSJ file that you received from BlackBerry.
\li RDK CSJ file
The path of the RDK CSJ file that you received from BlackBerry.
\li CSJ PIN
The PIN you entered on the key request form.
\li CSK PIN
This is going to be the password used by the CSK keys.
\endlist
If this is your first run and you do not have a developer certificate yet,
make sure you check the \gui {Generate developer certificate
automatically} checkbox. \gui {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 \gui
{OK} and your keys will then be registered with the BlackBerry Signing Authority,
and will be ready to use.
\image qtcreator-blackberry-registered-keys.png "Registered keys"
\section2 Creating a New Certificate
To create a new developer certificate, click the \gui {Create} button to
launch the \gui {Create Certificate} dialog.
To create a new developer certificate, click the \gui {Create Certificate} button to
open the \gui {Create Certificate} dialog.
\image qtcreator-blackberry-createcertificatedialog.png "Create Certificate Dialog"
\image qtcreator-blackberry-createcertificatedialog.png "Create Certificate dialog"
The fields you will need to fill in are:
\list
\li Path
The path to the new certificate, including the filename.
\li Author
The author, or owner of the certificate.
......@@ -77,17 +35,7 @@
\endlist
After filling in these fields, simply click \gui {OK} and the certificate
will be created.
\section2 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 \gui {Import Certificate} dialog, clicking the
\gui {Import} button.
\image qtcreator-blackberry-importcertificatedialog.png "Import Certificate Dialog"
After filling in these fields, click \gui OK and the certificate
will be created and registered in \QC.
Once the dialog pops up, all you need to do is to browse for your new
certificate and fill in the password field.
\image qtcreator-blackberry-registered-certificate.png "Registered certificate"
......@@ -10,6 +10,8 @@
\li If you are running on a BlackBerry device, create an Application
Descriptor File if it does not already exist. For more information, see \l{Deploying Applications to QNX Devices}.
\li Make sure that your kit has your QNX or BlackBerry 10 device set.
\li Click the \gui Run button.
\endlist
......@@ -19,7 +21,7 @@
If you are running on a BlackBerry device, \QC generates a BAR package,
installs it on the device, and executes the selected application. The
application views are displayed on the device. Command-line output is
application views are displayed on the device. Standard output is
visible in the \QC \gui {Application Output} view.
\note Debugging is currently only fully supported on Linux and Mac OS.
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment