Building-QtWebKit-for-Blackberry
Building Qt 5 QtWebKit for BlackBerry
Setting up the environment
See BlackBerry for instructions. Furthermore see Building Qt5 for Blackberry as a prerequisite.
Getting the source
We will clone the git repository of webkit from Gitorious. Note that this takes a very long time and includes lots of test data, leading to a whopping 5GB disk space requirement for the checkout.
Building
There are two ways of building QtWebKit:
Usage/Testing
The suggested way is to build QtWebKit just like any other Qt5 module via QMake. See Building Qt5 for Blackberry on how to call QMake.
Development
There is a second process of building QtWebKit which differs from the other Qt5 modules. This is the suggested way to use when you want to develop QtWebKit. you still have to have configured your environment to use the BBNDK as described in BlackBerry! Especially ensure that the QMake binary in your PATH is the Blackberry version.
This will compile QtWebKit for QNX in a folder called WebKitBuild/Release in your webkit checkout.
After this process, you should have a Qt5 QtWebKit located in your Qt install prefix (i.e. $HOME/development/qnx/qt5 or in C:\dev\qt5install, depending of your operating system – if you followed the other howtos).
See also
- Building Qt5 for Blackberry
- A HelloWorld using the Blackberry NDK CLI tools
- Building_and_Deploying_Qt_Applications_to_the_Playbook
- Deploying_Qt_to_a_central_place_on_Blackberry_devices
Known Issues
WebKit1/C++
QtWebKit applications using the WebKit1/C++ API are a bad fit for touch devices like the PlayBook. To simulate mouse events out of touch events, call the following on your QWebView:
If you do not do this, touch events are accpted and delegated to the JavaScript, but you will not be able to interact with the WebView, meaning: You cannot scroll, click links or do anything with it.
WebKit1/QML
Using QtWebKit with the old QtQuick1 QML API is currently broken. Eventually, this code will be moved from QtWebKit to the QtQuick1 module and reactivated.
WebKit2/QML
The new WebKit2/QML API is meant to be the holy grail of web-enabled apps running on touch devices. Sadly, this is not yet working properly, as it requires QtWebKit with OpenGL support. This is a work in progress, see https://bugs.webkit.org/show_bug.cgi?id=95466 .