Building and Deploying Qt Applications to the Playbook: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| Line 1: | Line 1: | ||
=Building and Deploying Qt Applications to the Playbook= | [[Category:BlackBerry PlayBook OS]] | ||
= Building and Deploying Qt Applications to the Playbook = | |||
It is actually very easy to build and deploy Qt applications to the Playbook. The process is very similar to building any other Qt application. The only differences arise in packaging the application and the deployment steps which we will detail here. | It is actually very easy to build and deploy Qt applications to the Playbook. The process is very similar to building any other Qt application. The only differences arise in packaging the application and the deployment steps which we will detail here. | ||
==About the Playbook Packaging System== | == About the Playbook Packaging System == | ||
To deploy an application to the Playbook we need to create a package called a bar file. A bar file is basically an archive file that contains the directory structure for your application and any additional resources that it needs. When developing an application we create a bar file using our debug token that we made earlier. This allows the bar file to be deployed only to the device that holds that debug token. The command line tools to package and deploy your application are included the | To deploy an application to the Playbook we need to create a package called a bar file. A bar file is basically an archive file that contains the directory structure for your application and any additional resources that it needs. When developing an application we create a bar file using our debug token that we made earlier. This allows the bar file to be deployed only to the device that holds that debug token. The command line tools to package and deploy your application are included the BBNDK that we have already installed. | ||
The approach we will take is to modify the .pro file for your project to add an additional Makefile target that will create the bar file for you. | The approach we will take is to modify the .pro file for your project to add an additional Makefile target that will create the bar file for you. | ||
==Preparing Your Project File== | == Preparing Your Project File == | ||
Before we begin building your application we need to edit the .pro qmake project file to include some directives to help us package up our applications ready for deployment. Here is an example .pro file for a very simple hello world Qt 5 application that uses QtQuick2: | Before we begin building your application we need to edit the .pro qmake project file to include some directives to help us package up our applications ready for deployment. Here is an example .pro file for a very simple hello world Qt 5 application that uses QtQuick2: | ||
<code><br />TEMPLATE = app<br />TARGET = helloqtquick2<br />DEPENDPATH ''= .<br />INCLUDEPATH''= . | |||
QT ''= qml quick | |||
<br />SOURCES''= main.cpp | |||
RESOURCES ''= helloqtquick2.qrc | |||
<br />OTHER_FILES''= main.qml | |||
qnx {<br /> QMAKE_LFLAGS ''= '-Wl,-rpath,#39;./app/native/lib#39;' | |||
<br /> PACKAGE_ARGS = $${PWD}/bar-descriptor.xml $$TARGET -e $${PWD}/icon.png res/icon.png -e $$[QT_INSTALL_LIBS]/libQtCore.so.5 lib/libQtCore.so.5 -e $$[QT_INSTALL_LIBS]/libQtGui.so.5 lib/libQtGui.so.5 -e $$[QT_INSTALL_LIBS]/libQtOpenGL.so.5 lib/libQtOpenGL.so.5 -e $$[QT_INSTALL_LIBS]/libQtNetwork.so.5 lib/libQtNetwork.so.5 -e $$[QT_INSTALL_LIBS]/libQtWidgets.so.5 lib/libQtWidgets.so.5 -e $$[QT_INSTALL_LIBS]/libQtQuick.so.5 lib/libQtQuick.so.5 -e $$[QT_INSTALL_LIBS]/libQtQml.so.5 lib/libQtQml.so.5 -e $$[QT_INSTALL_LIBS]/libQtSql.so.5 lib/libQtSql.so.5 -e $$[QT_INSTALL_LIBS]/libQtV8.so.5 lib/libQtV8.so.5 -e $$[QT_INSTALL_LIBS]/libQtXmlPatterns.so.5 lib/libQtXmlPatterns.so.5 -e $$[QT_INSTALL_PLUGINS]/platforms/libqnx.so plugins/platforms/libqnx.so -e $$[QT_INSTALL_IMPORTS]/ qml/ | |||
<br /> package.target = $${TARGET}.bar<br /> package.depends = $$TARGET<br /> package.commands = blackberry-nativepackager -package $${TARGET}.bar -devMode -debugToken $$(DEBUG_TOKEN) $${PACKAGE_ARGS} | |||
<br /> QMAKE_EXTRA_TARGETS''= package | |||
First of all we have the line: | OTHER_FILES ''= bar-descriptor.xml<br />}<br /></code> | ||
<br />Now that looks scary at first sight but it's actually pretty simple to see what is going on in there. At the top of the file we have the usual qmake variables that can be found in pretty much any Qt project. The interesting stuff for our purposes here is found within the qnx {} scope. Let's break it down into easy steps. | |||
<br />First of all we have the line: | |||
<br /><code><br />QMAKE_LFLAGS''= '-Wl,-rpath,#39;./app/native/lib#39;'<br /></code> | |||
This tells the linker that when the application is executed on the device it should additionally look for libraries inside the directory ./app/native/lib relative to the application. | This tells the linker that when the application is executed on the device it should additionally look for libraries inside the directory ./app/native/lib relative to the application. | ||
We then define a variable called < | We then define a variable called PACKAGE_ARGS with: | ||
<code><br />PACKAGE_ARGS = $${PWD}/bar-descriptor.xml $$TARGET -e $${PWD}/icon.png res/icon.png -e $$[QT_INSTALL_LIBS]/libQtCore.so.5 lib/libQtCore.so.5 -e $$[QT_INSTALL_LIBS]/libQtGui.so.5 lib/libQtGui.so.5 -e $$[QT_INSTALL_LIBS]/libQtOpenGL.so.5 lib/libQtOpenGL.so.5 -e $$[QT_INSTALL_LIBS]/libQtNetwork.so.5 lib/libQtNetwork.so.5 -e $$[QT_INSTALL_LIBS]/libQtWidgets.so.5 lib/libQtWidgets.so.5 -e $$[QT_INSTALL_LIBS]/libQtQuick.so.5 lib/libQtQuick.so.5 -e $$[QT_INSTALL_LIBS]/libQtQml.so.5 lib/libQtQml.so.5 -e $$[QT_INSTALL_LIBS]/libQtSql.so.5 lib/libQtSql.so.5 -e $$[QT_INSTALL_LIBS]/libQtV8.so.5 lib/libQtV8.so.5 -e $$[QT_INSTALL_LIBS]/libQtXmlPatterns.so.5 lib/libQtXmlPatterns.so.5 -e $$[QT_INSTALL_PLUGINS]/platforms/libqnx.so plugins/platforms/libqnx.so -e $$[QT_INSTALL_IMPORTS]/ qml/<br /></code> | |||
This contains the arguments that will be passed to the command line tool that will actually create our | This contains the arguments that will be passed to the command line tool that will actually create our application's package (the .bar file). This variable contains a few interesting parts: | ||
# The bar-descriptor.xml file is a simple | # The bar-descriptor.xml file is a simple XML file that describes our package and how it should be launched. Many of the other arguments listed here can optionally be specified inside the bar-descriptor.xml file instead. | ||
# Then what follows are a lot of -e <source> <dest> directives. These just tell the packaging tool to copy the <source> location to <dest> inside of the bar file and hence to <dest> within the | # Then what follows are a lot of -e <source&gt; <dest&gt; directives. These just tell the packaging tool to copy the <source&gt; location to <dest&gt; inside of the bar file and hence to <dest&gt; within the application's sandbox when deployed onto the device. | ||
<blockquote> | <blockquote>Note that the icon needs to be 86x86 pixels. | ||
</blockquote> | |||
For now we have to do this manually as Qt 5 is not part of the Playbook's firmware image yet and Qt Creator does not yet have an automatic way of determining what should go into your .bar file. This situation should improve shortly. | |||
The last section of the .pro file creates the actual Makefile target for us: | |||
</ | <code><br /> package.target = $${TARGET}.bar<br /> package.depends = $$TARGET<br /> package.commands = blackberry-nativepackager -package $${TARGET}.bar -devMode -debugToken $$(DEBUG_TOKEN) $${PACKAGE_ARGS} | ||
QMAKE_EXTRA_TARGETS += package<br /></code> | |||
where $$(DEBUG_TOKEN) is an environment variable that you need to set that points at the path to your debug token. For example on Linux you could do: | |||
<code><br />export DEBUG_TOKEN="$HOME/.rim/debugtoken.bar&quot;<br /></code> | |||
You should be able to pretty much copy and paste the above into your own .pro files to adapt it to additionally create a Playbook bar file package. | You should be able to pretty much copy and paste the above into your own .pro files to adapt it to additionally create a Playbook bar file package. | ||
| Line 42: | Line 62: | ||
To go along with the above .pro file we need a bar-descriptor.xml file. Here is a fairly typical example: | To go along with the above .pro file we need a bar-descriptor.xml file. Here is a fairly typical example: | ||
<code><br />&lt;?xml version="1.0&quot; encoding="utf-8&quot; standalone="no&quot;?&gt;<br /><qnx ><br /> <id&gt;com.kdab.helloqtquick2&lt;/id&gt;<br /> <filename&gt;helloqtquick2&lt;/filename&gt;<br /> <name&gt;Hello QtQuick2&lt;/name&gt;<br /> <versionNumber&gt;1.0.0&lt;/versionNumber&gt;<br /> <buildId&gt;1&lt;/buildId&gt;<br /> <description&gt;Hello QtQuick2&lt;/description&gt;<br /> <copyright&gt;2012&lt;/copyright&gt; | |||
<initialWindow&gt;<br /> <systemChrome&gt;none&lt;/systemChrome&gt;<br /> <transparent&gt;false&lt;/transparent&gt;<br /> <autoOrients&gt;true&lt;/autoOrients&gt;<br /> <aspectRatio&gt;landscape&lt;/aspectRatio&gt;<br /> </initialWindow&gt; | |||
<publisher&gt;KDAB&lt;/publisher&gt;<br /> <permission system="true&quot;>run_native&lt;/permission&gt;<br /> <env var="LD_LIBRARY_PATH&quot; value="app/native/lib&quot;/&gt;<br /> <env var="QT_PLUGIN_PATH&quot; value="app/native/plugins&quot;/&gt;<br /> <env var="QML_IMPORT_PATH&quot; value="app/native/imports&quot;/&gt;<br /> <env var="QML2_IMPORT_PATH&quot; value="app/native/qml&quot;/&gt;<br /> <category&gt;core.games&lt;/category&gt;<br /> <icon&gt;<image&gt;res/icon.png&lt;/image&gt;</icon&gt;<br /> </qnx&gt;<br /></code> | |||
==Building and packaging== | The fields are fairly self-explanatory but more information can be found "here&quot;:https://developer.blackberry.com/native/documentation/core/com.qnx.doc.ide.userguide/topic/capabilities_editor_options_base.html | ||
== Building and packaging == | |||
To build and package our application is now simplicity itself. All we have to do is: | To build and package our application is now simplicity itself. All we have to do is: | ||
<code><br />$ qmake<br />$ make -j&lt;N&gt;<br />$ make <app-name&gt;.bar<br /></code> | |||
where <app-name&gt; is the name of your application. In this case it would be make helloqtquick2.bar. You should now have a .bar file in your build directory ready to be deployed. | |||
== Deploying and Running == | |||
To deploy your bar file to the Playbook we use another tool included in the BBNDK called blackberry-deploy. The syntax for this tool is: | |||
==Removing an application from the device or simulator== | <code><br />$ blackberry-deploy -installApp -device <device-ip&gt; -password <device-password&gt; <appname&gt;.bar<br /></code> | ||
Once this tool has executed you should see your application icon in the launcher of the Playbook.<br />The console output of the application is saved in the /accounts/1000/appdata/*APPNAME*/logs/log file on the device. | |||
== Removing an application from the device or simulator == | |||
Open a command prompt windows, and then type: | Open a command prompt windows, and then type: | ||
<code><br />$ blackberry-deploy -uninstallApp -device <device-ip&gt; -package <appname&gt;.bar -password <device-password&gt;<br /></code> | |||
== Deploying Qt to a central place == | |||
The method described above copies Qt into the application's BAR package, which increases its size considerably and makes deploying really slow. For development, it is useful to have Qt preinstalled on the device. See "this article on how to install Qt to a central place&quot;:http://wiki.qt.io/Deploying_Qt_to_a_central_place_on_Blackberry_devices | |||
Of course you also need to undo the changes to the ''.pro'' file above, so that Qt is not added to the BAR package automatically.<br />Also, the above ''bar-descriptor.xml'' file already contains lines that set environment variables, these need to be overwritten with those lines mentioned in the article. | |||
== | == See also == | ||
* [[ | * [[Blackberry]] | ||
* [[Building-Qt5-for-the-Playbook]] | |||
Revision as of 09:39, 24 February 2015
Building and Deploying Qt Applications to the Playbook
It is actually very easy to build and deploy Qt applications to the Playbook. The process is very similar to building any other Qt application. The only differences arise in packaging the application and the deployment steps which we will detail here.
About the Playbook Packaging System
To deploy an application to the Playbook we need to create a package called a bar file. A bar file is basically an archive file that contains the directory structure for your application and any additional resources that it needs. When developing an application we create a bar file using our debug token that we made earlier. This allows the bar file to be deployed only to the device that holds that debug token. The command line tools to package and deploy your application are included the BBNDK that we have already installed.
The approach we will take is to modify the .pro file for your project to add an additional Makefile target that will create the bar file for you.
Preparing Your Project File
Before we begin building your application we need to edit the .pro qmake project file to include some directives to help us package up our applications ready for deployment. Here is an example .pro file for a very simple hello world Qt 5 application that uses QtQuick2:
<br />TEMPLATE = app<br />TARGET = helloqtquick2<br />DEPENDPATH ''= .<br />INCLUDEPATH''= .
QT ''= qml quick
<br />SOURCES''= main.cpp
RESOURCES ''= helloqtquick2.qrc
<br />OTHER_FILES''= main.qml
qnx {<br /> QMAKE_LFLAGS ''= '-Wl,-rpath,#39;./app/native/lib#39;'
<br /> PACKAGE_ARGS = $${PWD}/bar-descriptor.xml $$TARGET -e $${PWD}/icon.png res/icon.png -e $$[QT_INSTALL_LIBS]/libQtCore.so.5 lib/libQtCore.so.5 -e $$[QT_INSTALL_LIBS]/libQtGui.so.5 lib/libQtGui.so.5 -e $$[QT_INSTALL_LIBS]/libQtOpenGL.so.5 lib/libQtOpenGL.so.5 -e $$[QT_INSTALL_LIBS]/libQtNetwork.so.5 lib/libQtNetwork.so.5 -e $$[QT_INSTALL_LIBS]/libQtWidgets.so.5 lib/libQtWidgets.so.5 -e $$[QT_INSTALL_LIBS]/libQtQuick.so.5 lib/libQtQuick.so.5 -e $$[QT_INSTALL_LIBS]/libQtQml.so.5 lib/libQtQml.so.5 -e $$[QT_INSTALL_LIBS]/libQtSql.so.5 lib/libQtSql.so.5 -e $$[QT_INSTALL_LIBS]/libQtV8.so.5 lib/libQtV8.so.5 -e $$[QT_INSTALL_LIBS]/libQtXmlPatterns.so.5 lib/libQtXmlPatterns.so.5 -e $$[QT_INSTALL_PLUGINS]/platforms/libqnx.so plugins/platforms/libqnx.so -e $$[QT_INSTALL_IMPORTS]/ qml/
<br /> package.target = $${TARGET}.bar<br /> package.depends = $$TARGET<br /> package.commands = blackberry-nativepackager -package $${TARGET}.bar -devMode -debugToken $$(DEBUG_TOKEN) $${PACKAGE_ARGS}
<br /> QMAKE_EXTRA_TARGETS''= package
OTHER_FILES ''= bar-descriptor.xml<br />}<br />
Now that looks scary at first sight but it's actually pretty simple to see what is going on in there. At the top of the file we have the usual qmake variables that can be found in pretty much any Qt project. The interesting stuff for our purposes here is found within the qnx {} scope. Let's break it down into easy steps.
First of all we have the line:
<br />QMAKE_LFLAGS''= '-Wl,-rpath,#39;./app/native/lib#39;'<br />
This tells the linker that when the application is executed on the device it should additionally look for libraries inside the directory ./app/native/lib relative to the application.
We then define a variable called PACKAGE_ARGS with:
<br />PACKAGE_ARGS = $${PWD}/bar-descriptor.xml $$TARGET -e $${PWD}/icon.png res/icon.png -e $$[QT_INSTALL_LIBS]/libQtCore.so.5 lib/libQtCore.so.5 -e $$[QT_INSTALL_LIBS]/libQtGui.so.5 lib/libQtGui.so.5 -e $$[QT_INSTALL_LIBS]/libQtOpenGL.so.5 lib/libQtOpenGL.so.5 -e $$[QT_INSTALL_LIBS]/libQtNetwork.so.5 lib/libQtNetwork.so.5 -e $$[QT_INSTALL_LIBS]/libQtWidgets.so.5 lib/libQtWidgets.so.5 -e $$[QT_INSTALL_LIBS]/libQtQuick.so.5 lib/libQtQuick.so.5 -e $$[QT_INSTALL_LIBS]/libQtQml.so.5 lib/libQtQml.so.5 -e $$[QT_INSTALL_LIBS]/libQtSql.so.5 lib/libQtSql.so.5 -e $$[QT_INSTALL_LIBS]/libQtV8.so.5 lib/libQtV8.so.5 -e $$[QT_INSTALL_LIBS]/libQtXmlPatterns.so.5 lib/libQtXmlPatterns.so.5 -e $$[QT_INSTALL_PLUGINS]/platforms/libqnx.so plugins/platforms/libqnx.so -e $$[QT_INSTALL_IMPORTS]/ qml/<br />
This contains the arguments that will be passed to the command line tool that will actually create our application's package (the .bar file). This variable contains a few interesting parts:
- The bar-descriptor.xml file is a simple XML file that describes our package and how it should be launched. Many of the other arguments listed here can optionally be specified inside the bar-descriptor.xml file instead.
- Then what follows are a lot of -e <source> <dest> directives. These just tell the packaging tool to copy the <source> location to <dest> inside of the bar file and hence to <dest> within the application's sandbox when deployed onto the device.
Note that the icon needs to be 86x86 pixels.
For now we have to do this manually as Qt 5 is not part of the Playbook's firmware image yet and Qt Creator does not yet have an automatic way of determining what should go into your .bar file. This situation should improve shortly.
The last section of the .pro file creates the actual Makefile target for us:
<br /> package.target = $${TARGET}.bar<br /> package.depends = $$TARGET<br /> package.commands = blackberry-nativepackager -package $${TARGET}.bar -devMode -debugToken $$(DEBUG_TOKEN) $${PACKAGE_ARGS}
QMAKE_EXTRA_TARGETS += package<br />
where $$(DEBUG_TOKEN) is an environment variable that you need to set that points at the path to your debug token. For example on Linux you could do:
<br />export DEBUG_TOKEN="$HOME/.rim/debugtoken.bar&quot;<br />
You should be able to pretty much copy and paste the above into your own .pro files to adapt it to additionally create a Playbook bar file package.
To go along with the above .pro file we need a bar-descriptor.xml file. Here is a fairly typical example:
<br />&lt;?xml version="1.0&quot; encoding="utf-8&quot; standalone="no&quot;?&gt;<br /><qnx ><br /> <id&gt;com.kdab.helloqtquick2&lt;/id&gt;<br /> <filename&gt;helloqtquick2&lt;/filename&gt;<br /> <name&gt;Hello QtQuick2&lt;/name&gt;<br /> <versionNumber&gt;1.0.0&lt;/versionNumber&gt;<br /> <buildId&gt;1&lt;/buildId&gt;<br /> <description&gt;Hello QtQuick2&lt;/description&gt;<br /> <copyright&gt;2012&lt;/copyright&gt;
<initialWindow&gt;<br /> <systemChrome&gt;none&lt;/systemChrome&gt;<br /> <transparent&gt;false&lt;/transparent&gt;<br /> <autoOrients&gt;true&lt;/autoOrients&gt;<br /> <aspectRatio&gt;landscape&lt;/aspectRatio&gt;<br /> </initialWindow&gt;
<publisher&gt;KDAB&lt;/publisher&gt;<br /> <permission system="true&quot;>run_native&lt;/permission&gt;<br /> <env var="LD_LIBRARY_PATH&quot; value="app/native/lib&quot;/&gt;<br /> <env var="QT_PLUGIN_PATH&quot; value="app/native/plugins&quot;/&gt;<br /> <env var="QML_IMPORT_PATH&quot; value="app/native/imports&quot;/&gt;<br /> <env var="QML2_IMPORT_PATH&quot; value="app/native/qml&quot;/&gt;<br /> <category&gt;core.games&lt;/category&gt;<br /> <icon&gt;<image&gt;res/icon.png&lt;/image&gt;</icon&gt;<br /> </qnx&gt;<br />
The fields are fairly self-explanatory but more information can be found "here":https://developer.blackberry.com/native/documentation/core/com.qnx.doc.ide.userguide/topic/capabilities_editor_options_base.html
Building and packaging
To build and package our application is now simplicity itself. All we have to do is:
<br />$ qmake<br />$ make -j&lt;N&gt;<br />$ make <app-name&gt;.bar<br />
where <app-name> is the name of your application. In this case it would be make helloqtquick2.bar. You should now have a .bar file in your build directory ready to be deployed.
Deploying and Running
To deploy your bar file to the Playbook we use another tool included in the BBNDK called blackberry-deploy. The syntax for this tool is:
<br />$ blackberry-deploy -installApp -device <device-ip&gt; -password <device-password&gt; <appname&gt;.bar<br />
Once this tool has executed you should see your application icon in the launcher of the Playbook.
The console output of the application is saved in the /accounts/1000/appdata/*APPNAME*/logs/log file on the device.
Removing an application from the device or simulator
Open a command prompt windows, and then type:
<br />$ blackberry-deploy -uninstallApp -device <device-ip&gt; -package <appname&gt;.bar -password <device-password&gt;<br />
Deploying Qt to a central place
The method described above copies Qt into the application's BAR package, which increases its size considerably and makes deploying really slow. For development, it is useful to have Qt preinstalled on the device. See "this article on how to install Qt to a central place":http://wiki.qt.io/Deploying_Qt_to_a_central_place_on_Blackberry_devices
Of course you also need to undo the changes to the .pro file above, so that Qt is not added to the BAR package automatically.
Also, the above bar-descriptor.xml file already contains lines that set environment variables, these need to be overwritten with those lines mentioned in the article.