forked from qt-creator/qt-creator
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: Leena Miettinen <riitta-leena.miettinen@digia.com>
This commit is contained in:
David Kaspar
Binary file not shown.
|
Before Width: | Height: | Size: 22 KiB After Width: | Height: | Size: 14 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 14 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 7.8 KiB After Width: | Height: | Size: 18 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 15 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 14 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 33 KiB |
@@ -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
|
||||
|
||||
@@ -1,71 +1,29 @@
|
||||
\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.
|
||||
After filling in these fields, click \gui OK and the certificate
|
||||
will be created and registered in \QC.
|
||||
|
||||
\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"
|
||||
|
||||
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.
|
||||
|
||||
Reference in New Issue
Block a user