http://wiki.webos-internals.org/api.php?action=feedcontributions&feedformat=atom&user=DanRogWebOS Internals - User contributions [en]2026-04-16T12:35:23ZUser contributionsMediaWiki 1.35.1http://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21719HowtoQt2012-03-10T09:41:15Z<p>DanRog: </p>
<hr />
<div>= How to cross-compile Qt for WebOS =<br />
History:<br />
<br />
* 08.02.2012: first version<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
* The reasonable development tools<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events. This step gets the WebOS Qt gfxdrivers plugin. <br />
<br />
The initial plugin version was written by Darron Black [1,2] and it uses SDL for graphics. With the changes in WebOS 2.x, that plugin doesn't work anymore: it uses root access to read the keyboard, but recent PDK apps are not running as root anymore but in jails. Therefore an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code]. It has also tentative support for screen rotation.<br />
<br />
# Cd to the Qt gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin from the svn repository: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Edit ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro to add the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# In order to support screen rotation we need to patch the "transformed" screen driver. This driver is provided by Qt to do screen rotation or offsetting and it uses as back-end the driver doing the actual access to the pixels (that would be our webos qgfxdrivers). Unfortunately the transformed driver doesn't allow to "notify" SDL when pixels are changed. A quick hack is to patch ~/qt-everywhere-opensource-src-4.8.0t/src/gui/embedded/qscreentransformed_qws.cpp. In this patch we hijack the functionality of the "blank" method (which is supposed to blank the screen) to notify the WebOS gfxdrivers before and after pixels are modified. So edit qscreentransformed_qws.cpp around lines 430 and add the two lines marked with the comments below:<br />
<br />
<pre><br />
.<br />
.<br />
.<br />
screen()->blank(true); // ADD THIS FOR WEBOS<br />
QWSDisplay::grab();<br />
for (int i = 0; i < rects.size(); ++i) {<br />
const QRect r = rects.at(i) & bound;<br />
<br />
QPoint dst;<br />
switch (trans) {<br />
case Rot90:<br />
dst = mapToDevice(r.topRight(), QSize(w, h));<br />
break;<br />
case Rot180:<br />
dst = mapToDevice(r.bottomRight(), QSize(w, h));<br />
break;<br />
case Rot270:<br />
dst = mapToDevice(r.bottomLeft(), QSize(w, h));<br />
break;<br />
default:<br />
break;<br />
}<br />
func(this, image, r.translated(-topLeft), dst);<br />
}<br />
QWSDisplay::ungrab();<br />
screen()->blank(false); // ADD THIS FOR WEBOS<br />
.<br />
.<br />
.<br />
</pre><br />
<br />
<br />
=== 3.4 Cross-compile ===<br />
<br />
<br />
Now we can configure and cross-compile Qt. The lines below configure Qt to install in ~/qte-48:<br />
<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0'''<br />
# '''./configure -v -prefix ~/qte-48 -embedded arm -platform qws/linux-x86-g++ -xplatform qws/linux-webos -depths 16,24,32 -no-multimedia -no-audio-backend -no-phonon -no-phonon-backend -no-nis -no-iconv -no-dbus -no-cups -no-largefile -no-accessibility -no-gtkstyle -no-qt3support -qt-gfx-vnc -plugin-gfx-vnc -no-glib -qtlibinfix 48 -xmlpatterns -exceptions -opensource -make libs -nomake tools -nomake demo -nomake examples -nomake docs -webkit -javascript-jit -script -scripttools -declarative -openssl -qt-gfx-transformed'''<br />
# '''make -j4'''<br />
# '''make install'''<br />
<br />
The WebOS gfxdrivers plugin must be compiled manually:<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/webos'''<br />
# '''make'''<br />
<br />
This builds and copies the plugin into ~/qte-48/plugins/gfxdrivers<br />
<br />
<br />
<br />
Hopefully you've made it so far without problems! You now have Qt in ~/qte-48.<br />
<br />
== 4. Compiling Qt apps ==<br />
<br />
We see here how to compile a Qt app for Qt on WebOS. We look at two examples that are directly taken from the Qt distribution. <br />
# fancybrowser: this is a Qt-widget-based example browser. It is available in QTSDKDIR/Examples/4.8/webkit/fancybrowser. Download the source with the modifications [http://danielroggen.net/sw/abrowse-qt.zip here]<br />
# webbrowser: this is a Qt-QML-based example browser. It is available in QTSDKDRIR/Demos/4.8/declarative/webbrowser. Since this is a QML app, a QmlApplicationViewer must be used to run the QML files. Download the source with the modifications [http://danielroggen.net/sw/abrowse-qml.zip here]<br />
<br />
The binaries are available on the WebOS homebrew app repository [www.webosnation.com/a-browser-qt-test here] and [www.webosnation.com/a-browser-qml-test here].<br />
<br />
<br />
<br />
The way compilation of the apps is mostly identical, but the QML-based project has a few extra complexities so we'll see first the widget-based project.<br />
<br />
=== 4.1 Qt-widget app ===<br />
<br />
We assume a copy of QTSDKDIR/Examples/4.8/webkit/fancybrowser in your working directory, e.g. ~/fancybrowser<br />
<br />
Two things must be modified in the project: <br />
* fancybrowser.pro: this is the project file, it must be modified to include the proper libraries<br />
* main.cpp: this is the file in which the QApplication object is instanciated. We must do some setup to indicate to the application:<br />
** where to find system fonts, <br />
** to start the application as a GUI server application<br />
** to use the WebOS gfxdrivers plugin, or to use the transformed gfxdrivers plugin in combination with the WebOS gfxdrivers plugin to support screen rotation.<br />
<br />
Note that one could avoid modifying main.cpp altogether because the same results can be achieved by environment variables and by command line arguments. Therefore a script could set the environment variables and call the executable with the appropriate parameters. However we go through the self-contained solution, which is a bit more complex but may seen as more clean.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
The pro file must be modified to link the PDL and SDL libs, and also to look for the Qt libraries at the right location at runtime. Here we assume that the Qt libs are in a subdirectory called 'qt' below the directory where the application is deployed. <br />
<br />
Modify fancybrowser.pro and add this at the end:<br />
<br />
<pre><br />
!win32: {<br />
message(assume qws)<br />
# Set the runtime path to a relative directory w.r.t. the location of the executable<br />
LIBS += -Wl,-rpath,"'\$$ORIGIN/qt'" -L/opt/PalmPDK/device/lib -lpdl -lSDL<br />
INCLUDEPATH += /opt/PalmPDK/include/SDL<br />
}<br />
</pre><br />
<br />
Note that '''!win32:{...}''' sets these parameters for any "non windows build" (I happen to build the desktop app on Windows and the WebOS app on Linux). Ideally we would rather have something for webos ('''webos:{...}''') but I did not investigate how to do enable that - if somebody knows, feel free to share.<br />
<br />
==== Modifications to the main file ====<br />
<br />
There are modifications to main.cpp in three categories.<br />
<br />
When instanciating a QApplication object the fonts are search in the directory specified by the QT_QWS_FONTDIR environment variable. To my knowledge this cannot be specified to QApplication in another way. Therefore we set programmatically QT_QWS_FONTDIR to where we have our fonts. There are two possibilities: we can deploy the fonts of Qt, or we can use the fonts already available on the WebOS device. Using the fonts of the WebOS device is fine so we use this. See the commented-out line for the alternative approach.<br />
<br />
When instanciating the QApplication object we want to start the application as a GUI server application. This is achieved by passing QApplication::GuiServer in the QApplication constructor. The alternative approach is to call the program with '''-qws''' on the command line.<br />
<br />
The gfxdrivers plugin must be specified. This can be done with the '''-display''' command line argument. Here we programmatically set this command line argument.<br />
We have two alternatives. We can use directly the WebOS gfxdrivers plugin. This does not allow for screen rotation. The command line would then be ''''-display PalmPreSDLFb:nnn'''. <br />
Alternatively, we can use the transformed gfxdrivers in combination with the WebOS gfxdrivers plugin. This allows for screen rotation. The command line would then be '''-display Transformed:PalmPreSDLFb:nnn'''.<br />
<br />
'''nnn''' is a number which you must set to identify the display driver. In a normal embedded system only a single GUI server application would run at any time, and this number can be the same for all applications (or even left out, QApplication assumes number 0 then). This number is used by Qt to create a temporary directory ('''/tmp/qtembedded-nnn''') that contains, among others, a font cache.<br />
<br />
However, on WebOS each running Qt applications is a GUI server. Each application will thus create a '''/tmp/qtembedded-nnn''' directory. Therefore '''nnn''' must be unique for each Qt application. (maybe we need a convention to avoid conflicts - might be enough to use some randomly generated number for each app).<br />
<br />
main.cpp can be modified as follows:<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Generate the makefile and compile:<br />
# ~/qte-48/bin/qmake fancybrowser.pro<br />
# make<br />
<br />
Now the app is compiled. The Qt libs must also be deployed on the device. See the deployment section below for how to lay-out the files.<br />
<br />
=== 4.2 Qt-QML app ===<br />
<br />
We assume a copy of QTSDKDIR/Demos/4.8/declarative/webbrowser in your working directory, e.g. ~/webbrowser<br />
<br />
Essentially the same modifications must be made to the Qt-QML project as for the Qt-widget project, with some additions to the main file.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
Same as for the Qt-widget app.<br />
<br />
==== Modifications to the main file ====<br />
<br />
Same as for the Qt-widget app, and in addition we must set the path where the QML imports can be found. This can be specified with the QML_IMPORT_PATH environment variable. We set-it up programmatically here.<br />
<br />
The file main.cpp looks like this:<br />
<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// ------------------------------------------------------------------------<br />
// QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP<br />
QString qmlpath = QString(pathexe)+"/imports";<br />
if(!qputenv("QML_IMPORT_PATH",qmlpath.toAscii()))<br />
{<br />
printf("Can't set qml path");<br />
}<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Same as for Qt-widget apps.<br />
<br />
=== 4.3 Deployment ===<br />
<br />
We can now test the application, and create an IPK which can be uploaded to the HP or homebrew app repository.<br />
<br />
In order to test the app, it must be copied to the device together with Qt libs. The device directory structure, assuming the app is in APPDIR, must be as follows:<br />
<br />
<pre><br />
APPDIR: the application is here<br />
APPDIR/qt: qt libs. Copy ~/qte-48/lib/*.so.4 here)<br />
APPDIR/fonts: fonts (not needed if the WebOS fonts are used). Copy ~/qte-48/lib/fonts/* here<br />
APPDIR/gfxdrivers: gfxdrivers plugins. Copy ~/qte-48/plugins/gfxdrivers/* here<br />
APPDIR/imageformats: imageformats plugins. Copy ~/qte-48/plugins/imageformats/* here<br />
APPDIR/imports: QML stuff (not needed for Qt-widget). Copy ~/qte-48/imports/* here<br />
</pre><br />
<br />
You can deploy these files in /media/internal/APPDIR for testing and run the application from the command line.<br />
<br />
To create an IPK file you need in addition an appinfo.json file. For example:<br />
<br />
<pre><br />
{<br />
"title": "A-Browser Qml (test)",<br />
"type": "pdk",<br />
"main": "abrowse-qml",<br />
"id": "net.danielroggen.abrowseqml",<br />
"version": "0.2.0",<br />
"vendor": "danielroggen",<br />
"icon": "icon.png" <br />
}<br />
</pre><br />
<br />
Now create a STAGING directory which contains:<br />
* the application<br />
* the Qt stuff (keeping the directory structure mentionned above)<br />
* the icon<br />
* the appinfo.json<br />
* any other required file<br />
<br />
And run '''palm-package STAGING'''. This will create an .ipk ready for distribution. Before distributing, try to install it on the device with Preware: copy the ipk to the device, run Preware and select the option to install ipk packages from the menu, and check that your app works.<br />
<br />
<br />
<br />
== 5. Limitations ==<br />
<br />
* No virtual keyboard so far<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]<br />
<br />
[3] A-Browser QML [http://danielroggen.net/sw/abrowse-qml.zip source] and [http://www.webosnation.com/a-browser-qml-test binary]<br />
<br />
[4] A-Browser Qt [http://danielroggen.net/sw/abrowse-qt.zip source] and [http://www.webosnation.com/a-browser-qt-test binary]<br />
<br />
[5] Updated [http://code.google.com/p/qt-webos/ WebOS gfxdrivers plugin]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21649HowtoQt2012-02-08T15:16:45Z<p>DanRog: </p>
<hr />
<div>History:<br />
<br />
* 08.02.2012: first version<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
* The reasonable development tools<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events. This step gets the WebOS Qt gfxdrivers plugin. <br />
<br />
The initial plugin version was written by Darron Black [1,2] and it uses SDL for graphics. With the changes in WebOS 2.x, that plugin doesn't work anymore: it uses root access to read the keyboard, but recent PDK apps are not running as root anymore but in jails. Therefore an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code]. It has also tentative support for screen rotation.<br />
<br />
# Cd to the Qt gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin from the svn repository: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Edit ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro to add the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# In order to support screen rotation we need to patch the "transformed" screen driver. This driver is provided by Qt to do screen rotation or offsetting and it uses as back-end the driver doing the actual access to the pixels (that would be our webos qgfxdrivers). Unfortunately the transformed driver doesn't allow to "notify" SDL when pixels are changed. A quick hack is to patch ~/qt-everywhere-opensource-src-4.8.0t/src/gui/embedded/qscreentransformed_qws.cpp. In this patch we hijack the functionality of the "blank" method (which is supposed to blank the screen) to notify the WebOS gfxdrivers before and after pixels are modified. So edit qscreentransformed_qws.cpp around lines 430 and add the two lines marked with the comments below:<br />
<br />
<pre><br />
.<br />
.<br />
.<br />
screen()->blank(true); // ADD THIS FOR WEBOS<br />
QWSDisplay::grab();<br />
for (int i = 0; i < rects.size(); ++i) {<br />
const QRect r = rects.at(i) & bound;<br />
<br />
QPoint dst;<br />
switch (trans) {<br />
case Rot90:<br />
dst = mapToDevice(r.topRight(), QSize(w, h));<br />
break;<br />
case Rot180:<br />
dst = mapToDevice(r.bottomRight(), QSize(w, h));<br />
break;<br />
case Rot270:<br />
dst = mapToDevice(r.bottomLeft(), QSize(w, h));<br />
break;<br />
default:<br />
break;<br />
}<br />
func(this, image, r.translated(-topLeft), dst);<br />
}<br />
QWSDisplay::ungrab();<br />
screen()->blank(false); // ADD THIS FOR WEBOS<br />
.<br />
.<br />
.<br />
</pre><br />
<br />
<br />
=== 3.4 Cross-compile ===<br />
<br />
<br />
Now we can configure and cross-compile Qt. The lines below configure Qt to install in ~/qte-48:<br />
<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0'''<br />
# '''./configure -v -prefix ~/qte-48 -embedded arm -platform qws/linux-x86-g++ -xplatform qws/linux-webos -depths 16,24,32 -no-multimedia -no-audio-backend -no-phonon -no-phonon-backend -no-nis -no-iconv -no-dbus -no-cups -no-largefile -no-accessibility -no-gtkstyle -no-qt3support -qt-gfx-vnc -plugin-gfx-vnc -no-glib -qtlibinfix 48 -xmlpatterns -exceptions -opensource -make libs -nomake tools -nomake demo -nomake examples -nomake docs -webkit -javascript-jit -script -scripttools -declarative -openssl -qt-gfx-transformed'''<br />
# '''make -j4'''<br />
# '''make install'''<br />
<br />
The WebOS gfxdrivers plugin must be compiled manually:<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/webos'''<br />
# '''make'''<br />
<br />
This builds and copies the plugin into ~/qte-48/plugins/gfxdrivers<br />
<br />
<br />
<br />
Hopefully you've made it so far without problems! You now have Qt in ~/qte-48.<br />
<br />
== 4. Compiling Qt apps ==<br />
<br />
We see here how to compile a Qt app for Qt on WebOS. We look at two examples that are directly taken from the Qt distribution. <br />
# fancybrowser: this is a Qt-widget-based example browser. It is available in QTSDKDIR/Examples/4.8/webkit/fancybrowser. Download the source with the modifications [http://danielroggen.net/sw/abrowse-qt.zip here]<br />
# webbrowser: this is a Qt-QML-based example browser. It is available in QTSDKDRIR/Demos/4.8/declarative/webbrowser. Since this is a QML app, a QmlApplicationViewer must be used to run the QML files. Download the source with the modifications [http://danielroggen.net/sw/abrowse-qml.zip here]<br />
<br />
The binaries are available on the WebOS homebrew app repository [www.webosnation.com/a-browser-qt-test here] and [www.webosnation.com/a-browser-qml-test here].<br />
<br />
<br />
<br />
The way compilation of the apps is mostly identical, but the QML-based project has a few extra complexities so we'll see first the widget-based project.<br />
<br />
=== 4.1 Qt-widget app ===<br />
<br />
We assume a copy of QTSDKDIR/Examples/4.8/webkit/fancybrowser in your working directory, e.g. ~/fancybrowser<br />
<br />
Two things must be modified in the project: <br />
* fancybrowser.pro: this is the project file, it must be modified to include the proper libraries<br />
* main.cpp: this is the file in which the QApplication object is instanciated. We must do some setup to indicate to the application:<br />
** where to find system fonts, <br />
** to start the application as a GUI server application<br />
** to use the WebOS gfxdrivers plugin, or to use the transformed gfxdrivers plugin in combination with the WebOS gfxdrivers plugin to support screen rotation.<br />
<br />
Note that one could avoid modifying main.cpp altogether because the same results can be achieved by environment variables and by command line arguments. Therefore a script could set the environment variables and call the executable with the appropriate parameters. However we go through the self-contained solution, which is a bit more complex but may seen as more clean.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
The pro file must be modified to link the PDL and SDL libs, and also to look for the Qt libraries at the right location at runtime. Here we assume that the Qt libs are in a subdirectory called 'qt' below the directory where the application is deployed. <br />
<br />
Modify fancybrowser.pro and add this at the end:<br />
<br />
<pre><br />
!win32: {<br />
message(assume qws)<br />
# Set the runtime path to a relative directory w.r.t. the location of the executable<br />
LIBS += -Wl,-rpath,"'\$$ORIGIN/qt'" -L/opt/PalmPDK/device/lib -lpdl -lSDL<br />
INCLUDEPATH += /opt/PalmPDK/include/SDL<br />
}<br />
</pre><br />
<br />
Note that '''!win32:{...}''' sets these parameters for any "non windows build" (I happen to build the desktop app on Windows and the WebOS app on Linux). Ideally we would rather have something for webos ('''webos:{...}''') but I did not investigate how to do enable that - if somebody knows, feel free to share.<br />
<br />
==== Modifications to the main file ====<br />
<br />
There are modifications to main.cpp in three categories.<br />
<br />
When instanciating a QApplication object the fonts are search in the directory specified by the QT_QWS_FONTDIR environment variable. To my knowledge this cannot be specified to QApplication in another way. Therefore we set programmatically QT_QWS_FONTDIR to where we have our fonts. There are two possibilities: we can deploy the fonts of Qt, or we can use the fonts already available on the WebOS device. Using the fonts of the WebOS device is fine so we use this. See the commented-out line for the alternative approach.<br />
<br />
When instanciating the QApplication object we want to start the application as a GUI server application. This is achieved by passing QApplication::GuiServer in the QApplication constructor. The alternative approach is to call the program with '''-qws''' on the command line.<br />
<br />
The gfxdrivers plugin must be specified. This can be done with the '''-display''' command line argument. Here we programmatically set this command line argument.<br />
We have two alternatives. We can use directly the WebOS gfxdrivers plugin. This does not allow for screen rotation. The command line would then be ''''-display PalmPreSDLFb:nnn'''. <br />
Alternatively, we can use the transformed gfxdrivers in combination with the WebOS gfxdrivers plugin. This allows for screen rotation. The command line would then be '''-display Transformed:PalmPreSDLFb:nnn'''.<br />
<br />
'''nnn''' is a number which you must set to identify the display driver. In a normal embedded system only a single GUI server application would run at any time, and this number can be the same for all applications (or even left out, QApplication assumes number 0 then). This number is used by Qt to create a temporary directory ('''/tmp/qtembedded-nnn''') that contains, among others, a font cache.<br />
<br />
However, on WebOS each running Qt applications is a GUI server. Each application will thus create a '''/tmp/qtembedded-nnn''' directory. Therefore '''nnn''' must be unique for each Qt application. (maybe we need a convention to avoid conflicts - might be enough to use some randomly generated number for each app).<br />
<br />
main.cpp can be modified as follows:<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Generate the makefile and compile:<br />
# ~/qte-48/bin/qmake fancybrowser.pro<br />
# make<br />
<br />
Now the app is compiled. The Qt libs must also be deployed on the device. See the deployment section below for how to lay-out the files.<br />
<br />
=== 4.2 Qt-QML app ===<br />
<br />
We assume a copy of QTSDKDIR/Demos/4.8/declarative/webbrowser in your working directory, e.g. ~/webbrowser<br />
<br />
Essentially the same modifications must be made to the Qt-QML project as for the Qt-widget project, with some additions to the main file.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
Same as for the Qt-widget app.<br />
<br />
==== Modifications to the main file ====<br />
<br />
Same as for the Qt-widget app, and in addition we must set the path where the QML imports can be found. This can be specified with the QML_IMPORT_PATH environment variable. We set-it up programmatically here.<br />
<br />
The file main.cpp looks like this:<br />
<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// ------------------------------------------------------------------------<br />
// QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP<br />
QString qmlpath = QString(pathexe)+"/imports";<br />
if(!qputenv("QML_IMPORT_PATH",qmlpath.toAscii()))<br />
{<br />
printf("Can't set qml path");<br />
}<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Same as for Qt-widget apps.<br />
<br />
=== 4.3 Deployment ===<br />
<br />
We can now test the application, and create an IPK which can be uploaded to the HP or homebrew app repository.<br />
<br />
In order to test the app, it must be copied to the device together with Qt libs. The device directory structure, assuming the app is in APPDIR, must be as follows:<br />
<br />
<pre><br />
APPDIR: the application is here<br />
APPDIR/qt: qt libs. Copy ~/qte-48/lib/*.so.4 here)<br />
APPDIR/fonts: fonts (not needed if the WebOS fonts are used). Copy ~/qte-48/lib/fonts/* here<br />
APPDIR/gfxdrivers: gfxdrivers plugins. Copy ~/qte-48/plugins/gfxdrivers/* here<br />
APPDIR/imageformats: imageformats plugins. Copy ~/qte-48/plugins/imageformats/* here<br />
APPDIR/imports: QML stuff (not needed for Qt-widget). Copy ~/qte-48/imports/* here<br />
</pre><br />
<br />
You can deploy these files in /media/internal/APPDIR for testing and run the application from the command line.<br />
<br />
To create an IPK file you need in addition an appinfo.json file. For example:<br />
<br />
<pre><br />
{<br />
"title": "A-Browser Qml (test)",<br />
"type": "pdk",<br />
"main": "abrowse-qml",<br />
"id": "net.danielroggen.abrowseqml",<br />
"version": "0.2.0",<br />
"vendor": "danielroggen",<br />
"icon": "icon.png" <br />
}<br />
</pre><br />
<br />
Now create a STAGING directory which contains:<br />
* the application<br />
* the Qt stuff (keeping the directory structure mentionned above)<br />
* the icon<br />
* the appinfo.json<br />
* any other required file<br />
<br />
And run '''palm-package STAGING'''. This will create an .ipk ready for distribution. Before distributing, try to install it on the device with Preware: copy the ipk to the device, run Preware and select the option to install ipk packages from the menu, and check that your app works.<br />
<br />
<br />
<br />
== 5. Limitations ==<br />
<br />
* No virtual keyboard so far<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]<br />
<br />
[3] A-Browser QML [http://danielroggen.net/sw/abrowse-qml.zip source] and [http://www.webosnation.com/a-browser-qml-test binary]<br />
<br />
[4] A-Browser Qt [http://danielroggen.net/sw/abrowse-qt.zip source] and [http://www.webosnation.com/a-browser-qt-test binary]<br />
<br />
[5] Updated [http://code.google.com/p/qt-webos/ WebOS gfxdrivers plugin]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21647HowtoQt2012-02-08T15:15:36Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
* The reasonable development tools<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events. This step gets the WebOS Qt gfxdrivers plugin. <br />
<br />
The initial plugin version was written by Darron Black [1,2] and it uses SDL for graphics. With the changes in WebOS 2.x, that plugin doesn't work anymore: it uses root access to read the keyboard, but recent PDK apps are not running as root anymore but in jails. Therefore an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code]. It has also tentative support for screen rotation.<br />
<br />
# Cd to the Qt gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin from the svn repository: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Edit ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro to add the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# In order to support screen rotation we need to patch the "transformed" screen driver. This driver is provided by Qt to do screen rotation or offsetting and it uses as back-end the driver doing the actual access to the pixels (that would be our webos qgfxdrivers). Unfortunately the transformed driver doesn't allow to "notify" SDL when pixels are changed. A quick hack is to patch ~/qt-everywhere-opensource-src-4.8.0t/src/gui/embedded/qscreentransformed_qws.cpp. In this patch we hijack the functionality of the "blank" method (which is supposed to blank the screen) to notify the WebOS gfxdrivers before and after pixels are modified. So edit qscreentransformed_qws.cpp around lines 430 and add the two lines marked with the comments below:<br />
<br />
<pre><br />
.<br />
.<br />
.<br />
screen()->blank(true); // ADD THIS FOR WEBOS<br />
QWSDisplay::grab();<br />
for (int i = 0; i < rects.size(); ++i) {<br />
const QRect r = rects.at(i) & bound;<br />
<br />
QPoint dst;<br />
switch (trans) {<br />
case Rot90:<br />
dst = mapToDevice(r.topRight(), QSize(w, h));<br />
break;<br />
case Rot180:<br />
dst = mapToDevice(r.bottomRight(), QSize(w, h));<br />
break;<br />
case Rot270:<br />
dst = mapToDevice(r.bottomLeft(), QSize(w, h));<br />
break;<br />
default:<br />
break;<br />
}<br />
func(this, image, r.translated(-topLeft), dst);<br />
}<br />
QWSDisplay::ungrab();<br />
screen()->blank(false); // ADD THIS FOR WEBOS<br />
.<br />
.<br />
.<br />
</pre><br />
<br />
<br />
=== 3.4 Cross-compile ===<br />
<br />
<br />
Now we can configure and cross-compile Qt. The lines below configure Qt to install in ~/qte-48:<br />
<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0'''<br />
# '''./configure -v -prefix ~/qte-48 -embedded arm -platform qws/linux-x86-g++ -xplatform qws/linux-webos -depths 16,24,32 -no-multimedia -no-audio-backend -no-phonon -no-phonon-backend -no-nis -no-iconv -no-dbus -no-cups -no-largefile -no-accessibility -no-gtkstyle -no-qt3support -qt-gfx-vnc -plugin-gfx-vnc -no-glib -qtlibinfix 48 -xmlpatterns -exceptions -opensource -make libs -nomake tools -nomake demo -nomake examples -nomake docs -webkit -javascript-jit -script -scripttools -declarative -openssl -qt-gfx-transformed'''<br />
# '''make -j4'''<br />
# '''make install'''<br />
<br />
The WebOS gfxdrivers plugin must be compiled manually:<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/webos'''<br />
# '''make'''<br />
<br />
This builds and copies the plugin into ~/qte-48/plugins/gfxdrivers<br />
<br />
<br />
<br />
Hopefully you've made it so far without problems! You now have Qt in ~/qte-48.<br />
<br />
== 4. Compiling Qt apps ==<br />
<br />
We see here how to compile a Qt app for Qt on WebOS. We look at two examples that are directly taken from the Qt distribution. <br />
# fancybrowser: this is a Qt-widget-based example browser. It is available in QTSDKDIR/Examples/4.8/webkit/fancybrowser. Download the source with the modifications [http://danielroggen.net/sw/abrowse-qt.zip here]<br />
# webbrowser: this is a Qt-QML-based example browser. It is available in QTSDKDRIR/Demos/4.8/declarative/webbrowser. Since this is a QML app, a QmlApplicationViewer must be used to run the QML files. Download the source with the modifications [http://danielroggen.net/sw/abrowse-qml.zip here]<br />
<br />
The binaries are available on the WebOS homebrew app repository [www.webosnation.com/a-browser-qt-test here] and [www.webosnation.com/a-browser-qml-test here].<br />
<br />
<br />
<br />
The way compilation of the apps is mostly identical, but the QML-based project has a few extra complexities so we'll see first the widget-based project.<br />
<br />
=== 4.1 Qt-widget app ===<br />
<br />
We assume a copy of QTSDKDIR/Examples/4.8/webkit/fancybrowser in your working directory, e.g. ~/fancybrowser<br />
<br />
Two things must be modified in the project: <br />
* fancybrowser.pro: this is the project file, it must be modified to include the proper libraries<br />
* main.cpp: this is the file in which the QApplication object is instanciated. We must do some setup to indicate to the application:<br />
** where to find system fonts, <br />
** to start the application as a GUI server application<br />
** to use the WebOS gfxdrivers plugin, or to use the transformed gfxdrivers plugin in combination with the WebOS gfxdrivers plugin to support screen rotation.<br />
<br />
Note that one could avoid modifying main.cpp altogether because the same results can be achieved by environment variables and by command line arguments. Therefore a script could set the environment variables and call the executable with the appropriate parameters. However we go through the self-contained solution, which is a bit more complex but may seen as more clean.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
The pro file must be modified to link the PDL and SDL libs, and also to look for the Qt libraries at the right location at runtime. Here we assume that the Qt libs are in a subdirectory called 'qt' below the directory where the application is deployed. <br />
<br />
Modify fancybrowser.pro and add this at the end:<br />
<br />
<pre><br />
!win32: {<br />
message(assume qws)<br />
# Set the runtime path to a relative directory w.r.t. the location of the executable<br />
LIBS += -Wl,-rpath,"'\$$ORIGIN/qt'" -L/opt/PalmPDK/device/lib -lpdl -lSDL<br />
INCLUDEPATH += /opt/PalmPDK/include/SDL<br />
}<br />
</pre><br />
<br />
Note that '''!win32:{...}''' sets these parameters for any "non windows build" (I happen to build the desktop app on Windows and the WebOS app on Linux). Ideally we would rather have something for webos ('''webos:{...}''') but I did not investigate how to do enable that - if somebody knows, feel free to share.<br />
<br />
==== Modifications to the main file ====<br />
<br />
There are modifications to main.cpp in three categories.<br />
<br />
When instanciating a QApplication object the fonts are search in the directory specified by the QT_QWS_FONTDIR environment variable. To my knowledge this cannot be specified to QApplication in another way. Therefore we set programmatically QT_QWS_FONTDIR to where we have our fonts. There are two possibilities: we can deploy the fonts of Qt, or we can use the fonts already available on the WebOS device. Using the fonts of the WebOS device is fine so we use this. See the commented-out line for the alternative approach.<br />
<br />
When instanciating the QApplication object we want to start the application as a GUI server application. This is achieved by passing QApplication::GuiServer in the QApplication constructor. The alternative approach is to call the program with '''-qws''' on the command line.<br />
<br />
The gfxdrivers plugin must be specified. This can be done with the '''-display''' command line argument. Here we programmatically set this command line argument.<br />
We have two alternatives. We can use directly the WebOS gfxdrivers plugin. This does not allow for screen rotation. The command line would then be ''''-display PalmPreSDLFb:nnn'''. <br />
Alternatively, we can use the transformed gfxdrivers in combination with the WebOS gfxdrivers plugin. This allows for screen rotation. The command line would then be '''-display Transformed:PalmPreSDLFb:nnn'''.<br />
<br />
'''nnn''' is a number which you must set to identify the display driver. In a normal embedded system only a single GUI server application would run at any time, and this number can be the same for all applications (or even left out, QApplication assumes number 0 then). This number is used by Qt to create a temporary directory ('''/tmp/qtembedded-nnn''') that contains, among others, a font cache.<br />
<br />
However, on WebOS each running Qt applications is a GUI server. Each application will thus create a '''/tmp/qtembedded-nnn''' directory. Therefore '''nnn''' must be unique for each Qt application. (maybe we need a convention to avoid conflicts - might be enough to use some randomly generated number for each app).<br />
<br />
main.cpp can be modified as follows:<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Generate the makefile and compile:<br />
# ~/qte-48/bin/qmake fancybrowser.pro<br />
# make<br />
<br />
Now the app is compiled. The Qt libs must also be deployed on the device. See the deployment section below for how to lay-out the files.<br />
<br />
=== 4.2 Qt-QML app ===<br />
<br />
We assume a copy of QTSDKDIR/Demos/4.8/declarative/webbrowser in your working directory, e.g. ~/webbrowser<br />
<br />
Essentially the same modifications must be made to the Qt-QML project as for the Qt-widget project, with some additions to the main file.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
Same as for the Qt-widget app.<br />
<br />
==== Modifications to the main file ====<br />
<br />
Same as for the Qt-widget app, and in addition we must set the path where the QML imports can be found. This can be specified with the QML_IMPORT_PATH environment variable. We set-it up programmatically here.<br />
<br />
The file main.cpp looks like this:<br />
<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// ------------------------------------------------------------------------<br />
// QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP<br />
QString qmlpath = QString(pathexe)+"/imports";<br />
if(!qputenv("QML_IMPORT_PATH",qmlpath.toAscii()))<br />
{<br />
printf("Can't set qml path");<br />
}<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Same as for Qt-widget apps.<br />
<br />
=== 4.3 Deployment ===<br />
<br />
We can now test the application, and create an IPK which can be uploaded to the HP or homebrew app repository.<br />
<br />
In order to test the app, it must be copied to the device together with Qt libs. The device directory structure, assuming the app is in APPDIR, must be as follows:<br />
<br />
<pre><br />
APPDIR: the application is here<br />
APPDIR/qt: qt libs. Copy ~/qte-48/lib/*.so.4 here)<br />
APPDIR/fonts: fonts (not needed if the WebOS fonts are used). Copy ~/qte-48/lib/fonts/* here<br />
APPDIR/gfxdrivers: gfxdrivers plugins. Copy ~/qte-48/plugins/gfxdrivers/* here<br />
APPDIR/imageformats: imageformats plugins. Copy ~/qte-48/plugins/imageformats/* here<br />
APPDIR/imports: QML stuff (not needed for Qt-widget). Copy ~/qte-48/imports/* here<br />
</pre><br />
<br />
You can deploy these files in /media/internal/APPDIR for testing and run the application from the command line.<br />
<br />
To create an IPK file you need in addition an appinfo.json file. For example:<br />
<br />
<pre><br />
{<br />
"title": "A-Browser Qml (test)",<br />
"type": "pdk",<br />
"main": "abrowse-qml",<br />
"id": "net.danielroggen.abrowseqml",<br />
"version": "0.2.0",<br />
"vendor": "danielroggen",<br />
"icon": "icon.png" <br />
}<br />
</pre><br />
<br />
Now create a STAGING directory which contains:<br />
* the application<br />
* the Qt stuff (keeping the directory structure mentionned above)<br />
* the icon<br />
* the appinfo.json<br />
* any other required file<br />
<br />
And run '''palm-package STAGING'''. This will create an .ipk ready for distribution. Before distributing, try to install it on the device with Preware: copy the ipk to the device, run Preware and select the option to install ipk packages from the menu, and check that your app works.<br />
<br />
<br />
<br />
== 5. Limitations ==<br />
<br />
* No virtual keyboard so far<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]<br />
<br />
[3] A-Browser QML [http://danielroggen.net/sw/abrowse-qml.zip source] and [http://www.webosnation.com/a-browser-qml-test binary]<br />
<br />
[4] A-Browser Qt [http://danielroggen.net/sw/abrowse-qt.zip source] and [http://www.webosnation.com/a-browser-qt-test binary]<br />
<br />
[5] Updated [http://code.google.com/p/qt-webos/ WebOS gfxdrivers plugin]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21645HowtoQt2012-02-08T15:12:42Z<p>DanRog: /* 3.4 Cross-compile */</p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
* The reasonable development tools<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events. This step gets the WebOS Qt gfxdrivers plugin. <br />
<br />
The initial plugin version was written by Darron Black [1,2] and it uses SDL for graphics. With the changes in WebOS 2.x, that plugin doesn't work anymore: it uses root access to read the keyboard, but recent PDK apps are not running as root anymore but in jails. Therefore an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code]. It has also tentative support for screen rotation.<br />
<br />
# Cd to the Qt gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin from the svn repository: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Edit ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro to add the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# In order to support screen rotation we need to patch the "transformed" screen driver. This driver is provided by Qt to do screen rotation or offsetting and it uses as back-end the driver doing the actual access to the pixels (that would be our webos qgfxdrivers). Unfortunately the transformed driver doesn't allow to "notify" SDL when pixels are changed. A quick hack is to patch ~/qt-everywhere-opensource-src-4.8.0t/src/gui/embedded/qscreentransformed_qws.cpp. In this patch we hijack the functionality of the "blank" method (which is supposed to blank the screen) to notify the WebOS gfxdrivers before and after pixels are modified. So edit qscreentransformed_qws.cpp around lines 430 and add the two lines marked with the comments below:<br />
<br />
<pre><br />
.<br />
.<br />
.<br />
screen()->blank(true); // ADD THIS FOR WEBOS<br />
QWSDisplay::grab();<br />
for (int i = 0; i < rects.size(); ++i) {<br />
const QRect r = rects.at(i) & bound;<br />
<br />
QPoint dst;<br />
switch (trans) {<br />
case Rot90:<br />
dst = mapToDevice(r.topRight(), QSize(w, h));<br />
break;<br />
case Rot180:<br />
dst = mapToDevice(r.bottomRight(), QSize(w, h));<br />
break;<br />
case Rot270:<br />
dst = mapToDevice(r.bottomLeft(), QSize(w, h));<br />
break;<br />
default:<br />
break;<br />
}<br />
func(this, image, r.translated(-topLeft), dst);<br />
}<br />
QWSDisplay::ungrab();<br />
screen()->blank(false); // ADD THIS FOR WEBOS<br />
.<br />
.<br />
.<br />
</pre><br />
<br />
<br />
=== 3.4 Cross-compile ===<br />
<br />
<br />
Now we can configure and cross-compile Qt. The lines below configure Qt to install in ~/qte-48:<br />
<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0'''<br />
# '''./configure -v -prefix ~/qte-48 -embedded arm -platform qws/linux-x86-g++ -xplatform qws/linux-webos -depths 16,24,32 -no-multimedia -no-audio-backend -no-phonon -no-phonon-backend -no-nis -no-iconv -no-dbus -no-cups -no-largefile -no-accessibility -no-gtkstyle -no-qt3support -qt-gfx-vnc -plugin-gfx-vnc -no-glib -qtlibinfix 48 -xmlpatterns -exceptions -opensource -make libs -nomake tools -nomake demo -nomake examples -nomake docs -webkit -javascript-jit -script -scripttools -declarative -openssl -qt-gfx-transformed'''<br />
# '''make -j4'''<br />
# '''make install'''<br />
<br />
The WebOS gfxdrivers plugin must be compiled manually:<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/webos'''<br />
# '''make'''<br />
<br />
This builds and copies the plugin into ~/qte-48/plugins/gfxdrivers<br />
<br />
<br />
<br />
Hopefully you've made it so far without problems! You now have Qt in ~/qte-48.<br />
<br />
== 4. Compiling Qt apps ==<br />
<br />
We see here how to compile a Qt app for Qt on WebOS. We look at two examples that are directly taken from the Qt distribution. <br />
# fancybrowser: this is a Qt-widget-based example browser. It is available in QTSDKDIR/Examples/4.8/webkit/fancybrowser. Download the source with the modifications [http://danielroggen.net/sw/abrowse-qt.zip here]<br />
# webbrowser: this is a Qt-QML-based example browser. It is available in QTSDKDRIR/Demos/4.8/declarative/webbrowser. Since this is a QML app, a QmlApplicationViewer must be used to run the QML files. Download the source with the modifications [http://danielroggen.net/sw/abrowse-qml.zip here]<br />
<br />
The binaries are available on the WebOS homebrew app repository [www.webosnation.com/a-browser-qt-test here] and [www.webosnation.com/a-browser-qml-test here].<br />
<br />
<br />
<br />
The way compilation of the apps is mostly identical, but the QML-based project has a few extra complexities so we'll see first the widget-based project.<br />
<br />
=== 4.1 Qt-widget app ===<br />
<br />
We assume a copy of QTSDKDIR/Examples/4.8/webkit/fancybrowser in your working directory, e.g. ~/fancybrowser<br />
<br />
Two things must be modified in the project: <br />
* fancybrowser.pro: this is the project file, it must be modified to include the proper libraries<br />
* main.cpp: this is the file in which the QApplication object is instanciated. We must do some setup to indicate to the application:<br />
** where to find system fonts, <br />
** to start the application as a GUI server application<br />
** to use the WebOS gfxdrivers plugin, or to use the transformed gfxdrivers plugin in combination with the WebOS gfxdrivers plugin to support screen rotation.<br />
<br />
Note that one could avoid modifying main.cpp altogether because the same results can be achieved by environment variables and by command line arguments. Therefore a script could set the environment variables and call the executable with the appropriate parameters. However we go through the self-contained solution, which is a bit more complex but may seen as more clean.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
The pro file must be modified to link the PDL and SDL libs, and also to look for the Qt libraries at the right location at runtime. Here we assume that the Qt libs are in a subdirectory called 'qt' below the directory where the application is deployed. <br />
<br />
Modify fancybrowser.pro and add this at the end:<br />
<br />
<pre><br />
!win32: {<br />
message(assume qws)<br />
# Set the runtime path to a relative directory w.r.t. the location of the executable<br />
LIBS += -Wl,-rpath,"'\$$ORIGIN/qt'" -L/opt/PalmPDK/device/lib -lpdl -lSDL<br />
INCLUDEPATH += /opt/PalmPDK/include/SDL<br />
}<br />
</pre><br />
<br />
Note that '''!win32:{...}''' sets these parameters for any "non windows build" (I happen to build the desktop app on Windows and the WebOS app on Linux). Ideally we would rather have something for webos ('''webos:{...}''') but I did not investigate how to do enable that - if somebody knows, feel free to share.<br />
<br />
==== Modifications to the main file ====<br />
<br />
There are modifications to main.cpp in three categories.<br />
<br />
When instanciating a QApplication object the fonts are search in the directory specified by the QT_QWS_FONTDIR environment variable. To my knowledge this cannot be specified to QApplication in another way. Therefore we set programmatically QT_QWS_FONTDIR to where we have our fonts. There are two possibilities: we can deploy the fonts of Qt, or we can use the fonts already available on the WebOS device. Using the fonts of the WebOS device is fine so we use this. See the commented-out line for the alternative approach.<br />
<br />
When instanciating the QApplication object we want to start the application as a GUI server application. This is achieved by passing QApplication::GuiServer in the QApplication constructor. The alternative approach is to call the program with '''-qws''' on the command line.<br />
<br />
The gfxdrivers plugin must be specified. This can be done with the '''-display''' command line argument. Here we programmatically set this command line argument.<br />
We have two alternatives. We can use directly the WebOS gfxdrivers plugin. This does not allow for screen rotation. The command line would then be ''''-display PalmPreSDLFb:nnn'''. <br />
Alternatively, we can use the transformed gfxdrivers in combination with the WebOS gfxdrivers plugin. This allows for screen rotation. The command line would then be '''-display Transformed:PalmPreSDLFb:nnn'''.<br />
<br />
'''nnn''' is a number which you must set to identify the display driver. In a normal embedded system only a single GUI server application would run at any time, and this number can be the same for all applications (or even left out, QApplication assumes number 0 then). This number is used by Qt to create a temporary directory ('''/tmp/qtembedded-nnn''') that contains, among others, a font cache.<br />
<br />
However, on WebOS each running Qt applications is a GUI server. Each application will thus create a '''/tmp/qtembedded-nnn''' directory. Therefore '''nnn''' must be unique for each Qt application. (maybe we need a convention to avoid conflicts - might be enough to use some randomly generated number for each app).<br />
<br />
main.cpp can be modified as follows:<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Generate the makefile and compile:<br />
# ~/qte-48/bin/qmake fancybrowser.pro<br />
# make<br />
<br />
Now the app is compiled. The Qt libs must also be deployed on the device. See the deployment section below for how to lay-out the files.<br />
<br />
=== 4.2 Qt-QML app ===<br />
<br />
We assume a copy of QTSDKDIR/Demos/4.8/declarative/webbrowser in your working directory, e.g. ~/webbrowser<br />
<br />
Essentially the same modifications must be made to the Qt-QML project as for the Qt-widget project, with some additions to the main file.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
Same as for the Qt-widget app.<br />
<br />
==== Modifications to the main file ====<br />
<br />
Same as for the Qt-widget app, and in addition we must set the path where the QML imports can be found. This can be specified with the QML_IMPORT_PATH environment variable. We set-it up programmatically here.<br />
<br />
The file main.cpp looks like this:<br />
<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// ------------------------------------------------------------------------<br />
// QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP<br />
QString qmlpath = QString(pathexe)+"/imports";<br />
if(!qputenv("QML_IMPORT_PATH",qmlpath.toAscii()))<br />
{<br />
printf("Can't set qml path");<br />
}<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Same as for Qt-widget apps.<br />
<br />
=== 4.3 Deployment ===<br />
<br />
We can now test the application, and create an IPK which can be uploaded to the HP or homebrew app repository.<br />
<br />
In order to test the app, it must be copied to the device together with Qt libs. The device directory structure, assuming the app is in APPDIR, must be as follows:<br />
<br />
<pre><br />
APPDIR: the application is here<br />
APPDIR/qt: qt libs. Copy ~/qte-48/lib/*.so.4 here)<br />
APPDIR/fonts: fonts (not needed if the WebOS fonts are used). Copy ~/qte-48/lib/fonts/* here<br />
APPDIR/gfxdrivers: gfxdrivers plugins. Copy ~/qte-48/plugins/gfxdrivers/* here<br />
APPDIR/imageformats: imageformats plugins. Copy ~/qte-48/plugins/imageformats/* here<br />
APPDIR/imports: QML stuff (not needed for Qt-widget). Copy ~/qte-48/imports/* here<br />
</pre><br />
<br />
You can deploy these files in /media/internal/APPDIR for testing and run the application from the command line.<br />
<br />
To create an IPK file you need in addition an appinfo.json file. For example:<br />
<br />
<pre><br />
{<br />
"title": "A-Browser Qml (test)",<br />
"type": "pdk",<br />
"main": "abrowse-qml",<br />
"id": "net.danielroggen.abrowseqml",<br />
"version": "0.2.0",<br />
"vendor": "danielroggen",<br />
"icon": "icon.png" <br />
}<br />
</pre><br />
<br />
Now create a STAGING directory which contains:<br />
* the application<br />
* the Qt stuff (keeping the directory structure mentionned above)<br />
* the icon<br />
* the appinfo.json<br />
* any other required file<br />
<br />
And run '''palm-package STAGING'''. This will create an .ipk ready for distribution. Before distributing, try to install it on the device with Preware: copy the ipk to the device, run Preware and select the option to install ipk packages from the menu, and check that your app works.<br />
<br />
<br />
=== 4.x stuff ===<br />
* numbering of the qws stuff to avoid conflicts<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21643HowtoQt2012-02-08T15:12:15Z<p>DanRog: /* 3.4 Cross-compile */</p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
* The reasonable development tools<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events. This step gets the WebOS Qt gfxdrivers plugin. <br />
<br />
The initial plugin version was written by Darron Black [1,2] and it uses SDL for graphics. With the changes in WebOS 2.x, that plugin doesn't work anymore: it uses root access to read the keyboard, but recent PDK apps are not running as root anymore but in jails. Therefore an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code]. It has also tentative support for screen rotation.<br />
<br />
# Cd to the Qt gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin from the svn repository: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Edit ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro to add the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# In order to support screen rotation we need to patch the "transformed" screen driver. This driver is provided by Qt to do screen rotation or offsetting and it uses as back-end the driver doing the actual access to the pixels (that would be our webos qgfxdrivers). Unfortunately the transformed driver doesn't allow to "notify" SDL when pixels are changed. A quick hack is to patch ~/qt-everywhere-opensource-src-4.8.0t/src/gui/embedded/qscreentransformed_qws.cpp. In this patch we hijack the functionality of the "blank" method (which is supposed to blank the screen) to notify the WebOS gfxdrivers before and after pixels are modified. So edit qscreentransformed_qws.cpp around lines 430 and add the two lines marked with the comments below:<br />
<br />
<pre><br />
.<br />
.<br />
.<br />
screen()->blank(true); // ADD THIS FOR WEBOS<br />
QWSDisplay::grab();<br />
for (int i = 0; i < rects.size(); ++i) {<br />
const QRect r = rects.at(i) & bound;<br />
<br />
QPoint dst;<br />
switch (trans) {<br />
case Rot90:<br />
dst = mapToDevice(r.topRight(), QSize(w, h));<br />
break;<br />
case Rot180:<br />
dst = mapToDevice(r.bottomRight(), QSize(w, h));<br />
break;<br />
case Rot270:<br />
dst = mapToDevice(r.bottomLeft(), QSize(w, h));<br />
break;<br />
default:<br />
break;<br />
}<br />
func(this, image, r.translated(-topLeft), dst);<br />
}<br />
QWSDisplay::ungrab();<br />
screen()->blank(false); // ADD THIS FOR WEBOS<br />
.<br />
.<br />
.<br />
</pre><br />
<br />
<br />
=== 3.4 Cross-compile ===<br />
<br />
<br />
Now we can configure and cross-compile Qt. The lines below configure Qt to install in ~/qte-48:<br />
<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0'''<br />
# '''./configure -v -prefix ~/qte-48 -embedded arm -platform qws/linux-x86-g++ -xplatform qws/linux-webos -depths 16,24,32 -no-multimedia -no-audio-backend -no-phonon -no-phonon-backend -no-nis -no-iconv -no-dbus -no-cups -no-largefile -no-accessibility -no-gtkstyle -no-qt3support -qt-gfx-vnc -plugin-gfx-vnc -no-glib -qtlibinfix 48 -xmlpatterns -exceptions -opensource -make libs -nomake tools -nomake demo -nomake examples -nomake docs -webkit -javascript-jit -script -scripttools -declarative -openssl -qt-gfx-transformed'''<br />
# '''make -j4'''<br />
# '''make install'''<br />
<br />
The WebOS gfxdrivers plugin must be compiled manually:<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/webos'''<br />
# make<br />
<br />
This builds and copies the plugin into ~/qte-48/plugins/gfxdrivers<br />
<br />
<br />
<br />
Hopefully you've made it so far without problems! You now have Qt in ~/qte-48.<br />
<br />
== 4. Compiling Qt apps ==<br />
<br />
We see here how to compile a Qt app for Qt on WebOS. We look at two examples that are directly taken from the Qt distribution. <br />
# fancybrowser: this is a Qt-widget-based example browser. It is available in QTSDKDIR/Examples/4.8/webkit/fancybrowser. Download the source with the modifications [http://danielroggen.net/sw/abrowse-qt.zip here]<br />
# webbrowser: this is a Qt-QML-based example browser. It is available in QTSDKDRIR/Demos/4.8/declarative/webbrowser. Since this is a QML app, a QmlApplicationViewer must be used to run the QML files. Download the source with the modifications [http://danielroggen.net/sw/abrowse-qml.zip here]<br />
<br />
The binaries are available on the WebOS homebrew app repository [www.webosnation.com/a-browser-qt-test here] and [www.webosnation.com/a-browser-qml-test here].<br />
<br />
<br />
<br />
The way compilation of the apps is mostly identical, but the QML-based project has a few extra complexities so we'll see first the widget-based project.<br />
<br />
=== 4.1 Qt-widget app ===<br />
<br />
We assume a copy of QTSDKDIR/Examples/4.8/webkit/fancybrowser in your working directory, e.g. ~/fancybrowser<br />
<br />
Two things must be modified in the project: <br />
* fancybrowser.pro: this is the project file, it must be modified to include the proper libraries<br />
* main.cpp: this is the file in which the QApplication object is instanciated. We must do some setup to indicate to the application:<br />
** where to find system fonts, <br />
** to start the application as a GUI server application<br />
** to use the WebOS gfxdrivers plugin, or to use the transformed gfxdrivers plugin in combination with the WebOS gfxdrivers plugin to support screen rotation.<br />
<br />
Note that one could avoid modifying main.cpp altogether because the same results can be achieved by environment variables and by command line arguments. Therefore a script could set the environment variables and call the executable with the appropriate parameters. However we go through the self-contained solution, which is a bit more complex but may seen as more clean.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
The pro file must be modified to link the PDL and SDL libs, and also to look for the Qt libraries at the right location at runtime. Here we assume that the Qt libs are in a subdirectory called 'qt' below the directory where the application is deployed. <br />
<br />
Modify fancybrowser.pro and add this at the end:<br />
<br />
<pre><br />
!win32: {<br />
message(assume qws)<br />
# Set the runtime path to a relative directory w.r.t. the location of the executable<br />
LIBS += -Wl,-rpath,"'\$$ORIGIN/qt'" -L/opt/PalmPDK/device/lib -lpdl -lSDL<br />
INCLUDEPATH += /opt/PalmPDK/include/SDL<br />
}<br />
</pre><br />
<br />
Note that '''!win32:{...}''' sets these parameters for any "non windows build" (I happen to build the desktop app on Windows and the WebOS app on Linux). Ideally we would rather have something for webos ('''webos:{...}''') but I did not investigate how to do enable that - if somebody knows, feel free to share.<br />
<br />
==== Modifications to the main file ====<br />
<br />
There are modifications to main.cpp in three categories.<br />
<br />
When instanciating a QApplication object the fonts are search in the directory specified by the QT_QWS_FONTDIR environment variable. To my knowledge this cannot be specified to QApplication in another way. Therefore we set programmatically QT_QWS_FONTDIR to where we have our fonts. There are two possibilities: we can deploy the fonts of Qt, or we can use the fonts already available on the WebOS device. Using the fonts of the WebOS device is fine so we use this. See the commented-out line for the alternative approach.<br />
<br />
When instanciating the QApplication object we want to start the application as a GUI server application. This is achieved by passing QApplication::GuiServer in the QApplication constructor. The alternative approach is to call the program with '''-qws''' on the command line.<br />
<br />
The gfxdrivers plugin must be specified. This can be done with the '''-display''' command line argument. Here we programmatically set this command line argument.<br />
We have two alternatives. We can use directly the WebOS gfxdrivers plugin. This does not allow for screen rotation. The command line would then be ''''-display PalmPreSDLFb:nnn'''. <br />
Alternatively, we can use the transformed gfxdrivers in combination with the WebOS gfxdrivers plugin. This allows for screen rotation. The command line would then be '''-display Transformed:PalmPreSDLFb:nnn'''.<br />
<br />
'''nnn''' is a number which you must set to identify the display driver. In a normal embedded system only a single GUI server application would run at any time, and this number can be the same for all applications (or even left out, QApplication assumes number 0 then). This number is used by Qt to create a temporary directory ('''/tmp/qtembedded-nnn''') that contains, among others, a font cache.<br />
<br />
However, on WebOS each running Qt applications is a GUI server. Each application will thus create a '''/tmp/qtembedded-nnn''' directory. Therefore '''nnn''' must be unique for each Qt application. (maybe we need a convention to avoid conflicts - might be enough to use some randomly generated number for each app).<br />
<br />
main.cpp can be modified as follows:<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Generate the makefile and compile:<br />
# ~/qte-48/bin/qmake fancybrowser.pro<br />
# make<br />
<br />
Now the app is compiled. The Qt libs must also be deployed on the device. See the deployment section below for how to lay-out the files.<br />
<br />
=== 4.2 Qt-QML app ===<br />
<br />
We assume a copy of QTSDKDIR/Demos/4.8/declarative/webbrowser in your working directory, e.g. ~/webbrowser<br />
<br />
Essentially the same modifications must be made to the Qt-QML project as for the Qt-widget project, with some additions to the main file.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
Same as for the Qt-widget app.<br />
<br />
==== Modifications to the main file ====<br />
<br />
Same as for the Qt-widget app, and in addition we must set the path where the QML imports can be found. This can be specified with the QML_IMPORT_PATH environment variable. We set-it up programmatically here.<br />
<br />
The file main.cpp looks like this:<br />
<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// ------------------------------------------------------------------------<br />
// QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP<br />
QString qmlpath = QString(pathexe)+"/imports";<br />
if(!qputenv("QML_IMPORT_PATH",qmlpath.toAscii()))<br />
{<br />
printf("Can't set qml path");<br />
}<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Same as for Qt-widget apps.<br />
<br />
=== 4.3 Deployment ===<br />
<br />
We can now test the application, and create an IPK which can be uploaded to the HP or homebrew app repository.<br />
<br />
In order to test the app, it must be copied to the device together with Qt libs. The device directory structure, assuming the app is in APPDIR, must be as follows:<br />
<br />
<pre><br />
APPDIR: the application is here<br />
APPDIR/qt: qt libs. Copy ~/qte-48/lib/*.so.4 here)<br />
APPDIR/fonts: fonts (not needed if the WebOS fonts are used). Copy ~/qte-48/lib/fonts/* here<br />
APPDIR/gfxdrivers: gfxdrivers plugins. Copy ~/qte-48/plugins/gfxdrivers/* here<br />
APPDIR/imageformats: imageformats plugins. Copy ~/qte-48/plugins/imageformats/* here<br />
APPDIR/imports: QML stuff (not needed for Qt-widget). Copy ~/qte-48/imports/* here<br />
</pre><br />
<br />
You can deploy these files in /media/internal/APPDIR for testing and run the application from the command line.<br />
<br />
To create an IPK file you need in addition an appinfo.json file. For example:<br />
<br />
<pre><br />
{<br />
"title": "A-Browser Qml (test)",<br />
"type": "pdk",<br />
"main": "abrowse-qml",<br />
"id": "net.danielroggen.abrowseqml",<br />
"version": "0.2.0",<br />
"vendor": "danielroggen",<br />
"icon": "icon.png" <br />
}<br />
</pre><br />
<br />
Now create a STAGING directory which contains:<br />
* the application<br />
* the Qt stuff (keeping the directory structure mentionned above)<br />
* the icon<br />
* the appinfo.json<br />
* any other required file<br />
<br />
And run '''palm-package STAGING'''. This will create an .ipk ready for distribution. Before distributing, try to install it on the device with Preware: copy the ipk to the device, run Preware and select the option to install ipk packages from the menu, and check that your app works.<br />
<br />
<br />
=== 4.x stuff ===<br />
* numbering of the qws stuff to avoid conflicts<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21641HowtoQt2012-02-08T15:11:42Z<p>DanRog: /* Compilation */</p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
* The reasonable development tools<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events. This step gets the WebOS Qt gfxdrivers plugin. <br />
<br />
The initial plugin version was written by Darron Black [1,2] and it uses SDL for graphics. With the changes in WebOS 2.x, that plugin doesn't work anymore: it uses root access to read the keyboard, but recent PDK apps are not running as root anymore but in jails. Therefore an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code]. It has also tentative support for screen rotation.<br />
<br />
# Cd to the Qt gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin from the svn repository: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Edit ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro to add the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# In order to support screen rotation we need to patch the "transformed" screen driver. This driver is provided by Qt to do screen rotation or offsetting and it uses as back-end the driver doing the actual access to the pixels (that would be our webos qgfxdrivers). Unfortunately the transformed driver doesn't allow to "notify" SDL when pixels are changed. A quick hack is to patch ~/qt-everywhere-opensource-src-4.8.0t/src/gui/embedded/qscreentransformed_qws.cpp. In this patch we hijack the functionality of the "blank" method (which is supposed to blank the screen) to notify the WebOS gfxdrivers before and after pixels are modified. So edit qscreentransformed_qws.cpp around lines 430 and add the two lines marked with the comments below:<br />
<br />
<pre><br />
.<br />
.<br />
.<br />
screen()->blank(true); // ADD THIS FOR WEBOS<br />
QWSDisplay::grab();<br />
for (int i = 0; i < rects.size(); ++i) {<br />
const QRect r = rects.at(i) & bound;<br />
<br />
QPoint dst;<br />
switch (trans) {<br />
case Rot90:<br />
dst = mapToDevice(r.topRight(), QSize(w, h));<br />
break;<br />
case Rot180:<br />
dst = mapToDevice(r.bottomRight(), QSize(w, h));<br />
break;<br />
case Rot270:<br />
dst = mapToDevice(r.bottomLeft(), QSize(w, h));<br />
break;<br />
default:<br />
break;<br />
}<br />
func(this, image, r.translated(-topLeft), dst);<br />
}<br />
QWSDisplay::ungrab();<br />
screen()->blank(false); // ADD THIS FOR WEBOS<br />
.<br />
.<br />
.<br />
</pre><br />
<br />
<br />
=== 3.4 Cross-compile ===<br />
<br />
<br />
Now we can configure and cross-compile Qt. The lines below configure Qt to install in ~/qte-48:<br />
<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0'''<br />
# '''./configure -v -prefix ~/qte-48 -embedded arm -platform qws/linux-x86-g++ -xplatform qws/linux-webos -depths 16,24,32 -no-multimedia -no-audio-backend -no-phonon -no-phonon-backend -no-nis -no-iconv -no-dbus -no-cups -no-largefile -no-accessibility -no-gtkstyle -no-qt3support -qt-gfx-vnc -plugin-gfx-vnc -no-glib -qtlibinfix 48 -xmlpatterns -exceptions -opensource -make libs -nomake tools -nomake demo -nomake examples -nomake docs -webkit -javascript-jit -script -scripttools -declarative -openssl -qt-gfx-transformed'''<br />
# '''make -j4'''<br />
# '''make install'''<br />
<br />
The WebOS gfxdrivers plugin must be compiled manually:<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/webos'''<br />
# make<br />
<br />
This builds and copies the plugint to ~/qte-48/<br />
-------------------<br />
<br />
Hopefully you've made it so far without problems! You now have Qt in ~/qte-48.<br />
<br />
== 4. Compiling Qt apps ==<br />
<br />
We see here how to compile a Qt app for Qt on WebOS. We look at two examples that are directly taken from the Qt distribution. <br />
# fancybrowser: this is a Qt-widget-based example browser. It is available in QTSDKDIR/Examples/4.8/webkit/fancybrowser. Download the source with the modifications [http://danielroggen.net/sw/abrowse-qt.zip here]<br />
# webbrowser: this is a Qt-QML-based example browser. It is available in QTSDKDRIR/Demos/4.8/declarative/webbrowser. Since this is a QML app, a QmlApplicationViewer must be used to run the QML files. Download the source with the modifications [http://danielroggen.net/sw/abrowse-qml.zip here]<br />
<br />
The binaries are available on the WebOS homebrew app repository [www.webosnation.com/a-browser-qt-test here] and [www.webosnation.com/a-browser-qml-test here].<br />
<br />
<br />
<br />
The way compilation of the apps is mostly identical, but the QML-based project has a few extra complexities so we'll see first the widget-based project.<br />
<br />
=== 4.1 Qt-widget app ===<br />
<br />
We assume a copy of QTSDKDIR/Examples/4.8/webkit/fancybrowser in your working directory, e.g. ~/fancybrowser<br />
<br />
Two things must be modified in the project: <br />
* fancybrowser.pro: this is the project file, it must be modified to include the proper libraries<br />
* main.cpp: this is the file in which the QApplication object is instanciated. We must do some setup to indicate to the application:<br />
** where to find system fonts, <br />
** to start the application as a GUI server application<br />
** to use the WebOS gfxdrivers plugin, or to use the transformed gfxdrivers plugin in combination with the WebOS gfxdrivers plugin to support screen rotation.<br />
<br />
Note that one could avoid modifying main.cpp altogether because the same results can be achieved by environment variables and by command line arguments. Therefore a script could set the environment variables and call the executable with the appropriate parameters. However we go through the self-contained solution, which is a bit more complex but may seen as more clean.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
The pro file must be modified to link the PDL and SDL libs, and also to look for the Qt libraries at the right location at runtime. Here we assume that the Qt libs are in a subdirectory called 'qt' below the directory where the application is deployed. <br />
<br />
Modify fancybrowser.pro and add this at the end:<br />
<br />
<pre><br />
!win32: {<br />
message(assume qws)<br />
# Set the runtime path to a relative directory w.r.t. the location of the executable<br />
LIBS += -Wl,-rpath,"'\$$ORIGIN/qt'" -L/opt/PalmPDK/device/lib -lpdl -lSDL<br />
INCLUDEPATH += /opt/PalmPDK/include/SDL<br />
}<br />
</pre><br />
<br />
Note that '''!win32:{...}''' sets these parameters for any "non windows build" (I happen to build the desktop app on Windows and the WebOS app on Linux). Ideally we would rather have something for webos ('''webos:{...}''') but I did not investigate how to do enable that - if somebody knows, feel free to share.<br />
<br />
==== Modifications to the main file ====<br />
<br />
There are modifications to main.cpp in three categories.<br />
<br />
When instanciating a QApplication object the fonts are search in the directory specified by the QT_QWS_FONTDIR environment variable. To my knowledge this cannot be specified to QApplication in another way. Therefore we set programmatically QT_QWS_FONTDIR to where we have our fonts. There are two possibilities: we can deploy the fonts of Qt, or we can use the fonts already available on the WebOS device. Using the fonts of the WebOS device is fine so we use this. See the commented-out line for the alternative approach.<br />
<br />
When instanciating the QApplication object we want to start the application as a GUI server application. This is achieved by passing QApplication::GuiServer in the QApplication constructor. The alternative approach is to call the program with '''-qws''' on the command line.<br />
<br />
The gfxdrivers plugin must be specified. This can be done with the '''-display''' command line argument. Here we programmatically set this command line argument.<br />
We have two alternatives. We can use directly the WebOS gfxdrivers plugin. This does not allow for screen rotation. The command line would then be ''''-display PalmPreSDLFb:nnn'''. <br />
Alternatively, we can use the transformed gfxdrivers in combination with the WebOS gfxdrivers plugin. This allows for screen rotation. The command line would then be '''-display Transformed:PalmPreSDLFb:nnn'''.<br />
<br />
'''nnn''' is a number which you must set to identify the display driver. In a normal embedded system only a single GUI server application would run at any time, and this number can be the same for all applications (or even left out, QApplication assumes number 0 then). This number is used by Qt to create a temporary directory ('''/tmp/qtembedded-nnn''') that contains, among others, a font cache.<br />
<br />
However, on WebOS each running Qt applications is a GUI server. Each application will thus create a '''/tmp/qtembedded-nnn''' directory. Therefore '''nnn''' must be unique for each Qt application. (maybe we need a convention to avoid conflicts - might be enough to use some randomly generated number for each app).<br />
<br />
main.cpp can be modified as follows:<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Generate the makefile and compile:<br />
# ~/qte-48/bin/qmake fancybrowser.pro<br />
# make<br />
<br />
Now the app is compiled. The Qt libs must also be deployed on the device. See the deployment section below for how to lay-out the files.<br />
<br />
=== 4.2 Qt-QML app ===<br />
<br />
We assume a copy of QTSDKDIR/Demos/4.8/declarative/webbrowser in your working directory, e.g. ~/webbrowser<br />
<br />
Essentially the same modifications must be made to the Qt-QML project as for the Qt-widget project, with some additions to the main file.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
Same as for the Qt-widget app.<br />
<br />
==== Modifications to the main file ====<br />
<br />
Same as for the Qt-widget app, and in addition we must set the path where the QML imports can be found. This can be specified with the QML_IMPORT_PATH environment variable. We set-it up programmatically here.<br />
<br />
The file main.cpp looks like this:<br />
<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// ------------------------------------------------------------------------<br />
// QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP<br />
QString qmlpath = QString(pathexe)+"/imports";<br />
if(!qputenv("QML_IMPORT_PATH",qmlpath.toAscii()))<br />
{<br />
printf("Can't set qml path");<br />
}<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Same as for Qt-widget apps.<br />
<br />
=== 4.3 Deployment ===<br />
<br />
We can now test the application, and create an IPK which can be uploaded to the HP or homebrew app repository.<br />
<br />
In order to test the app, it must be copied to the device together with Qt libs. The device directory structure, assuming the app is in APPDIR, must be as follows:<br />
<br />
<pre><br />
APPDIR: the application is here<br />
APPDIR/qt: qt libs. Copy ~/qte-48/lib/*.so.4 here)<br />
APPDIR/fonts: fonts (not needed if the WebOS fonts are used). Copy ~/qte-48/lib/fonts/* here<br />
APPDIR/gfxdrivers: gfxdrivers plugins. Copy ~/qte-48/plugins/gfxdrivers/* here<br />
APPDIR/imageformats: imageformats plugins. Copy ~/qte-48/plugins/imageformats/* here<br />
APPDIR/imports: QML stuff (not needed for Qt-widget). Copy ~/qte-48/imports/* here<br />
</pre><br />
<br />
You can deploy these files in /media/internal/APPDIR for testing and run the application from the command line.<br />
<br />
To create an IPK file you need in addition an appinfo.json file. For example:<br />
<br />
<pre><br />
{<br />
"title": "A-Browser Qml (test)",<br />
"type": "pdk",<br />
"main": "abrowse-qml",<br />
"id": "net.danielroggen.abrowseqml",<br />
"version": "0.2.0",<br />
"vendor": "danielroggen",<br />
"icon": "icon.png" <br />
}<br />
</pre><br />
<br />
Now create a STAGING directory which contains:<br />
* the application<br />
* the Qt stuff (keeping the directory structure mentionned above)<br />
* the icon<br />
* the appinfo.json<br />
* any other required file<br />
<br />
And run '''palm-package STAGING'''. This will create an .ipk ready for distribution. Before distributing, try to install it on the device with Preware: copy the ipk to the device, run Preware and select the option to install ipk packages from the menu, and check that your app works.<br />
<br />
<br />
=== 4.x stuff ===<br />
* numbering of the qws stuff to avoid conflicts<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21639HowtoQt2012-02-08T15:11:09Z<p>DanRog: /* 3.4 Cross-compile */</p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
* The reasonable development tools<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events. This step gets the WebOS Qt gfxdrivers plugin. <br />
<br />
The initial plugin version was written by Darron Black [1,2] and it uses SDL for graphics. With the changes in WebOS 2.x, that plugin doesn't work anymore: it uses root access to read the keyboard, but recent PDK apps are not running as root anymore but in jails. Therefore an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code]. It has also tentative support for screen rotation.<br />
<br />
# Cd to the Qt gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin from the svn repository: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Edit ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro to add the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# In order to support screen rotation we need to patch the "transformed" screen driver. This driver is provided by Qt to do screen rotation or offsetting and it uses as back-end the driver doing the actual access to the pixels (that would be our webos qgfxdrivers). Unfortunately the transformed driver doesn't allow to "notify" SDL when pixels are changed. A quick hack is to patch ~/qt-everywhere-opensource-src-4.8.0t/src/gui/embedded/qscreentransformed_qws.cpp. In this patch we hijack the functionality of the "blank" method (which is supposed to blank the screen) to notify the WebOS gfxdrivers before and after pixels are modified. So edit qscreentransformed_qws.cpp around lines 430 and add the two lines marked with the comments below:<br />
<br />
<pre><br />
.<br />
.<br />
.<br />
screen()->blank(true); // ADD THIS FOR WEBOS<br />
QWSDisplay::grab();<br />
for (int i = 0; i < rects.size(); ++i) {<br />
const QRect r = rects.at(i) & bound;<br />
<br />
QPoint dst;<br />
switch (trans) {<br />
case Rot90:<br />
dst = mapToDevice(r.topRight(), QSize(w, h));<br />
break;<br />
case Rot180:<br />
dst = mapToDevice(r.bottomRight(), QSize(w, h));<br />
break;<br />
case Rot270:<br />
dst = mapToDevice(r.bottomLeft(), QSize(w, h));<br />
break;<br />
default:<br />
break;<br />
}<br />
func(this, image, r.translated(-topLeft), dst);<br />
}<br />
QWSDisplay::ungrab();<br />
screen()->blank(false); // ADD THIS FOR WEBOS<br />
.<br />
.<br />
.<br />
</pre><br />
<br />
<br />
=== 3.4 Cross-compile ===<br />
<br />
<br />
Now we can configure and cross-compile Qt. The lines below configure Qt to install in ~/qte-48:<br />
<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0'''<br />
# '''./configure -v -prefix ~/qte-48 -embedded arm -platform qws/linux-x86-g++ -xplatform qws/linux-webos -depths 16,24,32 -no-multimedia -no-audio-backend -no-phonon -no-phonon-backend -no-nis -no-iconv -no-dbus -no-cups -no-largefile -no-accessibility -no-gtkstyle -no-qt3support -qt-gfx-vnc -plugin-gfx-vnc -no-glib -qtlibinfix 48 -xmlpatterns -exceptions -opensource -make libs -nomake tools -nomake demo -nomake examples -nomake docs -webkit -javascript-jit -script -scripttools -declarative -openssl -qt-gfx-transformed'''<br />
# '''make -j4'''<br />
# '''make install'''<br />
<br />
The WebOS gfxdrivers plugin must be compiled manually:<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/webos'''<br />
# make<br />
<br />
This builds and copies the plugint to ~/qte-48/<br />
-------------------<br />
<br />
Hopefully you've made it so far without problems! You now have Qt in ~/qte-48.<br />
<br />
== 4. Compiling Qt apps ==<br />
<br />
We see here how to compile a Qt app for Qt on WebOS. We look at two examples that are directly taken from the Qt distribution. <br />
# fancybrowser: this is a Qt-widget-based example browser. It is available in QTSDKDIR/Examples/4.8/webkit/fancybrowser. Download the source with the modifications [http://danielroggen.net/sw/abrowse-qt.zip here]<br />
# webbrowser: this is a Qt-QML-based example browser. It is available in QTSDKDRIR/Demos/4.8/declarative/webbrowser. Since this is a QML app, a QmlApplicationViewer must be used to run the QML files. Download the source with the modifications [http://danielroggen.net/sw/abrowse-qml.zip here]<br />
<br />
The binaries are available on the WebOS homebrew app repository [www.webosnation.com/a-browser-qt-test here] and [www.webosnation.com/a-browser-qml-test here].<br />
<br />
<br />
<br />
The way compilation of the apps is mostly identical, but the QML-based project has a few extra complexities so we'll see first the widget-based project.<br />
<br />
=== 4.1 Qt-widget app ===<br />
<br />
We assume a copy of QTSDKDIR/Examples/4.8/webkit/fancybrowser in your working directory, e.g. ~/fancybrowser<br />
<br />
Two things must be modified in the project: <br />
* fancybrowser.pro: this is the project file, it must be modified to include the proper libraries<br />
* main.cpp: this is the file in which the QApplication object is instanciated. We must do some setup to indicate to the application:<br />
** where to find system fonts, <br />
** to start the application as a GUI server application<br />
** to use the WebOS gfxdrivers plugin, or to use the transformed gfxdrivers plugin in combination with the WebOS gfxdrivers plugin to support screen rotation.<br />
<br />
Note that one could avoid modifying main.cpp altogether because the same results can be achieved by environment variables and by command line arguments. Therefore a script could set the environment variables and call the executable with the appropriate parameters. However we go through the self-contained solution, which is a bit more complex but may seen as more clean.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
The pro file must be modified to link the PDL and SDL libs, and also to look for the Qt libraries at the right location at runtime. Here we assume that the Qt libs are in a subdirectory called 'qt' below the directory where the application is deployed. <br />
<br />
Modify fancybrowser.pro and add this at the end:<br />
<br />
<pre><br />
!win32: {<br />
message(assume qws)<br />
# Set the runtime path to a relative directory w.r.t. the location of the executable<br />
LIBS += -Wl,-rpath,"'\$$ORIGIN/qt'" -L/opt/PalmPDK/device/lib -lpdl -lSDL<br />
INCLUDEPATH += /opt/PalmPDK/include/SDL<br />
}<br />
</pre><br />
<br />
Note that '''!win32:{...}''' sets these parameters for any "non windows build" (I happen to build the desktop app on Windows and the WebOS app on Linux). Ideally we would rather have something for webos ('''webos:{...}''') but I did not investigate how to do enable that - if somebody knows, feel free to share.<br />
<br />
==== Modifications to the main file ====<br />
<br />
There are modifications to main.cpp in three categories.<br />
<br />
When instanciating a QApplication object the fonts are search in the directory specified by the QT_QWS_FONTDIR environment variable. To my knowledge this cannot be specified to QApplication in another way. Therefore we set programmatically QT_QWS_FONTDIR to where we have our fonts. There are two possibilities: we can deploy the fonts of Qt, or we can use the fonts already available on the WebOS device. Using the fonts of the WebOS device is fine so we use this. See the commented-out line for the alternative approach.<br />
<br />
When instanciating the QApplication object we want to start the application as a GUI server application. This is achieved by passing QApplication::GuiServer in the QApplication constructor. The alternative approach is to call the program with '''-qws''' on the command line.<br />
<br />
The gfxdrivers plugin must be specified. This can be done with the '''-display''' command line argument. Here we programmatically set this command line argument.<br />
We have two alternatives. We can use directly the WebOS gfxdrivers plugin. This does not allow for screen rotation. The command line would then be ''''-display PalmPreSDLFb:nnn'''. <br />
Alternatively, we can use the transformed gfxdrivers in combination with the WebOS gfxdrivers plugin. This allows for screen rotation. The command line would then be '''-display Transformed:PalmPreSDLFb:nnn'''.<br />
<br />
'''nnn''' is a number which you must set to identify the display driver. In a normal embedded system only a single GUI server application would run at any time, and this number can be the same for all applications (or even left out, QApplication assumes number 0 then). This number is used by Qt to create a temporary directory ('''/tmp/qtembedded-nnn''') that contains, among others, a font cache.<br />
<br />
However, on WebOS each running Qt applications is a GUI server. Each application will thus create a '''/tmp/qtembedded-nnn''' directory. Therefore '''nnn''' must be unique for each Qt application. (maybe we need a convention to avoid conflicts - might be enough to use some randomly generated number for each app).<br />
<br />
main.cpp can be modified as follows:<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Generate the makefile and compile:<br />
# ~/qte-48/bin/qmake fancybrowser.pro<br />
# make<br />
<br />
Now the app is compiled. The Qt libs must also be deployed on the device. See the deployment section below for how to lay-out the files.<br />
<br />
<br />
<br />
<br />
<br />
=== 4.2 Qt-QML app ===<br />
<br />
We assume a copy of QTSDKDIR/Demos/4.8/declarative/webbrowser in your working directory, e.g. ~/webbrowser<br />
<br />
Essentially the same modifications must be made to the Qt-QML project as for the Qt-widget project, with some additions to the main file.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
Same as for the Qt-widget app.<br />
<br />
==== Modifications to the main file ====<br />
<br />
Same as for the Qt-widget app, and in addition we must set the path where the QML imports can be found. This can be specified with the QML_IMPORT_PATH environment variable. We set-it up programmatically here.<br />
<br />
The file main.cpp looks like this:<br />
<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// ------------------------------------------------------------------------<br />
// QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP<br />
QString qmlpath = QString(pathexe)+"/imports";<br />
if(!qputenv("QML_IMPORT_PATH",qmlpath.toAscii()))<br />
{<br />
printf("Can't set qml path");<br />
}<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Same as for Qt-widget apps.<br />
<br />
=== 4.3 Deployment ===<br />
<br />
We can now test the application, and create an IPK which can be uploaded to the HP or homebrew app repository.<br />
<br />
In order to test the app, it must be copied to the device together with Qt libs. The device directory structure, assuming the app is in APPDIR, must be as follows:<br />
<br />
<pre><br />
APPDIR: the application is here<br />
APPDIR/qt: qt libs. Copy ~/qte-48/lib/*.so.4 here)<br />
APPDIR/fonts: fonts (not needed if the WebOS fonts are used). Copy ~/qte-48/lib/fonts/* here<br />
APPDIR/gfxdrivers: gfxdrivers plugins. Copy ~/qte-48/plugins/gfxdrivers/* here<br />
APPDIR/imageformats: imageformats plugins. Copy ~/qte-48/plugins/imageformats/* here<br />
APPDIR/imports: QML stuff (not needed for Qt-widget). Copy ~/qte-48/imports/* here<br />
</pre><br />
<br />
You can deploy these files in /media/internal/APPDIR for testing and run the application from the command line.<br />
<br />
To create an IPK file you need in addition an appinfo.json file. For example:<br />
<br />
<pre><br />
{<br />
"title": "A-Browser Qml (test)",<br />
"type": "pdk",<br />
"main": "abrowse-qml",<br />
"id": "net.danielroggen.abrowseqml",<br />
"version": "0.2.0",<br />
"vendor": "danielroggen",<br />
"icon": "icon.png" <br />
}<br />
</pre><br />
<br />
Now create a STAGING directory which contains:<br />
* the application<br />
* the Qt stuff (keeping the directory structure mentionned above)<br />
* the icon<br />
* the appinfo.json<br />
* any other required file<br />
<br />
And run '''palm-package STAGING'''. This will create an .ipk ready for distribution. Before distributing, try to install it on the device with Preware: copy the ipk to the device, run Preware and select the option to install ipk packages from the menu, and check that your app works.<br />
<br />
<br />
=== 4.x stuff ===<br />
* numbering of the qws stuff to avoid conflicts<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21637HowtoQt2012-02-08T15:09:58Z<p>DanRog: /* 4. Compiling Qt apps */</p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
* The reasonable development tools<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events. This step gets the WebOS Qt gfxdrivers plugin. <br />
<br />
The initial plugin version was written by Darron Black [1,2] and it uses SDL for graphics. With the changes in WebOS 2.x, that plugin doesn't work anymore: it uses root access to read the keyboard, but recent PDK apps are not running as root anymore but in jails. Therefore an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code]. It has also tentative support for screen rotation.<br />
<br />
# Cd to the Qt gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin from the svn repository: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Edit ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro to add the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# In order to support screen rotation we need to patch the "transformed" screen driver. This driver is provided by Qt to do screen rotation or offsetting and it uses as back-end the driver doing the actual access to the pixels (that would be our webos qgfxdrivers). Unfortunately the transformed driver doesn't allow to "notify" SDL when pixels are changed. A quick hack is to patch ~/qt-everywhere-opensource-src-4.8.0t/src/gui/embedded/qscreentransformed_qws.cpp. In this patch we hijack the functionality of the "blank" method (which is supposed to blank the screen) to notify the WebOS gfxdrivers before and after pixels are modified. So edit qscreentransformed_qws.cpp around lines 430 and add the two lines marked with the comments below:<br />
<br />
<pre><br />
.<br />
.<br />
.<br />
screen()->blank(true); // ADD THIS FOR WEBOS<br />
QWSDisplay::grab();<br />
for (int i = 0; i < rects.size(); ++i) {<br />
const QRect r = rects.at(i) & bound;<br />
<br />
QPoint dst;<br />
switch (trans) {<br />
case Rot90:<br />
dst = mapToDevice(r.topRight(), QSize(w, h));<br />
break;<br />
case Rot180:<br />
dst = mapToDevice(r.bottomRight(), QSize(w, h));<br />
break;<br />
case Rot270:<br />
dst = mapToDevice(r.bottomLeft(), QSize(w, h));<br />
break;<br />
default:<br />
break;<br />
}<br />
func(this, image, r.translated(-topLeft), dst);<br />
}<br />
QWSDisplay::ungrab();<br />
screen()->blank(false); // ADD THIS FOR WEBOS<br />
.<br />
.<br />
.<br />
</pre><br />
<br />
<br />
=== 3.4 Cross-compile ===<br />
<br />
<br />
Now we can configure and cross-compile Qt. The lines below configure Qt to install in ~/qte-48:<br />
<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0'''<br />
# '''./configure -v -prefix ~/qte-48 -embedded arm -platform qws/linux-x86-g++ -xplatform qws/linux-webos -depths 16,24,32 -no-multimedia -no-audio-backend -no-phonon -no-phonon-backend -no-nis -no-iconv -no-dbus -no-cups -no-largefile -no-accessibility -no-gtkstyle -no-qt3support -qt-gfx-vnc -plugin-gfx-vnc -no-glib -qtlibinfix 48 -xmlpatterns -exceptions -opensource -make libs -nomake tools -nomake demo -nomake examples -nomake docs -webkit -javascript-jit -script -scripttools -declarative -openssl -qt-gfx-transformed'''<br />
# '''make -j4'''<br />
# '''make install'''<br />
<br />
NEED TO COMPILE WEBOS manually<br />
# cd<br />
# make<br />
# make install<br />
-------------------<br />
<br />
Hopefully you've made it so far without problems! You now have Qt in ~/qte-48.<br />
<br />
<br />
== 4. Compiling Qt apps ==<br />
<br />
We see here how to compile a Qt app for Qt on WebOS. We look at two examples that are directly taken from the Qt distribution. <br />
# fancybrowser: this is a Qt-widget-based example browser. It is available in QTSDKDIR/Examples/4.8/webkit/fancybrowser. Download the source with the modifications [http://danielroggen.net/sw/abrowse-qt.zip here]<br />
# webbrowser: this is a Qt-QML-based example browser. It is available in QTSDKDRIR/Demos/4.8/declarative/webbrowser. Since this is a QML app, a QmlApplicationViewer must be used to run the QML files. Download the source with the modifications [http://danielroggen.net/sw/abrowse-qml.zip here]<br />
<br />
The binaries are available on the WebOS homebrew app repository [www.webosnation.com/a-browser-qt-test here] and [www.webosnation.com/a-browser-qml-test here].<br />
<br />
<br />
<br />
The way compilation of the apps is mostly identical, but the QML-based project has a few extra complexities so we'll see first the widget-based project.<br />
<br />
=== 4.1 Qt-widget app ===<br />
<br />
We assume a copy of QTSDKDIR/Examples/4.8/webkit/fancybrowser in your working directory, e.g. ~/fancybrowser<br />
<br />
Two things must be modified in the project: <br />
* fancybrowser.pro: this is the project file, it must be modified to include the proper libraries<br />
* main.cpp: this is the file in which the QApplication object is instanciated. We must do some setup to indicate to the application:<br />
** where to find system fonts, <br />
** to start the application as a GUI server application<br />
** to use the WebOS gfxdrivers plugin, or to use the transformed gfxdrivers plugin in combination with the WebOS gfxdrivers plugin to support screen rotation.<br />
<br />
Note that one could avoid modifying main.cpp altogether because the same results can be achieved by environment variables and by command line arguments. Therefore a script could set the environment variables and call the executable with the appropriate parameters. However we go through the self-contained solution, which is a bit more complex but may seen as more clean.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
The pro file must be modified to link the PDL and SDL libs, and also to look for the Qt libraries at the right location at runtime. Here we assume that the Qt libs are in a subdirectory called 'qt' below the directory where the application is deployed. <br />
<br />
Modify fancybrowser.pro and add this at the end:<br />
<br />
<pre><br />
!win32: {<br />
message(assume qws)<br />
# Set the runtime path to a relative directory w.r.t. the location of the executable<br />
LIBS += -Wl,-rpath,"'\$$ORIGIN/qt'" -L/opt/PalmPDK/device/lib -lpdl -lSDL<br />
INCLUDEPATH += /opt/PalmPDK/include/SDL<br />
}<br />
</pre><br />
<br />
Note that '''!win32:{...}''' sets these parameters for any "non windows build" (I happen to build the desktop app on Windows and the WebOS app on Linux). Ideally we would rather have something for webos ('''webos:{...}''') but I did not investigate how to do enable that - if somebody knows, feel free to share.<br />
<br />
==== Modifications to the main file ====<br />
<br />
There are modifications to main.cpp in three categories.<br />
<br />
When instanciating a QApplication object the fonts are search in the directory specified by the QT_QWS_FONTDIR environment variable. To my knowledge this cannot be specified to QApplication in another way. Therefore we set programmatically QT_QWS_FONTDIR to where we have our fonts. There are two possibilities: we can deploy the fonts of Qt, or we can use the fonts already available on the WebOS device. Using the fonts of the WebOS device is fine so we use this. See the commented-out line for the alternative approach.<br />
<br />
When instanciating the QApplication object we want to start the application as a GUI server application. This is achieved by passing QApplication::GuiServer in the QApplication constructor. The alternative approach is to call the program with '''-qws''' on the command line.<br />
<br />
The gfxdrivers plugin must be specified. This can be done with the '''-display''' command line argument. Here we programmatically set this command line argument.<br />
We have two alternatives. We can use directly the WebOS gfxdrivers plugin. This does not allow for screen rotation. The command line would then be ''''-display PalmPreSDLFb:nnn'''. <br />
Alternatively, we can use the transformed gfxdrivers in combination with the WebOS gfxdrivers plugin. This allows for screen rotation. The command line would then be '''-display Transformed:PalmPreSDLFb:nnn'''.<br />
<br />
'''nnn''' is a number which you must set to identify the display driver. In a normal embedded system only a single GUI server application would run at any time, and this number can be the same for all applications (or even left out, QApplication assumes number 0 then). This number is used by Qt to create a temporary directory ('''/tmp/qtembedded-nnn''') that contains, among others, a font cache.<br />
<br />
However, on WebOS each running Qt applications is a GUI server. Each application will thus create a '''/tmp/qtembedded-nnn''' directory. Therefore '''nnn''' must be unique for each Qt application. (maybe we need a convention to avoid conflicts - might be enough to use some randomly generated number for each app).<br />
<br />
main.cpp can be modified as follows:<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Generate the makefile and compile:<br />
# ~/qte-48/bin/qmake fancybrowser.pro<br />
# make<br />
<br />
Now the app is compiled. The Qt libs must also be deployed on the device. See the deployment section below for how to lay-out the files.<br />
<br />
<br />
<br />
<br />
<br />
=== 4.2 Qt-QML app ===<br />
<br />
We assume a copy of QTSDKDIR/Demos/4.8/declarative/webbrowser in your working directory, e.g. ~/webbrowser<br />
<br />
Essentially the same modifications must be made to the Qt-QML project as for the Qt-widget project, with some additions to the main file.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
Same as for the Qt-widget app.<br />
<br />
==== Modifications to the main file ====<br />
<br />
Same as for the Qt-widget app, and in addition we must set the path where the QML imports can be found. This can be specified with the QML_IMPORT_PATH environment variable. We set-it up programmatically here.<br />
<br />
The file main.cpp looks like this:<br />
<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// ------------------------------------------------------------------------<br />
// QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP<br />
QString qmlpath = QString(pathexe)+"/imports";<br />
if(!qputenv("QML_IMPORT_PATH",qmlpath.toAscii()))<br />
{<br />
printf("Can't set qml path");<br />
}<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Same as for Qt-widget apps.<br />
<br />
=== 4.3 Deployment ===<br />
<br />
We can now test the application, and create an IPK which can be uploaded to the HP or homebrew app repository.<br />
<br />
In order to test the app, it must be copied to the device together with Qt libs. The device directory structure, assuming the app is in APPDIR, must be as follows:<br />
<br />
<pre><br />
APPDIR: the application is here<br />
APPDIR/qt: qt libs. Copy ~/qte-48/lib/*.so.4 here)<br />
APPDIR/fonts: fonts (not needed if the WebOS fonts are used). Copy ~/qte-48/lib/fonts/* here<br />
APPDIR/gfxdrivers: gfxdrivers plugins. Copy ~/qte-48/plugins/gfxdrivers/* here<br />
APPDIR/imageformats: imageformats plugins. Copy ~/qte-48/plugins/imageformats/* here<br />
APPDIR/imports: QML stuff (not needed for Qt-widget). Copy ~/qte-48/imports/* here<br />
</pre><br />
<br />
You can deploy these files in /media/internal/APPDIR for testing and run the application from the command line.<br />
<br />
To create an IPK file you need in addition an appinfo.json file. For example:<br />
<br />
<pre><br />
{<br />
"title": "A-Browser Qml (test)",<br />
"type": "pdk",<br />
"main": "abrowse-qml",<br />
"id": "net.danielroggen.abrowseqml",<br />
"version": "0.2.0",<br />
"vendor": "danielroggen",<br />
"icon": "icon.png" <br />
}<br />
</pre><br />
<br />
Now create a STAGING directory which contains:<br />
* the application<br />
* the Qt stuff (keeping the directory structure mentionned above)<br />
* the icon<br />
* the appinfo.json<br />
* any other required file<br />
<br />
And run '''palm-package STAGING'''. This will create an .ipk ready for distribution. Before distributing, try to install it on the device with Preware: copy the ipk to the device, run Preware and select the option to install ipk packages from the menu, and check that your app works.<br />
<br />
<br />
=== 4.x stuff ===<br />
* numbering of the qws stuff to avoid conflicts<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21635HowtoQt2012-02-08T15:03:26Z<p>DanRog: /* 4. Compiling Qt apps */</p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
* The reasonable development tools<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events. This step gets the WebOS Qt gfxdrivers plugin. <br />
<br />
The initial plugin version was written by Darron Black [1,2] and it uses SDL for graphics. With the changes in WebOS 2.x, that plugin doesn't work anymore: it uses root access to read the keyboard, but recent PDK apps are not running as root anymore but in jails. Therefore an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code]. It has also tentative support for screen rotation.<br />
<br />
# Cd to the Qt gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin from the svn repository: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Edit ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro to add the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# In order to support screen rotation we need to patch the "transformed" screen driver. This driver is provided by Qt to do screen rotation or offsetting and it uses as back-end the driver doing the actual access to the pixels (that would be our webos qgfxdrivers). Unfortunately the transformed driver doesn't allow to "notify" SDL when pixels are changed. A quick hack is to patch ~/qt-everywhere-opensource-src-4.8.0t/src/gui/embedded/qscreentransformed_qws.cpp. In this patch we hijack the functionality of the "blank" method (which is supposed to blank the screen) to notify the WebOS gfxdrivers before and after pixels are modified. So edit qscreentransformed_qws.cpp around lines 430 and add the two lines marked with the comments below:<br />
<br />
<pre><br />
.<br />
.<br />
.<br />
screen()->blank(true); // ADD THIS FOR WEBOS<br />
QWSDisplay::grab();<br />
for (int i = 0; i < rects.size(); ++i) {<br />
const QRect r = rects.at(i) & bound;<br />
<br />
QPoint dst;<br />
switch (trans) {<br />
case Rot90:<br />
dst = mapToDevice(r.topRight(), QSize(w, h));<br />
break;<br />
case Rot180:<br />
dst = mapToDevice(r.bottomRight(), QSize(w, h));<br />
break;<br />
case Rot270:<br />
dst = mapToDevice(r.bottomLeft(), QSize(w, h));<br />
break;<br />
default:<br />
break;<br />
}<br />
func(this, image, r.translated(-topLeft), dst);<br />
}<br />
QWSDisplay::ungrab();<br />
screen()->blank(false); // ADD THIS FOR WEBOS<br />
.<br />
.<br />
.<br />
</pre><br />
<br />
<br />
=== 3.4 Cross-compile ===<br />
<br />
<br />
Now we can configure and cross-compile Qt. The lines below configure Qt to install in ~/qte-48:<br />
<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0'''<br />
# '''./configure -v -prefix ~/qte-48 -embedded arm -platform qws/linux-x86-g++ -xplatform qws/linux-webos -depths 16,24,32 -no-multimedia -no-audio-backend -no-phonon -no-phonon-backend -no-nis -no-iconv -no-dbus -no-cups -no-largefile -no-accessibility -no-gtkstyle -no-qt3support -qt-gfx-vnc -plugin-gfx-vnc -no-glib -qtlibinfix 48 -xmlpatterns -exceptions -opensource -make libs -nomake tools -nomake demo -nomake examples -nomake docs -webkit -javascript-jit -script -scripttools -declarative -openssl -qt-gfx-transformed'''<br />
# '''make -j4'''<br />
# '''make install'''<br />
<br />
NEED TO COMPILE WEBOS manually<br />
# cd<br />
# make<br />
# make install<br />
-------------------<br />
<br />
Hopefully you've made it so far without problems! You now have Qt in ~/qte-48.<br />
<br />
<br />
== 4. Compiling Qt apps ==<br />
<br />
We see here how to compile a Qt app for Qt on WebOS. We look at two examples that are directly taken from the Qt distribution: <br />
# fancybrowser: this is a Qt-widget-based example browser. It is available in QTSDKDIR/Examples/4.8/webkit/fancybrowser. Download the source with the modifications [http://danielroggen.net/sw/abrowse-qt.zip abrowse-qt here]<br />
# webbrowser: this is a Qt-QML-based example browser. It is available in QTSDKDRIR/Demos/4.8/declarative/webbrowser. Since this is a QML app, a QmlApplicationViewer must be used to run the QML. Download the source with the modifications [http://danielroggen.net/sw/abrowse-qml.zip here]<br />
<br />
<br />
<br />
<br />
The way compilation of the apps is mostly identical, but the QML-based project has a few extra complexities so we'll see first the widget-based project.<br />
<br />
=== 4.1 Qt-widget app ===<br />
<br />
We assume a copy of QTSDKDIR/Examples/4.8/webkit/fancybrowser in your working directory, e.g. ~/fancybrowser<br />
<br />
Two things must be modified in the project: <br />
* fancybrowser.pro: this is the project file, it must be modified to include the proper libraries<br />
* main.cpp: this is the file in which the QApplication object is instanciated. We must do some setup to indicate to the application:<br />
** where to find system fonts, <br />
** to start the application as a GUI server application<br />
** to use the WebOS gfxdrivers plugin, or to use the transformed gfxdrivers plugin in combination with the WebOS gfxdrivers plugin to support screen rotation.<br />
<br />
Note that one could avoid modifying main.cpp altogether because the same results can be achieved by environment variables and by command line arguments. Therefore a script could set the environment variables and call the executable with the appropriate parameters. However we go through the self-contained solution, which is a bit more complex but may seen as more clean.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
The pro file must be modified to link the PDL and SDL libs, and also to look for the Qt libraries at the right location at runtime. Here we assume that the Qt libs are in a subdirectory called 'qt' below the directory where the application is deployed. <br />
<br />
Modify fancybrowser.pro and add this at the end:<br />
<br />
<pre><br />
!win32: {<br />
message(assume qws)<br />
# Set the runtime path to a relative directory w.r.t. the location of the executable<br />
LIBS += -Wl,-rpath,"'\$$ORIGIN/qt'" -L/opt/PalmPDK/device/lib -lpdl -lSDL<br />
INCLUDEPATH += /opt/PalmPDK/include/SDL<br />
}<br />
</pre><br />
<br />
Note that '''!win32:{...}''' sets these parameters for any "non windows build" (I happen to build the desktop app on Windows and the WebOS app on Linux). Ideally we would rather have something for webos ('''webos:{...}''') but I did not investigate how to do enable that - if somebody knows, feel free to share.<br />
<br />
==== Modifications to the main file ====<br />
<br />
There are modifications to main.cpp in three categories.<br />
<br />
When instanciating a QApplication object the fonts are search in the directory specified by the QT_QWS_FONTDIR environment variable. To my knowledge this cannot be specified to QApplication in another way. Therefore we set programmatically QT_QWS_FONTDIR to where we have our fonts. There are two possibilities: we can deploy the fonts of Qt, or we can use the fonts already available on the WebOS device. Using the fonts of the WebOS device is fine so we use this. See the commented-out line for the alternative approach.<br />
<br />
When instanciating the QApplication object we want to start the application as a GUI server application. This is achieved by passing QApplication::GuiServer in the QApplication constructor. The alternative approach is to call the program with '''-qws''' on the command line.<br />
<br />
The gfxdrivers plugin must be specified. This can be done with the '''-display''' command line argument. Here we programmatically set this command line argument.<br />
We have two alternatives. We can use directly the WebOS gfxdrivers plugin. This does not allow for screen rotation. The command line would then be ''''-display PalmPreSDLFb:nnn'''. <br />
Alternatively, we can use the transformed gfxdrivers in combination with the WebOS gfxdrivers plugin. This allows for screen rotation. The command line would then be '''-display Transformed:PalmPreSDLFb:nnn'''.<br />
<br />
'''nnn''' is a number which you must set to identify the display driver. In a normal embedded system only a single GUI server application would run at any time, and this number can be the same for all applications (or even left out, QApplication assumes number 0 then). This number is used by Qt to create a temporary directory ('''/tmp/qtembedded-nnn''') that contains, among others, a font cache.<br />
<br />
However, on WebOS each running Qt applications is a GUI server. Each application will thus create a '''/tmp/qtembedded-nnn''' directory. Therefore '''nnn''' must be unique for each Qt application. (maybe we need a convention to avoid conflicts - might be enough to use some randomly generated number for each app).<br />
<br />
main.cpp can be modified as follows:<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Generate the makefile and compile:<br />
# ~/qte-48/bin/qmake fancybrowser.pro<br />
# make<br />
<br />
Now the app is compiled. The Qt libs must also be deployed on the device. See the deployment section below for how to lay-out the files.<br />
<br />
<br />
<br />
<br />
<br />
=== 4.2 Qt-QML app ===<br />
<br />
We assume a copy of QTSDKDIR/Demos/4.8/declarative/webbrowser in your working directory, e.g. ~/webbrowser<br />
<br />
Essentially the same modifications must be made to the Qt-QML project as for the Qt-widget project, with some additions to the main file.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
Same as for the Qt-widget app.<br />
<br />
==== Modifications to the main file ====<br />
<br />
Same as for the Qt-widget app, and in addition we must set the path where the QML imports can be found. This can be specified with the QML_IMPORT_PATH environment variable. We set-it up programmatically here.<br />
<br />
The file main.cpp looks like this:<br />
<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// ------------------------------------------------------------------------<br />
// QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP<br />
QString qmlpath = QString(pathexe)+"/imports";<br />
if(!qputenv("QML_IMPORT_PATH",qmlpath.toAscii()))<br />
{<br />
printf("Can't set qml path");<br />
}<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Same as for Qt-widget apps.<br />
<br />
=== 4.3 Deployment ===<br />
<br />
The device directory structure, assuming the app is in APPDIR, must be as follows:<br />
<br />
<pre><br />
APPDIR: the application is here<br />
APPDIR/qt: qt libs. Copy ~/qte-48/lib/*.so.4 here)<br />
APPDIR/fonts: fonts (not needed if the WebOS fonts are used). Copy ~/qte-48/lib/fonts/* here<br />
APPDIR/gfxdrivers: gfxdrivers plugins. Copy ~/qte-48/plugins/gfxdrivers/* here<br />
APPDIR/imageformats: imageformats plugins. Copy ~/qte-48/plugins/imageformats/* here<br />
APPDIR/imports: QML stuff (not needed for Qt-widget). Copy ~/qte-48/imports/* here<br />
</pre><br />
<br />
You can typically deploy these files in /media/internal/APPDIR for testing and run the application from the command line.<br />
<br />
To create an IPK file you need in addition an appinfo.json file. For example<br />
<br />
<pre><br />
{<br />
"title": "A-Browser Qml (test)",<br />
"type": "pdk",<br />
"main": "abrowse-qml",<br />
"id": "net.danielroggen.abrowseqml",<br />
"version": "0.2.0",<br />
"vendor": "danielroggen",<br />
"icon": "icon.png" <br />
}<br />
</pre><br />
<br />
<br />
<br />
=== 4.x stuff ===<br />
* numbering of the qws stuff to avoid conflicts<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21633HowtoQt2012-02-08T14:51:07Z<p>DanRog: /* Compilation */</p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
* The reasonable development tools<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events. This step gets the WebOS Qt gfxdrivers plugin. <br />
<br />
The initial plugin version was written by Darron Black [1,2] and it uses SDL for graphics. With the changes in WebOS 2.x, that plugin doesn't work anymore: it uses root access to read the keyboard, but recent PDK apps are not running as root anymore but in jails. Therefore an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code]. It has also tentative support for screen rotation.<br />
<br />
# Cd to the Qt gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin from the svn repository: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Edit ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro to add the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# In order to support screen rotation we need to patch the "transformed" screen driver. This driver is provided by Qt to do screen rotation or offsetting and it uses as back-end the driver doing the actual access to the pixels (that would be our webos qgfxdrivers). Unfortunately the transformed driver doesn't allow to "notify" SDL when pixels are changed. A quick hack is to patch ~/qt-everywhere-opensource-src-4.8.0t/src/gui/embedded/qscreentransformed_qws.cpp. In this patch we hijack the functionality of the "blank" method (which is supposed to blank the screen) to notify the WebOS gfxdrivers before and after pixels are modified. So edit qscreentransformed_qws.cpp around lines 430 and add the two lines marked with the comments below:<br />
<br />
<pre><br />
.<br />
.<br />
.<br />
screen()->blank(true); // ADD THIS FOR WEBOS<br />
QWSDisplay::grab();<br />
for (int i = 0; i < rects.size(); ++i) {<br />
const QRect r = rects.at(i) & bound;<br />
<br />
QPoint dst;<br />
switch (trans) {<br />
case Rot90:<br />
dst = mapToDevice(r.topRight(), QSize(w, h));<br />
break;<br />
case Rot180:<br />
dst = mapToDevice(r.bottomRight(), QSize(w, h));<br />
break;<br />
case Rot270:<br />
dst = mapToDevice(r.bottomLeft(), QSize(w, h));<br />
break;<br />
default:<br />
break;<br />
}<br />
func(this, image, r.translated(-topLeft), dst);<br />
}<br />
QWSDisplay::ungrab();<br />
screen()->blank(false); // ADD THIS FOR WEBOS<br />
.<br />
.<br />
.<br />
</pre><br />
<br />
<br />
=== 3.4 Cross-compile ===<br />
<br />
<br />
Now we can configure and cross-compile Qt. The lines below configure Qt to install in ~/qte-48:<br />
<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0'''<br />
# '''./configure -v -prefix ~/qte-48 -embedded arm -platform qws/linux-x86-g++ -xplatform qws/linux-webos -depths 16,24,32 -no-multimedia -no-audio-backend -no-phonon -no-phonon-backend -no-nis -no-iconv -no-dbus -no-cups -no-largefile -no-accessibility -no-gtkstyle -no-qt3support -qt-gfx-vnc -plugin-gfx-vnc -no-glib -qtlibinfix 48 -xmlpatterns -exceptions -opensource -make libs -nomake tools -nomake demo -nomake examples -nomake docs -webkit -javascript-jit -script -scripttools -declarative -openssl -qt-gfx-transformed'''<br />
# '''make -j4'''<br />
# '''make install'''<br />
<br />
NEED TO COMPILE WEBOS manually<br />
# cd<br />
# make<br />
# make install<br />
-------------------<br />
<br />
Hopefully you've made it so far without problems! You now have Qt in ~/qte-48.<br />
<br />
<br />
== 4. Compiling Qt apps ==<br />
<br />
We see here how to compile a Qt app for Qt on WebOS. We look at two examples that are directly taken from the Qt distribution: <br />
# fancybrowser: this is a Qt-widget-based example browser. It is available in QTSDKDIR/Examples/4.8/webkit/fancybrowser<br />
# webbrowser: this is a Qt-QML-based example browser. It is available in QTSDKDRIR/Demos/4.8/declarative/webbrowser<br />
<br />
The way compilation of the apps is mostly identical, but the QML-based project has a few extra complexities so we'll see first the widget-based project.<br />
<br />
=== 4.1 Qt-widget app ===<br />
<br />
We assume a copy of QTSDKDIR/Examples/4.8/webkit/fancybrowser in your working directory, e.g. ~/fancybrowser<br />
<br />
Two things must be modified in the project: <br />
* fancybrowser.pro: this is the project file, it must be modified to include the proper libraries<br />
* main.cpp: this is the file in which the QApplication object is instanciated. We must do some setup to indicate to the application:<br />
** where to find system fonts, <br />
** to start the application as a GUI server application<br />
** to use the WebOS gfxdrivers plugin, or to use the transformed gfxdrivers plugin in combination with the WebOS gfxdrivers plugin to support screen rotation.<br />
<br />
Note that one could avoid modifying main.cpp altogether because the same results can be achieved by environment variables and by command line arguments. Therefore a script could set the environment variables and call the executable with the appropriate parameters. However we go through the self-contained solution, which is a bit more complex but may seen as more clean.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
The pro file must be modified to link the PDL and SDL libs, and also to look for the Qt libraries at the right location at runtime. Here we assume that the Qt libs are in a subdirectory called 'qt' below the directory where the application is deployed. <br />
<br />
Modify fancybrowser.pro and add this at the end:<br />
<br />
<pre><br />
!win32: {<br />
message(assume qws)<br />
# Set the runtime path to a relative directory w.r.t. the location of the executable<br />
LIBS += -Wl,-rpath,"'\$$ORIGIN/qt'" -L/opt/PalmPDK/device/lib -lpdl -lSDL<br />
INCLUDEPATH += /opt/PalmPDK/include/SDL<br />
}<br />
</pre><br />
<br />
Note that '''!win32:{...}''' sets these parameters for any "non windows build" (I happen to build the desktop app on Windows and the WebOS app on Linux). Ideally we would rather have something for webos ('''webos:{...}''') but I did not investigate how to do enable that - if somebody knows, feel free to share.<br />
<br />
==== Modifications to the main file ====<br />
<br />
There are modifications to main.cpp in three categories.<br />
<br />
When instanciating a QApplication object the fonts are search in the directory specified by the QT_QWS_FONTDIR environment variable. To my knowledge this cannot be specified to QApplication in another way. Therefore we set programmatically QT_QWS_FONTDIR to where we have our fonts. There are two possibilities: we can deploy the fonts of Qt, or we can use the fonts already available on the WebOS device. Using the fonts of the WebOS device is fine so we use this. See the commented-out line for the alternative approach.<br />
<br />
When instanciating the QApplication object we want to start the application as a GUI server application. This is achieved by passing QApplication::GuiServer in the QApplication constructor. The alternative approach is to call the program with '''-qws''' on the command line.<br />
<br />
The gfxdrivers plugin must be specified. This can be done with the '''-display''' command line argument. Here we programmatically set this command line argument.<br />
We have two alternatives. We can use directly the WebOS gfxdrivers plugin. This does not allow for screen rotation. The command line would then be ''''-display PalmPreSDLFb:nnn'''. <br />
Alternatively, we can use the transformed gfxdrivers in combination with the WebOS gfxdrivers plugin. This allows for screen rotation. The command line would then be '''-display Transformed:PalmPreSDLFb:nnn'''.<br />
<br />
'''nnn''' is a number which you must set to identify the display driver. In a normal embedded system only a single GUI server application would run at any time, and this number can be the same for all applications (or even left out, QApplication assumes number 0 then). This number is used by Qt to create a temporary directory ('''/tmp/qtembedded-nnn''') that contains, among others, a font cache.<br />
<br />
However, on WebOS each running Qt applications is a GUI server. Each application will thus create a '''/tmp/qtembedded-nnn''' directory. Therefore '''nnn''' must be unique for each Qt application. (maybe we need a convention to avoid conflicts - might be enough to use some randomly generated number for each app).<br />
<br />
main.cpp can be modified as follows:<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Generate the makefile and compile:<br />
# ~/qte-48/bin/qmake fancybrowser.pro<br />
# make<br />
<br />
Now the app is compiled. The Qt libs must also be deployed on the device. See the deployment section below for how to lay-out the files.<br />
<br />
<br />
<br />
<br />
<br />
=== 4.2 Qt-QML app ===<br />
<br />
We assume a copy of QTSDKDIR/Demos/4.8/declarative/webbrowser in your working directory, e.g. ~/webbrowser<br />
<br />
Essentially the same modifications must be made to the Qt-QML project as for the Qt-widget project, with some additions to the main file.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
Same as for the Qt-widget app.<br />
<br />
==== Modifications to the main file ====<br />
<br />
Same as for the Qt-widget app, and in addition we must set the path where the QML imports can be found. This can be specified with the QML_IMPORT_PATH environment variable. We set-it up programmatically here.<br />
<br />
The file main.cpp looks like this:<br />
<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// ------------------------------------------------------------------------<br />
// QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP<br />
QString qmlpath = QString(pathexe)+"/imports";<br />
printf("qml path: %s\n",qmlpath.toStdString().c_str());<br />
if(!qputenv("QML_IMPORT_PATH",qmlpath.toAscii()))<br />
{<br />
printf("Can't set qml path");<br />
}<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Same as for Qt-widget apps.<br />
<br />
=== 4.x deployment ===<br />
<br />
The device directory structure, assuming the app is in APPDIR, must be as follows:<br />
<br />
<pre><br />
APPDIR: the application is here<br />
APPDIR/qt: qt libs. Copy ~/qte-48/lib/*.so.4 here)<br />
APPDIR/fonts: fonts (not needed if the WebOS fonts are used). Copy ~/qte-48/lib/fonts/* here<br />
APPDIR/gfxdrivers: gfxdrivers plugins. Copy ~/qte-48/plugins/gfxdrivers/* here<br />
APPDIR/imageformats: imageformats plugins. Copy ~/qte-48/plugins/imageformats/* here<br />
APPDIR/imports: QML stuff (not needed for Qt-widget). Copy ~/qte-48/imports/* here<br />
</pre><br />
<br />
<br />
<br />
=== 4.x stuff ===<br />
* numbering of the qws stuff to avoid conflicts<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21631HowtoQt2012-02-08T14:36:28Z<p>DanRog: /* 4. Compiling Qt apps */</p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
* The reasonable development tools<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events. This step gets the WebOS Qt gfxdrivers plugin. <br />
<br />
The initial plugin version was written by Darron Black [1,2] and it uses SDL for graphics. With the changes in WebOS 2.x, that plugin doesn't work anymore: it uses root access to read the keyboard, but recent PDK apps are not running as root anymore but in jails. Therefore an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code]. It has also tentative support for screen rotation.<br />
<br />
# Cd to the Qt gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin from the svn repository: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Edit ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro to add the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# In order to support screen rotation we need to patch the "transformed" screen driver. This driver is provided by Qt to do screen rotation or offsetting and it uses as back-end the driver doing the actual access to the pixels (that would be our webos qgfxdrivers). Unfortunately the transformed driver doesn't allow to "notify" SDL when pixels are changed. A quick hack is to patch ~/qt-everywhere-opensource-src-4.8.0t/src/gui/embedded/qscreentransformed_qws.cpp. In this patch we hijack the functionality of the "blank" method (which is supposed to blank the screen) to notify the WebOS gfxdrivers before and after pixels are modified. So edit qscreentransformed_qws.cpp around lines 430 and add the two lines marked with the comments below:<br />
<br />
<pre><br />
.<br />
.<br />
.<br />
screen()->blank(true); // ADD THIS FOR WEBOS<br />
QWSDisplay::grab();<br />
for (int i = 0; i < rects.size(); ++i) {<br />
const QRect r = rects.at(i) & bound;<br />
<br />
QPoint dst;<br />
switch (trans) {<br />
case Rot90:<br />
dst = mapToDevice(r.topRight(), QSize(w, h));<br />
break;<br />
case Rot180:<br />
dst = mapToDevice(r.bottomRight(), QSize(w, h));<br />
break;<br />
case Rot270:<br />
dst = mapToDevice(r.bottomLeft(), QSize(w, h));<br />
break;<br />
default:<br />
break;<br />
}<br />
func(this, image, r.translated(-topLeft), dst);<br />
}<br />
QWSDisplay::ungrab();<br />
screen()->blank(false); // ADD THIS FOR WEBOS<br />
.<br />
.<br />
.<br />
</pre><br />
<br />
<br />
=== 3.4 Cross-compile ===<br />
<br />
<br />
Now we can configure and cross-compile Qt. The lines below configure Qt to install in ~/qte-48:<br />
<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0'''<br />
# '''./configure -v -prefix ~/qte-48 -embedded arm -platform qws/linux-x86-g++ -xplatform qws/linux-webos -depths 16,24,32 -no-multimedia -no-audio-backend -no-phonon -no-phonon-backend -no-nis -no-iconv -no-dbus -no-cups -no-largefile -no-accessibility -no-gtkstyle -no-qt3support -qt-gfx-vnc -plugin-gfx-vnc -no-glib -qtlibinfix 48 -xmlpatterns -exceptions -opensource -make libs -nomake tools -nomake demo -nomake examples -nomake docs -webkit -javascript-jit -script -scripttools -declarative -openssl -qt-gfx-transformed'''<br />
# '''make -j4'''<br />
# '''make install'''<br />
<br />
NEED TO COMPILE WEBOS manually<br />
# cd<br />
# make<br />
# make install<br />
-------------------<br />
<br />
Hopefully you've made it so far without problems! You now have Qt in ~/qte-48.<br />
<br />
<br />
== 4. Compiling Qt apps ==<br />
<br />
We see here how to compile a Qt app for Qt on WebOS. We look at two examples that are directly taken from the Qt distribution: <br />
# fancybrowser: this is a Qt-widget-based example browser. It is available in QTSDKDIR/Examples/4.8/webkit/fancybrowser<br />
# webbrowser: this is a Qt-QML-based example browser. It is available in QTSDKDRIR/Demos/4.8/declarative/webbrowser<br />
<br />
The way compilation of the apps is mostly identical, but the QML-based project has a few extra complexities so we'll see first the widget-based project.<br />
<br />
=== 4.1 Qt-widget app ===<br />
<br />
We assume a copy of QTSDKDIR/Examples/4.8/webkit/fancybrowser in your working directory, e.g. ~/fancybrowser<br />
<br />
Two things must be modified in the project: <br />
* fancybrowser.pro: this is the project file, it must be modified to include the proper libraries<br />
* main.cpp: this is the file in which the QApplication object is instanciated. We must do some setup to indicate to the application:<br />
** where to find system fonts, <br />
** to start the application as a GUI server application<br />
** to use the WebOS gfxdrivers plugin, or to use the transformed gfxdrivers plugin in combination with the WebOS gfxdrivers plugin to support screen rotation.<br />
<br />
Note that one could avoid modifying main.cpp altogether because the same results can be achieved by environment variables and by command line arguments. Therefore a script could set the environment variables and call the executable with the appropriate parameters. However we go through the self-contained solution, which is a bit more complex but may seen as more clean.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
The pro file must be modified to link the PDL and SDL libs, and also to look for the Qt libraries at the right location at runtime. Here we assume that the Qt libs are in a subdirectory called 'qt' below the directory where the application is deployed. <br />
<br />
Modify fancybrowser.pro and add this at the end:<br />
<br />
<pre><br />
!win32: {<br />
message(assume qws)<br />
# Set the runtime path to a relative directory w.r.t. the location of the executable<br />
LIBS += -Wl,-rpath,"'\$$ORIGIN/qt'" -L/opt/PalmPDK/device/lib -lpdl -lSDL<br />
INCLUDEPATH += /opt/PalmPDK/include/SDL<br />
}<br />
</pre><br />
<br />
Note that '''!win32:{...}''' sets these parameters for any "non windows build" (I happen to build the desktop app on Windows and the WebOS app on Linux). Ideally we would rather have something for webos ('''webos:{...}''') but I did not investigate how to do enable that - if somebody knows, feel free to share.<br />
<br />
==== Modifications to the main file ====<br />
<br />
There are modifications to main.cpp in three categories.<br />
<br />
When instanciating a QApplication object the fonts are search in the directory specified by the QT_QWS_FONTDIR environment variable. To my knowledge this cannot be specified to QApplication in another way. Therefore we set programmatically QT_QWS_FONTDIR to where we have our fonts. There are two possibilities: we can deploy the fonts of Qt, or we can use the fonts already available on the WebOS device. Using the fonts of the WebOS device is fine so we use this. See the commented-out line for the alternative approach.<br />
<br />
When instanciating the QApplication object we want to start the application as a GUI server application. This is achieved by passing QApplication::GuiServer in the QApplication constructor. The alternative approach is to call the program with '''-qws''' on the command line.<br />
<br />
The gfxdrivers plugin must be specified. This can be done with the '''-display''' command line argument. Here we programmatically set this command line argument.<br />
We have two alternatives. We can use directly the WebOS gfxdrivers plugin. This does not allow for screen rotation. The command line would then be ''''-display PalmPreSDLFb:nnn'''. <br />
Alternatively, we can use the transformed gfxdrivers in combination with the WebOS gfxdrivers plugin. This allows for screen rotation. The command line would then be '''-display Transformed:PalmPreSDLFb:nnn'''.<br />
<br />
'''nnn''' is a number which you must set to identify the display driver. In a normal embedded system only a single GUI server application would run at any time, and this number can be the same for all applications (or even left out, QApplication assumes number 0 then). This number is used by Qt to create a temporary directory ('''/tmp/qtembedded-nnn''') that contains, among others, a font cache.<br />
<br />
However, on WebOS each running Qt applications is a GUI server. Each application will thus create a '''/tmp/qtembedded-nnn''' directory. Therefore '''nnn''' must be unique for each Qt application. (maybe we need a convention to avoid conflicts - might be enough to use some randomly generated number for each app).<br />
<br />
main.cpp can be modified as follows:<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Generate the makefile and compile:<br />
# ~/qte-48/bin/qmake fancybrowser.pro<br />
# make<br />
<br />
Now the app is compiled. The Qt libs must also be deployed on the device. See the deployment section below for how to lay-out the files.<br />
<br />
<br />
<br />
<br />
<br />
=== 4.2 Qt-QML app ===<br />
<br />
We assume a copy of QTSDKDIR/Demos/4.8/declarative/webbrowser in your working directory, e.g. ~/webbrowser<br />
<br />
Essentially the same modifications must be made to the Qt-QML project as for the Qt-widget project, with some additions to the main file.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
Same as for the Qt-widget app.<br />
<br />
==== Modifications to the main file ====<br />
<br />
Same as for the Qt-widget app, and in addition we must set the path where the QML imports can be found. This can be specified with the QML_IMPORT_PATH environment variable. We set-it up programmatically here.<br />
<br />
The file main.cpp looks like this:<br />
<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// ------------------------------------------------------------------------<br />
// QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP QML SETUP<br />
QString qmlpath = QString(pathexe)+"/imports";<br />
printf("qml path: %s\n",qmlpath.toStdString().c_str());<br />
if(!qputenv("QML_IMPORT_PATH",qmlpath.toAscii()))<br />
{<br />
printf("Can't set qml path");<br />
}<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Generate the makefile and compile:<br />
# ~/qte-48/bin/qmake fancybrowser.pro<br />
# make<br />
<br />
Now the app is compiled. The Qt libs must also be deployed on the device. The device directory structure, assuming the app is in APPDIR, must be as follows:<br />
<br />
<pre><br />
APPDIR: the application is here<br />
APPDIR/qt: qt libs. Copy ~/qte-48/lib/*.so.4 here)<br />
APPDIR/fonts: fonts (not needed if the WebOS fonts are used). Copy ~/qte-48/lib/fonts/* here<br />
APPDIR/gfxdrivers: gfxdrivers plugins. Copy ~/qte-48/plugins/gfxdrivers/* here<br />
APPDIR/imageformats: imageformats plugins. Copy ~/qte-48/plugins/imageformats/* here<br />
APPDIR/imports: QML stuff (not needed for Qt-widget). Copy ~/qte-48/imports/* here<br />
</pre><br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
=== 4.x deployment ===<br />
<br />
The device directory structure, assuming the app is in APPDIR, must be as follows:<br />
<br />
<pre><br />
APPDIR: the application is here<br />
APPDIR/qt: qt libs. Copy ~/qte-48/lib/*.so.4 here)<br />
APPDIR/fonts: fonts (not needed if the WebOS fonts are used). Copy ~/qte-48/lib/fonts/* here<br />
APPDIR/gfxdrivers: gfxdrivers plugins. Copy ~/qte-48/plugins/gfxdrivers/* here<br />
APPDIR/imageformats: imageformats plugins. Copy ~/qte-48/plugins/imageformats/* here<br />
APPDIR/imports: QML stuff (not needed for Qt-widget). Copy ~/qte-48/imports/* here<br />
</pre><br />
<br />
<br />
<br />
=== 4.x stuff ===<br />
* numbering of the qws stuff to avoid conflicts<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21629HowtoQt2012-02-08T14:29:46Z<p>DanRog: /* 4. Compiling Qt apps */</p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
* The reasonable development tools<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events. This step gets the WebOS Qt gfxdrivers plugin. <br />
<br />
The initial plugin version was written by Darron Black [1,2] and it uses SDL for graphics. With the changes in WebOS 2.x, that plugin doesn't work anymore: it uses root access to read the keyboard, but recent PDK apps are not running as root anymore but in jails. Therefore an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code]. It has also tentative support for screen rotation.<br />
<br />
# Cd to the Qt gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin from the svn repository: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Edit ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro to add the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# In order to support screen rotation we need to patch the "transformed" screen driver. This driver is provided by Qt to do screen rotation or offsetting and it uses as back-end the driver doing the actual access to the pixels (that would be our webos qgfxdrivers). Unfortunately the transformed driver doesn't allow to "notify" SDL when pixels are changed. A quick hack is to patch ~/qt-everywhere-opensource-src-4.8.0t/src/gui/embedded/qscreentransformed_qws.cpp. In this patch we hijack the functionality of the "blank" method (which is supposed to blank the screen) to notify the WebOS gfxdrivers before and after pixels are modified. So edit qscreentransformed_qws.cpp around lines 430 and add the two lines marked with the comments below:<br />
<br />
<pre><br />
.<br />
.<br />
.<br />
screen()->blank(true); // ADD THIS FOR WEBOS<br />
QWSDisplay::grab();<br />
for (int i = 0; i < rects.size(); ++i) {<br />
const QRect r = rects.at(i) & bound;<br />
<br />
QPoint dst;<br />
switch (trans) {<br />
case Rot90:<br />
dst = mapToDevice(r.topRight(), QSize(w, h));<br />
break;<br />
case Rot180:<br />
dst = mapToDevice(r.bottomRight(), QSize(w, h));<br />
break;<br />
case Rot270:<br />
dst = mapToDevice(r.bottomLeft(), QSize(w, h));<br />
break;<br />
default:<br />
break;<br />
}<br />
func(this, image, r.translated(-topLeft), dst);<br />
}<br />
QWSDisplay::ungrab();<br />
screen()->blank(false); // ADD THIS FOR WEBOS<br />
.<br />
.<br />
.<br />
</pre><br />
<br />
<br />
=== 3.4 Cross-compile ===<br />
<br />
<br />
Now we can configure and cross-compile Qt. The lines below configure Qt to install in ~/qte-48:<br />
<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0'''<br />
# '''./configure -v -prefix ~/qte-48 -embedded arm -platform qws/linux-x86-g++ -xplatform qws/linux-webos -depths 16,24,32 -no-multimedia -no-audio-backend -no-phonon -no-phonon-backend -no-nis -no-iconv -no-dbus -no-cups -no-largefile -no-accessibility -no-gtkstyle -no-qt3support -qt-gfx-vnc -plugin-gfx-vnc -no-glib -qtlibinfix 48 -xmlpatterns -exceptions -opensource -make libs -nomake tools -nomake demo -nomake examples -nomake docs -webkit -javascript-jit -script -scripttools -declarative -openssl -qt-gfx-transformed'''<br />
# '''make -j4'''<br />
# '''make install'''<br />
<br />
NEED TO COMPILE WEBOS manually<br />
# cd<br />
# make<br />
# make install<br />
-------------------<br />
<br />
Hopefully you've made it so far without problems! You now have Qt in ~/qte-48.<br />
<br />
<br />
== 4. Compiling Qt apps ==<br />
<br />
We see here how to compile a Qt app for Qt on WebOS. We look at two examples that are directly taken from the Qt distribution: <br />
# fancybrowser: this is a Qt-widget-based example browser. It is available in QTSDKDIR/Examples/4.8/webkit/fancybrowser<br />
# webbrowser: this is a Qt-QML-based example browser. It is available in QTSDKDRIR/Demos/4.8/declarative/webbrowser<br />
<br />
The way compilation of the apps is mostly identical, but the QML-based project has a few extra complexities so we'll see first the widget-based project.<br />
<br />
=== 4.1 Qt-widget app ===<br />
<br />
We assume a copy of QTSDKDIR/Examples/4.8/webkit/fancybrowser in your working directory, e.g. ~/fancybrowser<br />
<br />
Two things must be modified in the project: <br />
* fancybrowser.pro: this is the project file, it must be modified to include the proper libraries<br />
* main.cpp: this is the file in which the QApplication object is instanciated. We must do some setup to indicate to the application:<br />
** where to find system fonts, <br />
** to start the application as a GUI server application<br />
** to use the WebOS gfxdrivers plugin, or to use the transformed gfxdrivers plugin in combination with the WebOS gfxdrivers plugin to support screen rotation.<br />
<br />
Note that one could avoid modifying main.cpp altogether because the same results can be achieved by environment variables and by command line arguments. Therefore a script could set the environment variables and call the executable with the appropriate parameters. However we go through the self-contained solution, which is a bit more complex but may seen as more clean.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
The pro file must be modified to link the PDL and SDL libs, and also to look for the Qt libraries at the right location at runtime. Here we assume that the Qt libs are in a subdirectory called 'qt' below the directory where the application is deployed. <br />
<br />
Modify fancybrowser.pro and add this at the end:<br />
<br />
<pre><br />
!win32: {<br />
message(assume qws)<br />
# Set the runtime path to a relative directory w.r.t. the location of the executable<br />
LIBS += -Wl,-rpath,"'\$$ORIGIN/qt'" -L/opt/PalmPDK/device/lib -lpdl -lSDL<br />
INCLUDEPATH += /opt/PalmPDK/include/SDL<br />
}<br />
</pre><br />
<br />
Note that '''!win32:{...}''' sets these parameters for any "non windows build" (I happen to build the desktop app on Windows and the WebOS app on Linux). Ideally we would rather have something for webos ('''webos:{...}''') but I did not investigate how to do enable that - if somebody knows, feel free to share.<br />
<br />
==== Modifications to the main file ====<br />
<br />
There are modifications to main.cpp in three categories.<br />
<br />
When instanciating a QApplication object the fonts are search in the directory specified by the QT_QWS_FONTDIR environment variable. To my knowledge this cannot be specified to QApplication in another way. Therefore we set programmatically QT_QWS_FONTDIR to where we have our fonts. There are two possibilities: we can deploy the fonts of Qt, or we can use the fonts already available on the WebOS device. Using the fonts of the WebOS device is fine so we use this. See the commented-out line for the alternative approach.<br />
<br />
When instanciating the QApplication object we want to start the application as a GUI server application. This is achieved by passing QApplication::GuiServer in the QApplication constructor. The alternative approach is to call the program with '''-qws''' on the command line.<br />
<br />
The gfxdrivers plugin must be specified. This can be done with the '''-display''' command line argument. Here we programmatically set this command line argument.<br />
We have two alternatives. We can use directly the WebOS gfxdrivers plugin. This does not allow for screen rotation. The command line would then be ''''-display PalmPreSDLFb:nnn'''. <br />
Alternatively, we can use the transformed gfxdrivers in combination with the WebOS gfxdrivers plugin. This allows for screen rotation. The command line would then be '''-display Transformed:PalmPreSDLFb:nnn'''.<br />
<br />
'''nnn''' is a number which you must set to identify the display driver. In a normal embedded system only a single GUI server application would run at any time, and this number can be the same for all applications (or even left out, QApplication assumes number 0 then). This number is used by Qt to create a temporary directory ('''/tmp/qtembedded-nnn''') that contains, among others, a font cache.<br />
<br />
However, on WebOS each running Qt applications is a GUI server. Each application will thus create a '''/tmp/qtembedded-nnn''' directory. Therefore '''nnn''' must be unique for each Qt application. (maybe we need a convention to avoid conflicts - might be enough to use some randomly generated number for each app).<br />
<br />
main.cpp can be modified as follows:<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
==== Compilation ====<br />
<br />
Generate the makefile and compile:<br />
# ~/qte-48/bin/qmake fancybrowser.pro<br />
# make<br />
<br />
Now the app is compiled. The Qt libs must also be deployed on the device. The device directory structure, assuming the app is in APPDIR, must be as follows:<br />
<br />
<pre><br />
APPDIR: the application is here<br />
APPDIR/qt: qt libs. Copy ~/qte-48/lib/*.so.4 here)<br />
APPDIR/fonts: fonts (not needed if the WebOS fonts are used). Copy ~/qte-48/lib/fonts/* here<br />
APPDIR/gfxdrivers: gfxdrivers plugins. Copy ~/qte-48/plugins/gfxdrivers/* here<br />
APPDIR/imageformats: imageformats plugins. Copy ~/qte-48/plugins/imageformats/* here<br />
APPDIR/imports: QML stuff (not needed for Qt-widget). Copy ~/qte-48/imports/* here<br />
</pre><br />
<br />
<br />
<br />
<br />
<br />
=== 4.2 Qt-QML app ===<br />
<br />
=== 4.x deployment ===<br />
<br />
=== 4.x stuff ===<br />
* numbering of the qws stuff to avoid conflicts<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21627HowtoQt2012-02-08T14:22:43Z<p>DanRog: /* Modifications to the main file */</p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
* The reasonable development tools<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events. This step gets the WebOS Qt gfxdrivers plugin. <br />
<br />
The initial plugin version was written by Darron Black [1,2] and it uses SDL for graphics. With the changes in WebOS 2.x, that plugin doesn't work anymore: it uses root access to read the keyboard, but recent PDK apps are not running as root anymore but in jails. Therefore an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code]. It has also tentative support for screen rotation.<br />
<br />
# Cd to the Qt gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin from the svn repository: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Edit ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro to add the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# In order to support screen rotation we need to patch the "transformed" screen driver. This driver is provided by Qt to do screen rotation or offsetting and it uses as back-end the driver doing the actual access to the pixels (that would be our webos qgfxdrivers). Unfortunately the transformed driver doesn't allow to "notify" SDL when pixels are changed. A quick hack is to patch ~/qt-everywhere-opensource-src-4.8.0t/src/gui/embedded/qscreentransformed_qws.cpp. In this patch we hijack the functionality of the "blank" method (which is supposed to blank the screen) to notify the WebOS gfxdrivers before and after pixels are modified. So edit qscreentransformed_qws.cpp around lines 430 and add the two lines marked with the comments below:<br />
<br />
<pre><br />
.<br />
.<br />
.<br />
screen()->blank(true); // ADD THIS FOR WEBOS<br />
QWSDisplay::grab();<br />
for (int i = 0; i < rects.size(); ++i) {<br />
const QRect r = rects.at(i) & bound;<br />
<br />
QPoint dst;<br />
switch (trans) {<br />
case Rot90:<br />
dst = mapToDevice(r.topRight(), QSize(w, h));<br />
break;<br />
case Rot180:<br />
dst = mapToDevice(r.bottomRight(), QSize(w, h));<br />
break;<br />
case Rot270:<br />
dst = mapToDevice(r.bottomLeft(), QSize(w, h));<br />
break;<br />
default:<br />
break;<br />
}<br />
func(this, image, r.translated(-topLeft), dst);<br />
}<br />
QWSDisplay::ungrab();<br />
screen()->blank(false); // ADD THIS FOR WEBOS<br />
.<br />
.<br />
.<br />
</pre><br />
<br />
<br />
=== 3.4 Cross-compile ===<br />
<br />
<br />
Now we can configure and cross-compile Qt. The lines below configure Qt to install in ~/qte-48:<br />
<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0'''<br />
# '''./configure -v -prefix ~/qte-48 -embedded arm -platform qws/linux-x86-g++ -xplatform qws/linux-webos -depths 16,24,32 -no-multimedia -no-audio-backend -no-phonon -no-phonon-backend -no-nis -no-iconv -no-dbus -no-cups -no-largefile -no-accessibility -no-gtkstyle -no-qt3support -qt-gfx-vnc -plugin-gfx-vnc -no-glib -qtlibinfix 48 -xmlpatterns -exceptions -opensource -make libs -nomake tools -nomake demo -nomake examples -nomake docs -webkit -javascript-jit -script -scripttools -declarative -openssl -qt-gfx-transformed'''<br />
# '''make -j4'''<br />
# '''make install'''<br />
<br />
NEED TO COMPILE WEBOS manually<br />
# cd<br />
# make<br />
# make install<br />
-------------------<br />
<br />
Hopefully you've made it so far without problems! You now have Qt in ~/qte-48.<br />
<br />
<br />
== 4. Compiling Qt apps ==<br />
<br />
We see here how to compile a Qt app for Qt on WebOS. We look at two examples that are directly taken from the Qt distribution: <br />
# fancybrowser: this is a Qt-widget-based example browser. It is available in QTSDKDIR/Examples/4.8/webkit/fancybrowser<br />
# webbrowser: this is a Qt-QML-based example browser. It is available in QTSDKDRIR/Demos/4.8/declarative/webbrowser<br />
<br />
The way compilation of the apps is mostly identical, but the QML-based project has a few extra complexities so we'll see first the widget-based project.<br />
<br />
=== 4.1 Qt-widget app ===<br />
<br />
We assume a copy of QTSDKDIR/Examples/4.8/webkit/fancybrowser in your working directory, e.g. ~/fancybrowser<br />
<br />
Two things must be modified in the project: <br />
* fancybrowser.pro: this is the project file, it must be modified to include the proper libraries<br />
* main.cpp: this is the file in which the QApplication object is instanciated. We must do some setup to indicate to the application:<br />
** where to find system fonts, <br />
** to start the application as a GUI server application<br />
** to use the WebOS gfxdrivers plugin, or to use the transformed gfxdrivers plugin in combination with the WebOS gfxdrivers plugin to support screen rotation.<br />
<br />
Note that one could avoid modifying main.cpp altogether because the same results can be achieved by environment variables and by command line arguments. Therefore a script could set the environment variables and call the executable with the appropriate parameters. However we go through the self-contained solution, which is a bit more complex but may seen as more clean.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
The pro file must be modified to link the PDL and SDL libs, and also to look for the Qt libraries at the right location at runtime. Here we assume that the Qt libs are in a subdirectory called 'qt' below the directory where the application is deployed. <br />
<br />
Modify fancybrowser.pro and add this at the end:<br />
<br />
<pre><br />
!win32: {<br />
message(assume qws)<br />
# Set the runtime path to a relative directory w.r.t. the location of the executable<br />
LIBS += -Wl,-rpath,"'\$$ORIGIN/qt'" -L/opt/PalmPDK/device/lib -lpdl -lSDL<br />
INCLUDEPATH += /opt/PalmPDK/include/SDL<br />
}<br />
</pre><br />
<br />
Note that '''!win32:{...}''' sets these parameters for any "non windows build" (I happen to build the desktop app on Windows and the WebOS app on Linux). Ideally we would rather have something for webos ('''webos:{...}''') but I did not investigate how to do enable that - if somebody knows, feel free to share.<br />
<br />
==== Modifications to the main file ====<br />
<br />
There are modifications to main.cpp in three categories.<br />
<br />
When instanciating a QApplication object the fonts are search in the directory specified by the QT_QWS_FONTDIR environment variable. To my knowledge this cannot be specified to QApplication in another way. Therefore we set programmatically QT_QWS_FONTDIR to where we have our fonts. There are two possibilities: we can deploy the fonts of Qt, or we can use the fonts already available on the WebOS device. Using the fonts of the WebOS device is fine so we use this. See the commented-out line for the alternative approach.<br />
<br />
When instanciating the QApplication object we want to start the application as a GUI server application. This is achieved by passing QApplication::GuiServer in the QApplication constructor. The alternative approach is to call the program with '''-qws''' on the command line.<br />
<br />
The gfxdrivers plugin must be specified. This can be done with the '''-display''' command line argument. Here we programmatically set this command line argument.<br />
We have two alternatives. We can use directly the WebOS gfxdrivers plugin. This does not allow for screen rotation. The command line would then be ''''-display PalmPreSDLFb:nnn'''. <br />
Alternatively, we can use the transformed gfxdrivers in combination with the WebOS gfxdrivers plugin. This allows for screen rotation. The command line would then be '''-display Transformed:PalmPreSDLFb:nnn'''.<br />
<br />
'''nnn''' is a number which you must set to identify the display driver. In a normal embedded system only a single GUI server application would run at any time, and this number can be the same for all applications (or even left out, QApplication assumes number 0 then). This number is used by Qt to create a temporary directory ('''/tmp/qtembedded-nnn''') that contains, among others, a font cache.<br />
<br />
However, on WebOS each running Qt applications is a GUI server. Each application will thus create a '''/tmp/qtembedded-nnn''' directory. Therefore '''nnn''' must be unique for each Qt application. (maybe we need a convention to avoid conflicts - might be enough to use some randomly generated number for each app).<br />
<br />
main.cpp can be modified as follows:<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS - business as usual"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
=== 4.2 Qt-QML app ===<br />
<br />
=== 4.x deployment ===<br />
<br />
=== 4.x stuff ===<br />
* numbering of the qws stuff to avoid conflicts<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21625HowtoQt2012-02-08T14:22:10Z<p>DanRog: /* Modifications to the main file */</p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
* The reasonable development tools<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events. This step gets the WebOS Qt gfxdrivers plugin. <br />
<br />
The initial plugin version was written by Darron Black [1,2] and it uses SDL for graphics. With the changes in WebOS 2.x, that plugin doesn't work anymore: it uses root access to read the keyboard, but recent PDK apps are not running as root anymore but in jails. Therefore an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code]. It has also tentative support for screen rotation.<br />
<br />
# Cd to the Qt gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin from the svn repository: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Edit ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro to add the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# In order to support screen rotation we need to patch the "transformed" screen driver. This driver is provided by Qt to do screen rotation or offsetting and it uses as back-end the driver doing the actual access to the pixels (that would be our webos qgfxdrivers). Unfortunately the transformed driver doesn't allow to "notify" SDL when pixels are changed. A quick hack is to patch ~/qt-everywhere-opensource-src-4.8.0t/src/gui/embedded/qscreentransformed_qws.cpp. In this patch we hijack the functionality of the "blank" method (which is supposed to blank the screen) to notify the WebOS gfxdrivers before and after pixels are modified. So edit qscreentransformed_qws.cpp around lines 430 and add the two lines marked with the comments below:<br />
<br />
<pre><br />
.<br />
.<br />
.<br />
screen()->blank(true); // ADD THIS FOR WEBOS<br />
QWSDisplay::grab();<br />
for (int i = 0; i < rects.size(); ++i) {<br />
const QRect r = rects.at(i) & bound;<br />
<br />
QPoint dst;<br />
switch (trans) {<br />
case Rot90:<br />
dst = mapToDevice(r.topRight(), QSize(w, h));<br />
break;<br />
case Rot180:<br />
dst = mapToDevice(r.bottomRight(), QSize(w, h));<br />
break;<br />
case Rot270:<br />
dst = mapToDevice(r.bottomLeft(), QSize(w, h));<br />
break;<br />
default:<br />
break;<br />
}<br />
func(this, image, r.translated(-topLeft), dst);<br />
}<br />
QWSDisplay::ungrab();<br />
screen()->blank(false); // ADD THIS FOR WEBOS<br />
.<br />
.<br />
.<br />
</pre><br />
<br />
<br />
=== 3.4 Cross-compile ===<br />
<br />
<br />
Now we can configure and cross-compile Qt. The lines below configure Qt to install in ~/qte-48:<br />
<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0'''<br />
# '''./configure -v -prefix ~/qte-48 -embedded arm -platform qws/linux-x86-g++ -xplatform qws/linux-webos -depths 16,24,32 -no-multimedia -no-audio-backend -no-phonon -no-phonon-backend -no-nis -no-iconv -no-dbus -no-cups -no-largefile -no-accessibility -no-gtkstyle -no-qt3support -qt-gfx-vnc -plugin-gfx-vnc -no-glib -qtlibinfix 48 -xmlpatterns -exceptions -opensource -make libs -nomake tools -nomake demo -nomake examples -nomake docs -webkit -javascript-jit -script -scripttools -declarative -openssl -qt-gfx-transformed'''<br />
# '''make -j4'''<br />
# '''make install'''<br />
<br />
NEED TO COMPILE WEBOS manually<br />
# cd<br />
# make<br />
# make install<br />
-------------------<br />
<br />
Hopefully you've made it so far without problems! You now have Qt in ~/qte-48.<br />
<br />
<br />
== 4. Compiling Qt apps ==<br />
<br />
We see here how to compile a Qt app for Qt on WebOS. We look at two examples that are directly taken from the Qt distribution: <br />
# fancybrowser: this is a Qt-widget-based example browser. It is available in QTSDKDIR/Examples/4.8/webkit/fancybrowser<br />
# webbrowser: this is a Qt-QML-based example browser. It is available in QTSDKDRIR/Demos/4.8/declarative/webbrowser<br />
<br />
The way compilation of the apps is mostly identical, but the QML-based project has a few extra complexities so we'll see first the widget-based project.<br />
<br />
=== 4.1 Qt-widget app ===<br />
<br />
We assume a copy of QTSDKDIR/Examples/4.8/webkit/fancybrowser in your working directory, e.g. ~/fancybrowser<br />
<br />
Two things must be modified in the project: <br />
* fancybrowser.pro: this is the project file, it must be modified to include the proper libraries<br />
* main.cpp: this is the file in which the QApplication object is instanciated. We must do some setup to indicate to the application:<br />
** where to find system fonts, <br />
** to start the application as a GUI server application<br />
** to use the WebOS gfxdrivers plugin, or to use the transformed gfxdrivers plugin in combination with the WebOS gfxdrivers plugin to support screen rotation.<br />
<br />
Note that one could avoid modifying main.cpp altogether because the same results can be achieved by environment variables and by command line arguments. Therefore a script could set the environment variables and call the executable with the appropriate parameters. However we go through the self-contained solution, which is a bit more complex but may seen as more clean.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
The pro file must be modified to link the PDL and SDL libs, and also to look for the Qt libraries at the right location at runtime. Here we assume that the Qt libs are in a subdirectory called 'qt' below the directory where the application is deployed. <br />
<br />
Modify fancybrowser.pro and add this at the end:<br />
<br />
<pre><br />
!win32: {<br />
message(assume qws)<br />
# Set the runtime path to a relative directory w.r.t. the location of the executable<br />
LIBS += -Wl,-rpath,"'\$$ORIGIN/qt'" -L/opt/PalmPDK/device/lib -lpdl -lSDL<br />
INCLUDEPATH += /opt/PalmPDK/include/SDL<br />
}<br />
</pre><br />
<br />
Note that '''!win32:{...}''' sets these parameters for any "non windows build" (I happen to build the desktop app on Windows and the WebOS app on Linux). Ideally we would rather have something for webos ('''webos:{...}''') but I did not investigate how to do enable that - if somebody knows, feel free to share.<br />
<br />
==== Modifications to the main file ====<br />
<br />
There are modifications to main.cpp in three categories.<br />
<br />
When instanciating a QApplication object the fonts are search in the directory specified by the QT_QWS_FONTDIR environment variable. To my knowledge this cannot be specified to QApplication in another way. Therefore we set programmatically QT_QWS_FONTDIR to where we have our fonts. There are two possibilities: we can deploy the fonts of Qt, or we can use the fonts already available on the WebOS device. Using the fonts of the WebOS device is fine so we use this. See the commented-out line for the alternative approach.<br />
<br />
When instanciating the QApplication object we want to start the application as a GUI server application. This is achieved by passing QApplication::GuiServer in the QApplication constructor. The alternative approach is to call the program with '''-qws''' on the command line.<br />
<br />
The gfxdrivers plugin must be specified. This can be done with the '''-display''' command line argument. Here we programmatically set this command line argument.<br />
We have two alternatives. We can use directly the WebOS gfxdrivers plugin. This does not allow for screen rotation. The command line would then be ''''-display PalmPreSDLFb:nnn'''. <br />
Alternatively, we can use the transformed gfxdrivers in combination with the WebOS gfxdrivers plugin. This allows for screen rotation. The command line would then be '''-display Transformed:PalmPreSDLFb:nnn'''.<br />
<br />
'''nnn''' is a number which you must set to identify the display driver. In a normal embedded system only a single GUI server application would run at any time, and this number can be the same for all applications (or even left out, QApplication assumes number 0 then). This number is used by Qt to create a temporary directory ('''/tmp/qtembedded-nnn''') that contains, among others, a font cache.<br />
<br />
However, on WebOS each running Qt applications is a GUI server. Each application will thus create a '''/tmp/qtembedded-nnn''' directory. Therefore '''nnn''' must be unique for each Qt application. (maybe we need a convention to avoid conflicts - might be enough to use some randomly generated number for each app).<br />
<br />
main.cpp can be modified as follows:<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii())) // USE THIS IF YOU DEPLOY YOUR OWN FONTS<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts")) // USE THIS IF YOU USE THE WEBOS FONTS<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN W/O ROTATION<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:100"}; // USE THIS FOR THE WEBOS GFXDRIVERS PLUGIN AND ROTATION<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer); <br />
<br />
#else<br />
#warning "No QWS, all OK"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
.<br />
.<br />
.<br />
.<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
=== 4.2 Qt-QML app ===<br />
<br />
=== 4.x deployment ===<br />
<br />
=== 4.x stuff ===<br />
* numbering of the qws stuff to avoid conflicts<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21623HowtoQt2012-02-08T14:03:51Z<p>DanRog: /* Modifications to the .pro file */</p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
* The reasonable development tools<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events. This step gets the WebOS Qt gfxdrivers plugin. <br />
<br />
The initial plugin version was written by Darron Black [1,2] and it uses SDL for graphics. With the changes in WebOS 2.x, that plugin doesn't work anymore: it uses root access to read the keyboard, but recent PDK apps are not running as root anymore but in jails. Therefore an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code]. It has also tentative support for screen rotation.<br />
<br />
# Cd to the Qt gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin from the svn repository: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Edit ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro to add the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# In order to support screen rotation we need to patch the "transformed" screen driver. This driver is provided by Qt to do screen rotation or offsetting and it uses as back-end the driver doing the actual access to the pixels (that would be our webos qgfxdrivers). Unfortunately the transformed driver doesn't allow to "notify" SDL when pixels are changed. A quick hack is to patch ~/qt-everywhere-opensource-src-4.8.0t/src/gui/embedded/qscreentransformed_qws.cpp. In this patch we hijack the functionality of the "blank" method (which is supposed to blank the screen) to notify the WebOS gfxdrivers before and after pixels are modified. So edit qscreentransformed_qws.cpp around lines 430 and add the two lines marked with the comments below:<br />
<br />
<pre><br />
.<br />
.<br />
.<br />
screen()->blank(true); // ADD THIS FOR WEBOS<br />
QWSDisplay::grab();<br />
for (int i = 0; i < rects.size(); ++i) {<br />
const QRect r = rects.at(i) & bound;<br />
<br />
QPoint dst;<br />
switch (trans) {<br />
case Rot90:<br />
dst = mapToDevice(r.topRight(), QSize(w, h));<br />
break;<br />
case Rot180:<br />
dst = mapToDevice(r.bottomRight(), QSize(w, h));<br />
break;<br />
case Rot270:<br />
dst = mapToDevice(r.bottomLeft(), QSize(w, h));<br />
break;<br />
default:<br />
break;<br />
}<br />
func(this, image, r.translated(-topLeft), dst);<br />
}<br />
QWSDisplay::ungrab();<br />
screen()->blank(false); // ADD THIS FOR WEBOS<br />
.<br />
.<br />
.<br />
</pre><br />
<br />
<br />
=== 3.4 Cross-compile ===<br />
<br />
<br />
Now we can configure and cross-compile Qt. The lines below configure Qt to install in ~/qte-48:<br />
<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0'''<br />
# '''./configure -v -prefix ~/qte-48 -embedded arm -platform qws/linux-x86-g++ -xplatform qws/linux-webos -depths 16,24,32 -no-multimedia -no-audio-backend -no-phonon -no-phonon-backend -no-nis -no-iconv -no-dbus -no-cups -no-largefile -no-accessibility -no-gtkstyle -no-qt3support -qt-gfx-vnc -plugin-gfx-vnc -no-glib -qtlibinfix 48 -xmlpatterns -exceptions -opensource -make libs -nomake tools -nomake demo -nomake examples -nomake docs -webkit -javascript-jit -script -scripttools -declarative -openssl -qt-gfx-transformed'''<br />
# '''make -j4'''<br />
# '''make install'''<br />
<br />
NEED TO COMPILE WEBOS manually<br />
# cd<br />
# make<br />
# make install<br />
-------------------<br />
<br />
Hopefully you've made it so far without problems! You now have Qt in ~/qte-48.<br />
<br />
<br />
== 4. Compiling Qt apps ==<br />
<br />
We see here how to compile a Qt app for Qt on WebOS. We look at two examples that are directly taken from the Qt distribution: <br />
# fancybrowser: this is a Qt-widget-based example browser. It is available in QTSDKDIR/Examples/4.8/webkit/fancybrowser<br />
# webbrowser: this is a Qt-QML-based example browser. It is available in QTSDKDRIR/Demos/4.8/declarative/webbrowser<br />
<br />
The way compilation of the apps is mostly identical, but the QML-based project has a few extra complexities so we'll see first the widget-based project.<br />
<br />
=== 4.1 Qt-widget app ===<br />
<br />
We assume a copy of QTSDKDIR/Examples/4.8/webkit/fancybrowser in your working directory, e.g. ~/fancybrowser<br />
<br />
Two things must be modified in the project: <br />
* fancybrowser.pro: this is the project file, it must be modified to include the proper libraries<br />
* main.cpp: this is the file in which the QApplication object is instanciated. We must do some setup to indicate to the application:<br />
** where to find system fonts, <br />
** to start the application as a GUI server application<br />
** to use the WebOS gfxdrivers plugin, or to use the transformed gfxdrivers plugin in combination with the WebOS gfxdrivers plugin to support screen rotation.<br />
<br />
Note that one could avoid modifying main.cpp altogether because the same results can be achieved by environment variables and by command line arguments. Therefore a script could set the environment variables and call the executable with the appropriate parameters. However we go through the self-contained solution, which is a bit more complex but may seen as more clean.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
The pro file must be modified to link the PDL and SDL libs, and also to look for the Qt libraries at the right location at runtime. Here we assume that the Qt libs are in a subdirectory called 'qt' below the directory where the application is deployed. <br />
<br />
Modify fancybrowser.pro and add this at the end:<br />
<br />
<pre><br />
!win32: {<br />
message(assume qws)<br />
# Set the runtime path to a relative directory w.r.t. the location of the executable<br />
LIBS += -Wl,-rpath,"'\$$ORIGIN/qt'" -L/opt/PalmPDK/device/lib -lpdl -lSDL<br />
INCLUDEPATH += /opt/PalmPDK/include/SDL<br />
}<br />
</pre><br />
<br />
Note that '''!win32:{...}''' sets these parameters for any "non windows build" (I happen to build the desktop app on Windows and the WebOS app on Linux). Ideally we would rather have something for webos ('''webos:{...}''') but I did not investigate how to do enable that - if somebody knows, feel free to share.<br />
<br />
==== Modifications to the main file ====<br />
<br />
QApplication::GuiServer<br />
<br />
* The first thing <br />
<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
printf("font path: %s\n",fontpath.toStdString().c_str());<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii()))<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts"))<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"};<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:1"};<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
for(unsigned i=0;i<argc2;i++)<br />
{<br />
printf("%d: %s\n",i,argv2[i]);<br />
}<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer);<br />
//QApplication app(argc, argv);<br />
//QCustomApplication app(argc, argv);<br />
//QCustomApplication app(argc2, argv2,QApplication::GuiServer);<br />
<br />
#else<br />
#warning "No QWS, all OK"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
<br />
QUrl url;<br />
if (argc > 1)<br />
url = QUrl(argv[1]);<br />
else<br />
//url = QUrl("http://www.google.com/ncr");<br />
url = QUrl("http://www.slashdot.org");<br />
<br />
MainWindow *browser = new MainWindow(url);<br />
<br />
#if defined Q_OS_SYMBIAN || defined Q_WS_HILDON || defined Q_WS_MAEMO_5 || defined Q_WS_SIMULATOR || defined Q_WS_QWS<br />
browser->showMaximized();<br />
#else<br />
browser->show();<br />
#endif<br />
<br />
/*<br />
const int width = 640;<br />
const int height = 480;<br />
<br />
QGraphicsScene scene;<br />
<br />
QGraphicsView view(&scene);<br />
view.setFrameShape(QFrame::NoFrame);<br />
view.setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);<br />
view.setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);<br />
<br />
QGraphicsWebView webview;<br />
webview.resize(width, height);<br />
webview.load(QUrl("http://www.slashdot.org"));<br />
<br />
scene.addItem(&webview);<br />
<br />
view.resize(width, height);<br />
view.show();*/<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
<br />
=== 4.2 Qt-QML app ===<br />
<br />
=== 4.x deployment ===<br />
<br />
=== 4.x stuff ===<br />
* numbering of the qws stuff to avoid conflicts<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21621HowtoQt2012-02-08T14:01:09Z<p>DanRog: /* 4. Compiling Qt apps */</p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
* The reasonable development tools<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events. This step gets the WebOS Qt gfxdrivers plugin. <br />
<br />
The initial plugin version was written by Darron Black [1,2] and it uses SDL for graphics. With the changes in WebOS 2.x, that plugin doesn't work anymore: it uses root access to read the keyboard, but recent PDK apps are not running as root anymore but in jails. Therefore an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code]. It has also tentative support for screen rotation.<br />
<br />
# Cd to the Qt gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin from the svn repository: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Edit ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro to add the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# In order to support screen rotation we need to patch the "transformed" screen driver. This driver is provided by Qt to do screen rotation or offsetting and it uses as back-end the driver doing the actual access to the pixels (that would be our webos qgfxdrivers). Unfortunately the transformed driver doesn't allow to "notify" SDL when pixels are changed. A quick hack is to patch ~/qt-everywhere-opensource-src-4.8.0t/src/gui/embedded/qscreentransformed_qws.cpp. In this patch we hijack the functionality of the "blank" method (which is supposed to blank the screen) to notify the WebOS gfxdrivers before and after pixels are modified. So edit qscreentransformed_qws.cpp around lines 430 and add the two lines marked with the comments below:<br />
<br />
<pre><br />
.<br />
.<br />
.<br />
screen()->blank(true); // ADD THIS FOR WEBOS<br />
QWSDisplay::grab();<br />
for (int i = 0; i < rects.size(); ++i) {<br />
const QRect r = rects.at(i) & bound;<br />
<br />
QPoint dst;<br />
switch (trans) {<br />
case Rot90:<br />
dst = mapToDevice(r.topRight(), QSize(w, h));<br />
break;<br />
case Rot180:<br />
dst = mapToDevice(r.bottomRight(), QSize(w, h));<br />
break;<br />
case Rot270:<br />
dst = mapToDevice(r.bottomLeft(), QSize(w, h));<br />
break;<br />
default:<br />
break;<br />
}<br />
func(this, image, r.translated(-topLeft), dst);<br />
}<br />
QWSDisplay::ungrab();<br />
screen()->blank(false); // ADD THIS FOR WEBOS<br />
.<br />
.<br />
.<br />
</pre><br />
<br />
<br />
=== 3.4 Cross-compile ===<br />
<br />
<br />
Now we can configure and cross-compile Qt. The lines below configure Qt to install in ~/qte-48:<br />
<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0'''<br />
# '''./configure -v -prefix ~/qte-48 -embedded arm -platform qws/linux-x86-g++ -xplatform qws/linux-webos -depths 16,24,32 -no-multimedia -no-audio-backend -no-phonon -no-phonon-backend -no-nis -no-iconv -no-dbus -no-cups -no-largefile -no-accessibility -no-gtkstyle -no-qt3support -qt-gfx-vnc -plugin-gfx-vnc -no-glib -qtlibinfix 48 -xmlpatterns -exceptions -opensource -make libs -nomake tools -nomake demo -nomake examples -nomake docs -webkit -javascript-jit -script -scripttools -declarative -openssl -qt-gfx-transformed'''<br />
# '''make -j4'''<br />
# '''make install'''<br />
<br />
NEED TO COMPILE WEBOS manually<br />
# cd<br />
# make<br />
# make install<br />
-------------------<br />
<br />
Hopefully you've made it so far without problems! You now have Qt in ~/qte-48.<br />
<br />
<br />
== 4. Compiling Qt apps ==<br />
<br />
We see here how to compile a Qt app for Qt on WebOS. We look at two examples that are directly taken from the Qt distribution: <br />
# fancybrowser: this is a Qt-widget-based example browser. It is available in QTSDKDIR/Examples/4.8/webkit/fancybrowser<br />
# webbrowser: this is a Qt-QML-based example browser. It is available in QTSDKDRIR/Demos/4.8/declarative/webbrowser<br />
<br />
The way compilation of the apps is mostly identical, but the QML-based project has a few extra complexities so we'll see first the widget-based project.<br />
<br />
=== 4.1 Qt-widget app ===<br />
<br />
We assume a copy of QTSDKDIR/Examples/4.8/webkit/fancybrowser in your working directory, e.g. ~/fancybrowser<br />
<br />
Two things must be modified in the project: <br />
* fancybrowser.pro: this is the project file, it must be modified to include the proper libraries<br />
* main.cpp: this is the file in which the QApplication object is instanciated. We must do some setup to indicate to the application:<br />
** where to find system fonts, <br />
** to start the application as a GUI server application<br />
** to use the WebOS gfxdrivers plugin, or to use the transformed gfxdrivers plugin in combination with the WebOS gfxdrivers plugin to support screen rotation.<br />
<br />
Note that one could avoid modifying main.cpp altogether because the same results can be achieved by environment variables and by command line arguments. Therefore a script could set the environment variables and call the executable with the appropriate parameters. However we go through the self-contained solution, which is a bit more complex but may seen as more clean.<br />
<br />
==== Modifications to the .pro file ====<br />
<br />
The pro file must be modified to link the PDL and SDL libs, and also to look for the Qt libraries at the right location at runtime. Here we assume that the Qt libs are in a subdirectory called 'qt' below the directory where the application is deployed. <br />
<br />
Modify fancybrowser.pro and add this at the end:<br />
<br />
<pre><br />
!win32: {<br />
message(assume qws)<br />
# Set the runtime path to a relative directory w.r.t. the location of the executable<br />
LIBS += -Wl,-rpath,"'\$$ORIGIN/qt'" -L/opt/PalmPDK/device/lib -lpdl -lSDL<br />
INCLUDEPATH += /opt/PalmPDK/include/SDL<br />
}<br />
</pre><br />
<br />
==== Modifications to the main file ====<br />
<br />
QApplication::GuiServer<br />
<br />
* The first thing <br />
<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
printf("font path: %s\n",fontpath.toStdString().c_str());<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii()))<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts"))<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"};<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:1"};<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
for(unsigned i=0;i<argc2;i++)<br />
{<br />
printf("%d: %s\n",i,argv2[i]);<br />
}<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer);<br />
//QApplication app(argc, argv);<br />
//QCustomApplication app(argc, argv);<br />
//QCustomApplication app(argc2, argv2,QApplication::GuiServer);<br />
<br />
#else<br />
#warning "No QWS, all OK"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
<br />
QUrl url;<br />
if (argc > 1)<br />
url = QUrl(argv[1]);<br />
else<br />
//url = QUrl("http://www.google.com/ncr");<br />
url = QUrl("http://www.slashdot.org");<br />
<br />
MainWindow *browser = new MainWindow(url);<br />
<br />
#if defined Q_OS_SYMBIAN || defined Q_WS_HILDON || defined Q_WS_MAEMO_5 || defined Q_WS_SIMULATOR || defined Q_WS_QWS<br />
browser->showMaximized();<br />
#else<br />
browser->show();<br />
#endif<br />
<br />
/*<br />
const int width = 640;<br />
const int height = 480;<br />
<br />
QGraphicsScene scene;<br />
<br />
QGraphicsView view(&scene);<br />
view.setFrameShape(QFrame::NoFrame);<br />
view.setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);<br />
view.setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);<br />
<br />
QGraphicsWebView webview;<br />
webview.resize(width, height);<br />
webview.load(QUrl("http://www.slashdot.org"));<br />
<br />
scene.addItem(&webview);<br />
<br />
view.resize(width, height);<br />
view.show();*/<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
<br />
=== 4.2 Qt-QML app ===<br />
<br />
=== 4.x deployment ===<br />
<br />
=== 4.x stuff ===<br />
* numbering of the qws stuff to avoid conflicts<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21619HowtoQt2012-02-08T13:55:29Z<p>DanRog: /* 4. Compiling Qt apps */</p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
* The reasonable development tools<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events. This step gets the WebOS Qt gfxdrivers plugin. <br />
<br />
The initial plugin version was written by Darron Black [1,2] and it uses SDL for graphics. With the changes in WebOS 2.x, that plugin doesn't work anymore: it uses root access to read the keyboard, but recent PDK apps are not running as root anymore but in jails. Therefore an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code]. It has also tentative support for screen rotation.<br />
<br />
# Cd to the Qt gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin from the svn repository: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Edit ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro to add the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# In order to support screen rotation we need to patch the "transformed" screen driver. This driver is provided by Qt to do screen rotation or offsetting and it uses as back-end the driver doing the actual access to the pixels (that would be our webos qgfxdrivers). Unfortunately the transformed driver doesn't allow to "notify" SDL when pixels are changed. A quick hack is to patch ~/qt-everywhere-opensource-src-4.8.0t/src/gui/embedded/qscreentransformed_qws.cpp. In this patch we hijack the functionality of the "blank" method (which is supposed to blank the screen) to notify the WebOS gfxdrivers before and after pixels are modified. So edit qscreentransformed_qws.cpp around lines 430 and add the two lines marked with the comments below:<br />
<br />
<pre><br />
.<br />
.<br />
.<br />
screen()->blank(true); // ADD THIS FOR WEBOS<br />
QWSDisplay::grab();<br />
for (int i = 0; i < rects.size(); ++i) {<br />
const QRect r = rects.at(i) & bound;<br />
<br />
QPoint dst;<br />
switch (trans) {<br />
case Rot90:<br />
dst = mapToDevice(r.topRight(), QSize(w, h));<br />
break;<br />
case Rot180:<br />
dst = mapToDevice(r.bottomRight(), QSize(w, h));<br />
break;<br />
case Rot270:<br />
dst = mapToDevice(r.bottomLeft(), QSize(w, h));<br />
break;<br />
default:<br />
break;<br />
}<br />
func(this, image, r.translated(-topLeft), dst);<br />
}<br />
QWSDisplay::ungrab();<br />
screen()->blank(false); // ADD THIS FOR WEBOS<br />
.<br />
.<br />
.<br />
</pre><br />
<br />
<br />
=== 3.4 Cross-compile ===<br />
<br />
<br />
Now we can configure and cross-compile Qt. The lines below configure Qt to install in ~/qte-48:<br />
<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0'''<br />
# '''./configure -v -prefix ~/qte-48 -embedded arm -platform qws/linux-x86-g++ -xplatform qws/linux-webos -depths 16,24,32 -no-multimedia -no-audio-backend -no-phonon -no-phonon-backend -no-nis -no-iconv -no-dbus -no-cups -no-largefile -no-accessibility -no-gtkstyle -no-qt3support -qt-gfx-vnc -plugin-gfx-vnc -no-glib -qtlibinfix 48 -xmlpatterns -exceptions -opensource -make libs -nomake tools -nomake demo -nomake examples -nomake docs -webkit -javascript-jit -script -scripttools -declarative -openssl -qt-gfx-transformed'''<br />
# '''make -j4'''<br />
# '''make install'''<br />
<br />
NEED TO COMPILE WEBOS manually<br />
# cd<br />
# make<br />
# make install<br />
-------------------<br />
<br />
Hopefully you've made it so far without problems! You now have Qt in ~/qte-48.<br />
<br />
<br />
== 4. Compiling Qt apps ==<br />
<br />
We see here how to compile a Qt app for Qt on WebOS. We look at two examples that are directly taken from the Qt distribution: <br />
# fancybrowser: this is a Qt-widget-based example browser. It is available in QTSDKDIR/Examples/4.8/webkit/fancybrowser<br />
# webbrowser: this is a Qt-QML-based example browser. It is available in QTSDKDRIR/Demos/4.8/declarative/webbrowser<br />
<br />
The way compilation of the apps is mostly identical, but the QML-based project has a few extra complexities so we'll see first the widget-based project.<br />
<br />
=== 4.1 Qt-widget app ===<br />
<br />
We assume a copy of QTSDKDIR/Examples/4.8/webkit/fancybrowser in your working directory, e.g. ~/fancybrowser<br />
<br />
Two things must be modified in the project: <br />
* fancybrowser.pro: this is the project file, it must be modified to include the proper libraries<br />
* main.cpp: this is the file in which the QApplication object is instanciated. We must do some setup to indicate to the application:<br />
** where to find system fonts, <br />
** to start the application as a GUI server application<br />
** to use the WebOS gfxdrivers plugin, or to use the transformed gfxdrivers plugin in combination with the WebOS gfxdrivers plugin to support screen rotation.<br />
<br />
Note that one could avoid modifying main.cpp altogether because these settings can be achieved by environment variables and by command line arguments. Therefore a script could set the environment variables and call the executable with the appropriate parameters. However we go through the self-contained solution, which may be a little bit more complex but is also more clean.<br />
<br />
<br />
QApplication::GuiServer<br />
<br />
* The first thing <br />
<br />
<br />
<pre><br />
int main(int argc, char * argv[])<br />
{<br />
int rv;<br />
<br />
#ifdef Q_WS_QWS<br />
#warning "Hacks for QWS"<br />
// ------------------------------------------------------------------------<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// Get the path to the exe...<br />
// Ideally we should use QApplication::applicationDirPath, but instanciating that<br />
// one attempts to load the fonts... which aren't defined yet<br />
char pathexe[1024];<br />
rv = readlink("/proc/self/exe", pathexe, sizeof(pathexe));<br />
if(!(rv>0 && rv<sizeof(pathexe)))<br />
{<br />
printf("Couldn't get the exe path - terminating\n");<br />
return -1;<br />
}<br />
pathexe[rv]=0;<br />
printf("path to exe: %s\n",pathexe);<br />
*strrchr(pathexe,'/')=0; // Eliminate the application name<br />
QString fontpath = QString(pathexe)+"/fonts";<br />
printf("font path: %s\n",fontpath.toStdString().c_str());<br />
//if(!qputenv("QT_QWS_FONTDIR",fontpath.toAscii()))<br />
if(!qputenv("QT_QWS_FONTDIR","/usr/share/fonts"))<br />
{<br />
printf("Can't set font path");<br />
}<br />
//<br />
// FONT SETUP FONT SETUP FONT SETUP FONT SETUP FONT SETUP<br />
// ------------------------------------------------------------------------<br />
<br />
// Hack setting the the display driver<br />
int argc2 = argc+2;<br />
char **argv2 = new char*[argc2];<br />
for(int i=0;i<argc;i++)<br />
{<br />
argv2[i] = new char[strlen(argv[i])+1];<br />
strcpy(argv2[i],argv[i]);<br />
}<br />
//char *display[]={"-display","PalmPreSDLFb:100"};<br />
char *display[]={"-display","Transformed:PalmPreSDLFb:1"};<br />
argv2[argc] = display[0];<br />
argv2[argc+1] = display[1];<br />
for(unsigned i=0;i<argc2;i++)<br />
{<br />
printf("%d: %s\n",i,argv2[i]);<br />
}<br />
<br />
// QApplication::GuiServer is akin to passing -qws on the command line<br />
// Passes argv2 / argc2 which stays alive for the entire duration of QApplication<br />
QApplication app(argc2, argv2,QApplication::GuiServer);<br />
//QApplication app(argc, argv);<br />
//QCustomApplication app(argc, argv);<br />
//QCustomApplication app(argc2, argv2,QApplication::GuiServer);<br />
<br />
#else<br />
#warning "No QWS, all OK"<br />
QApplication app(argc, argv,QApplication::GuiServer);<br />
#endif<br />
<br />
<br />
QUrl url;<br />
if (argc > 1)<br />
url = QUrl(argv[1]);<br />
else<br />
//url = QUrl("http://www.google.com/ncr");<br />
url = QUrl("http://www.slashdot.org");<br />
<br />
MainWindow *browser = new MainWindow(url);<br />
<br />
#if defined Q_OS_SYMBIAN || defined Q_WS_HILDON || defined Q_WS_MAEMO_5 || defined Q_WS_SIMULATOR || defined Q_WS_QWS<br />
browser->showMaximized();<br />
#else<br />
browser->show();<br />
#endif<br />
<br />
/*<br />
const int width = 640;<br />
const int height = 480;<br />
<br />
QGraphicsScene scene;<br />
<br />
QGraphicsView view(&scene);<br />
view.setFrameShape(QFrame::NoFrame);<br />
view.setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);<br />
view.setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);<br />
<br />
QGraphicsWebView webview;<br />
webview.resize(width, height);<br />
webview.load(QUrl("http://www.slashdot.org"));<br />
<br />
scene.addItem(&webview);<br />
<br />
view.resize(width, height);<br />
view.show();*/<br />
<br />
rv = app.exec();<br />
return rv;<br />
<br />
}<br />
</pre><br />
<br />
<br />
=== 4.2 Qt-QML app ===<br />
<br />
=== 4.x deployment ===<br />
<br />
=== 4.x stuff ===<br />
* numbering of the qws stuff to avoid conflicts<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21617HowtoQt2012-02-08T13:43:33Z<p>DanRog: /* 4. Compiling Qt apps */</p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
* The reasonable development tools<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events. This step gets the WebOS Qt gfxdrivers plugin. <br />
<br />
The initial plugin version was written by Darron Black [1,2] and it uses SDL for graphics. With the changes in WebOS 2.x, that plugin doesn't work anymore: it uses root access to read the keyboard, but recent PDK apps are not running as root anymore but in jails. Therefore an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code]. It has also tentative support for screen rotation.<br />
<br />
# Cd to the Qt gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin from the svn repository: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Edit ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro to add the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# In order to support screen rotation we need to patch the "transformed" screen driver. This driver is provided by Qt to do screen rotation or offsetting and it uses as back-end the driver doing the actual access to the pixels (that would be our webos qgfxdrivers). Unfortunately the transformed driver doesn't allow to "notify" SDL when pixels are changed. A quick hack is to patch ~/qt-everywhere-opensource-src-4.8.0t/src/gui/embedded/qscreentransformed_qws.cpp. In this patch we hijack the functionality of the "blank" method (which is supposed to blank the screen) to notify the WebOS gfxdrivers before and after pixels are modified. So edit qscreentransformed_qws.cpp around lines 430 and add the two lines marked with the comments below:<br />
<br />
<pre><br />
.<br />
.<br />
.<br />
screen()->blank(true); // ADD THIS FOR WEBOS<br />
QWSDisplay::grab();<br />
for (int i = 0; i < rects.size(); ++i) {<br />
const QRect r = rects.at(i) & bound;<br />
<br />
QPoint dst;<br />
switch (trans) {<br />
case Rot90:<br />
dst = mapToDevice(r.topRight(), QSize(w, h));<br />
break;<br />
case Rot180:<br />
dst = mapToDevice(r.bottomRight(), QSize(w, h));<br />
break;<br />
case Rot270:<br />
dst = mapToDevice(r.bottomLeft(), QSize(w, h));<br />
break;<br />
default:<br />
break;<br />
}<br />
func(this, image, r.translated(-topLeft), dst);<br />
}<br />
QWSDisplay::ungrab();<br />
screen()->blank(false); // ADD THIS FOR WEBOS<br />
.<br />
.<br />
.<br />
</pre><br />
<br />
<br />
=== 3.4 Cross-compile ===<br />
<br />
<br />
Now we can configure and cross-compile Qt. The lines below configure Qt to install in ~/qte-48:<br />
<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0'''<br />
# '''./configure -v -prefix ~/qte-48 -embedded arm -platform qws/linux-x86-g++ -xplatform qws/linux-webos -depths 16,24,32 -no-multimedia -no-audio-backend -no-phonon -no-phonon-backend -no-nis -no-iconv -no-dbus -no-cups -no-largefile -no-accessibility -no-gtkstyle -no-qt3support -qt-gfx-vnc -plugin-gfx-vnc -no-glib -qtlibinfix 48 -xmlpatterns -exceptions -opensource -make libs -nomake tools -nomake demo -nomake examples -nomake docs -webkit -javascript-jit -script -scripttools -declarative -openssl -qt-gfx-transformed'''<br />
# '''make -j4'''<br />
# '''make install'''<br />
<br />
NEED TO COMPILE WEBOS manually<br />
# cd<br />
# make<br />
# make install<br />
-------------------<br />
<br />
Hopefully you've made it so far without problems! You now have Qt in ~/qte-48.<br />
<br />
<br />
== 4. Compiling Qt apps ==<br />
<br />
We see here how to compile a Qt app for Qt on WebOS. We look at two examples that are directly taken from the Qt distribution: <br />
# fancybrowser: this is a Qt-widget-based example browser. It is available in QTSDKDIR/Examples/4.8/webkit/fancybrowser<br />
# webbrowser: this is a Qt-QML-based example browser. It is available in QTSDKDRIR/Demos/4.8/declarative/webbrowser<br />
<br />
=== 4.1 Compiling Qt apps ===<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21607HowtoQt2012-02-07T22:18:01Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
* The reasonable development tools<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events. This step gets the WebOS Qt gfxdrivers plugin. <br />
<br />
The initial plugin version was written by Darron Black [1,2] and it uses SDL for graphics. With the changes in WebOS 2.x, that plugin doesn't work anymore: it uses root access to read the keyboard, but recent PDK apps are not running as root anymore but in jails. Therefore an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code]. It has also tentative support for screen rotation.<br />
<br />
# Cd to the Qt gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin from the svn repository: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Edit ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro to add the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# In order to support screen rotation we need to patch the "transformed" screen driver. This driver is provided by Qt to do screen rotation or offsetting and it uses as back-end the driver doing the actual access to the pixels (that would be our webos qgfxdrivers). Unfortunately the transformed driver doesn't allow to "notify" SDL when pixels are changed. A quick hack is to patch ~/qt-everywhere-opensource-src-4.8.0t/src/gui/embedded/qscreentransformed_qws.cpp. In this patch we hijack the functionality of the "blank" method (which is supposed to blank the screen) to notify the WebOS gfxdrivers before and after pixels are modified. So edit qscreentransformed_qws.cpp around lines 430 and add the two lines marked with the comments below:<br />
<br />
<pre><br />
.<br />
.<br />
.<br />
screen()->blank(true); // ADD THIS FOR WEBOS<br />
QWSDisplay::grab();<br />
for (int i = 0; i < rects.size(); ++i) {<br />
const QRect r = rects.at(i) & bound;<br />
<br />
QPoint dst;<br />
switch (trans) {<br />
case Rot90:<br />
dst = mapToDevice(r.topRight(), QSize(w, h));<br />
break;<br />
case Rot180:<br />
dst = mapToDevice(r.bottomRight(), QSize(w, h));<br />
break;<br />
case Rot270:<br />
dst = mapToDevice(r.bottomLeft(), QSize(w, h));<br />
break;<br />
default:<br />
break;<br />
}<br />
func(this, image, r.translated(-topLeft), dst);<br />
}<br />
QWSDisplay::ungrab();<br />
screen()->blank(false); // ADD THIS FOR WEBOS<br />
.<br />
.<br />
.<br />
</pre><br />
<br />
<br />
=== 3.4 Cross-compile ===<br />
<br />
<br />
Now we can configure and cross-compile Qt. The lines below configure Qt to install in ~/qte-48:<br />
<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0'''<br />
# '''./configure -v -prefix ~/qte-48 -embedded arm -platform qws/linux-x86-g++ -xplatform qws/linux-webos -depths 16,24,32 -no-multimedia -no-audio-backend -no-phonon -no-phonon-backend -no-nis -no-iconv -no-dbus -no-cups -no-largefile -no-accessibility -no-gtkstyle -no-qt3support -qt-gfx-vnc -plugin-gfx-vnc -no-glib -qtlibinfix 48 -xmlpatterns -exceptions -opensource -make libs -nomake tools -nomake demo -nomake examples -nomake docs -webkit -javascript-jit -script -scripttools -declarative -openssl -qt-gfx-transformed'''<br />
# '''make -j4'''<br />
# '''make install'''<br />
<br />
NEED TO COMPILE WEBOS manually<br />
# cd<br />
# make<br />
# make install<br />
-------------------<br />
<br />
Hopefully you've made it so far without problems! You now have Qt in ~/qte-48.<br />
<br />
<br />
== 4. Compiling Qt apps ==<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21605HowtoQt2012-02-07T22:13:56Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
* The reasonable development tools<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events. This step gets the WebOS Qt gfxdrivers plugin. <br />
<br />
The initial plugin version was written by Darron Black [1,2] and it uses SDL for graphics. With the changes in WebOS 2.x, that plugin doesn't work anymore: it uses root access to read the keyboard, but recent PDK apps are not running as root anymore but in jails. Therefore an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code]. It has also tentative support for screen rotation.<br />
<br />
# Cd to the Qt gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin from the svn repository: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Edit ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro to add the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# In order to support screen rotation we need to patch the "transformed" screen driver. This driver is provided by Qt to do screen rotation or offsetting and it uses as back-end the driver doing the actual access to the pixels (that would be our webos qgfxdrivers). Unfortunately the transformed driver doesn't allow to "notify" SDL when pixels are changed. A quick hack is to patch ~/qt-everywhere-opensource-src-4.8.0t/src/gui/embedded/qscreentransformed_qws.cpp. In this patch we hijack the functionality of the "blank" method (which is supposed to blank the screen) to notify the WebOS gfxdrivers before and after pixels are modified. So edit qscreentransformed_qws.cpp around lines 430 and add the two lines marked with the comments below:<br />
<br />
<pre><br />
.<br />
.<br />
.<br />
screen()->blank(true); // ADD THIS FOR WEBOS<br />
QWSDisplay::grab();<br />
for (int i = 0; i < rects.size(); ++i) {<br />
const QRect r = rects.at(i) & bound;<br />
<br />
QPoint dst;<br />
switch (trans) {<br />
case Rot90:<br />
dst = mapToDevice(r.topRight(), QSize(w, h));<br />
break;<br />
case Rot180:<br />
dst = mapToDevice(r.bottomRight(), QSize(w, h));<br />
break;<br />
case Rot270:<br />
dst = mapToDevice(r.bottomLeft(), QSize(w, h));<br />
break;<br />
default:<br />
break;<br />
}<br />
func(this, image, r.translated(-topLeft), dst);<br />
}<br />
QWSDisplay::ungrab();<br />
screen()->blank(false); // ADD THIS FOR WEBOS<br />
.<br />
.<br />
.<br />
</pre><br />
<br />
<br />
=== 3.4 Cross-compile ===<br />
<br />
<br />
Now we can configure and cross-compile Qt. The lines below configure Qt to install in ~/qte-48:<br />
<br />
# '''cd ~/qt-everywhere-opensource-src-4.8.0'''<br />
# '''./configure -v -prefix ~/qte-48 -embedded arm -platform qws/linux-x86-g++ -xplatform qws/linux-webos -depths 16,24,32 -no-multimedia -no-audio-backend -no-phonon -no-phonon-backend -no-nis -no-iconv -no-dbus -no-cups -no-largefile -no-accessibility -no-gtkstyle -no-qt3support -qt-gfx-vnc -plugin-gfx-vnc -no-glib -qtlibinfix 48 -xmlpatterns -exceptions -opensource -make libs -nomake tools -nomake demo -nomake examples -nomake docs -webkit -javascript-jit -script -scripttools -declarative -openssl -qt-gfx-transformed'''<br />
# '''make -j4'''<br />
# '''make install'''<br />
<br />
Hopefully you've made it so far without problems! You now have Qt in ~/qte-48.<br />
<br />
<br />
== 4. Compiling Qt apps ==<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21603HowtoQt2012-02-07T22:08:21Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
* The reasonable development tools<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events. This step gets the WebOS Qt gfxdrivers plugin. <br />
<br />
The initial plugin version was written by Darron Black [1,2] and it uses SDL for graphics. With the changes in WebOS 2.x, that plugin doesn't work anymore: it uses root access to read the keyboard, but recent PDK apps are not running as root anymore but in jails. Therefore an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code]. It has also tentative support for screen rotation.<br />
<br />
# Cd to the Qt gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin from the svn repository: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Edit ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro to add the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# In order to support screen rotation we need to patch the "transformed" screen driver. This driver is provided by Qt to do screen rotation or offsetting and it uses as back-end the driver doing the actual access to the pixels (that would be our webos qgfxdrivers). Unfortunately the transformed driver doesn't allow to "notify" SDL when pixels are changed. A quick hack is to patch ~/qt-everywhere-opensource-src-4.8.0t/src/gui/embedded/qscreentransformed_qws.cpp. In this patch we hijack the functionality of the "blank" method (which is supposed to blank the screen) to notify the WebOS gfxdrivers before and after pixels are modified. So edit qscreentransformed_qws.cpp around lines 430 and add the two lines marked with the comments below:<br />
<br />
<pre><br />
.<br />
.<br />
.<br />
screen()->blank(true); // ADD THIS FOR WEBOS<br />
QWSDisplay::grab();<br />
for (int i = 0; i < rects.size(); ++i) {<br />
const QRect r = rects.at(i) & bound;<br />
<br />
QPoint dst;<br />
switch (trans) {<br />
case Rot90:<br />
dst = mapToDevice(r.topRight(), QSize(w, h));<br />
break;<br />
case Rot180:<br />
dst = mapToDevice(r.bottomRight(), QSize(w, h));<br />
break;<br />
case Rot270:<br />
dst = mapToDevice(r.bottomLeft(), QSize(w, h));<br />
break;<br />
default:<br />
break;<br />
}<br />
func(this, image, r.translated(-topLeft), dst);<br />
}<br />
QWSDisplay::ungrab();<br />
screen()->blank(false); // ADD THIS FOR WEBOS<br />
.<br />
.<br />
.<br />
</pre><br />
<br />
<br />
<br />
---------------------- patch transformed driver<br />
<br />
<br />
<br />
<br />
To do:<br />
# V Get and untar the source<br />
# Set-up the mkspecs<br />
# Get the webos plugins/gfxdrivers -> credit original author -> link to the updated version<br />
# modify the build stuff<br />
# patch the transformed driver (?)<br />
# ./configure command line<br />
# make make install<br />
# something on what's the outcome<br />
<br />
=== 3.x WebOS gfxdrivers ===<br />
<br />
== 4. apps ==<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21601HowtoQt2012-02-07T21:54:44Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
=== 3.1 Get the Qt sources ===<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
=== 3.2 Qt mkspecs for WebOS ===<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
<br />
=== 3.3 gfxdrivers plugin for WebOS ===<br />
<br />
Qt embedded needs a gfxdrivers plugin which allows Qt to show things on a screen, get keyboard input and mouse events.<br />
<br />
<br />
This step gets the WebOS Qt gfxdrivers plugin. The initial plugin version was written by Darron Black [1,2]. With the changes in WebOS 2.x an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code].<br />
<br />
# Cd to the gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Add to ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# ---------------------- patch transformed driver<br />
<br />
<br />
<br />
<br />
To do:<br />
# V Get and untar the source<br />
# Set-up the mkspecs<br />
# Get the webos plugins/gfxdrivers -> credit original author -> link to the updated version<br />
# modify the build stuff<br />
# patch the transformed driver (?)<br />
# ./configure command line<br />
# make make install<br />
# something on what's the outcome<br />
<br />
=== 3.x WebOS gfxdrivers ===<br />
<br />
== 4. apps ==<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21599HowtoQt2012-02-07T21:52:12Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. <br />
<br />
Without these includes, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
You're set!<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources, and sets-up Qt for cross-compilation using the Palm PDK.<br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''. This file must look like this:<br />
<br />
<br />
<pre> <br />
#<br />
# qmake configuration for WebOS builds with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
<br />
GCCBASE = /opt/PalmPDK/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK/include<br />
TSLIB_LIBDIR = /opt/PalmPDK/device/lib<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
You're set.<br />
<br />
<br />
<br />
<br />
To do:<br />
# V Get and untar the source<br />
# Set-up the mkspecs<br />
# Get the webos plugins/gfxdrivers -> credit original author -> link to the updated version<br />
# modify the build stuff<br />
# patch the transformed driver (?)<br />
# ./configure command line<br />
# make make install<br />
# something on what's the outcome<br />
<br />
=== 3.x WebOS gfxdrivers ===<br />
<br />
This step gets the WebOS Qt gfxdrivers plugin. The initial plugin version was written by Darron Black [1,2]. With the changes in WebOS 2.x an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code].<br />
<br />
# Cd to the gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Add to ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# ---------------------- patch transformed driver<br />
<br />
== 4. apps ==<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21597HowtoQt2012-02-07T21:48:33Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file - '''/opt/PalmPDK/include/asm/hwcap.h''' (actually more includes in the /opt/PalmPDK/include/asm directory are needed) - to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. Without this file, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include files. These files can be found in the CodeSourcery arm toolchain.<br />
<br />
# Download the arm toolchain "Sourcery G++ Lite 2009q3-67 for ARM GNU/Linux" from [http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/arm-gnu-linux Mentor Graphics' website]. You need to register to download, but it's free. Make sure you get the ARM GNU/Linux Release (not the ARM EABI release!). The file you get should be called arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2<br />
# Untar this file: '''tar xvfj arm-2009q3-67-arm-none-linux-gnueabi-i686-pc-linux-gnu.tar.bz2'''<br />
# Copy the entire include/asm directory to the PalmPDK: '''cp -r arm-2009q3/arm-none-linux-gnueabi/libc/usr/include/asm /opt/PalmPDK/include'''<br />
<br />
<br />
<br />
* Need to check name<br />
* code sourcery's toolchain<br />
* which file where<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources. <br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''<br />
# <br />
<br />
<pre> <br />
#<br />
# qmake configuration for building with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
#GCCBASE = /opt/PalmPDK.441/arm-gcc/bin<br />
<br />
GCCBASE = /opt/PalmPDK.palm/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK.palm/include<br />
TSLIB_LIBDIR = /opt/PalmPDK.palm/device/lib<br />
<br />
<br />
#TSLIB_INCDIR += $$GCCBASE<br />
#TSLIB_INCDIR += /opt/PalmPDK.palm/arm-gcc/sysroot/usr/include<br />
<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
#QMAKE_CFLAGS_RELEASE = -O3 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CFLAGS_RELEASE = -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize -ffast-math -fsingle-precision-constant<br />
<br />
# ok below<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# Not ok on 4.3.3: mix of vfp and hard<br />
#QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=hard -ftree-vectorize <br />
<br />
#QMAKE_CFLAGS_RELEASE = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp <br />
#QMAKE_CXXFLAGS_RELEASE = -O3 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CXXFLAGS_RELEASE = -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize -ffast-math -fsingle-precision-constant<br />
<br />
# ok below<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# Not ok on 4.3.3: mix of vfp and hard<br />
#QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=hard -ftree-vectorize <br />
<br />
#QMAKE_CXXFLAGS_RELEASE = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
#QMAKE_LINK = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-g++<br />
#QMAKE_LINK_SHLIB = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-g++<br />
#QMAKE_RANLIB = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
#QMAKE_AR = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-ar cqs<br />
#QMAKE_OBJCOPY = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-objcopy<br />
#QMAKE_STRIP = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-strip<br />
<br />
<br />
#QMAKE_CFLAGS_RELEASE += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
#QMAKE_CXXFLAGS_RELEASE += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
<br />
#QMAKE_CFLAGS_DEBUG += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
#QMAKE_CXXFLAGS_DEBUG += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
#QMAKE_LFLAGS += -Wl,--allow-shlib-undefined --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
To do:<br />
# V Get and untar the source<br />
# Set-up the mkspecs<br />
# Get the webos plugins/gfxdrivers -> credit original author -> link to the updated version<br />
# modify the build stuff<br />
# patch the transformed driver (?)<br />
# ./configure command line<br />
# make make install<br />
# something on what's the outcome<br />
<br />
=== 3.x WebOS gfxdrivers ===<br />
<br />
This step gets the WebOS Qt gfxdrivers plugin. The initial plugin version was written by Darron Black [1,2]. With the changes in WebOS 2.x an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code].<br />
<br />
# Cd to the gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Add to ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# ---------------------- patch transformed driver<br />
<br />
== 4. apps ==<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21595HowtoQt2012-02-07T21:15:08Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes:<br />
* a Linux development environment (here Kubuntu 11.10 running in virtualbox on a win7 host)<br />
* Qt 4.8 (the process for Qt 4.7.x is mostly identical; no idea for Qt 5)<br />
* OpenSSH running on the webos device to scp files to it<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
<br />
You may check that all is fine so far (or skip this - this is simply to step-by-step see if all is ok):<br />
# You can invoke gcc or g++ from the PDK arm toolchain to compile some test program. E.g. '''/opt/PalmPDK/arm-gcc/bin/arm-none-linux-gnueabi-g++ hello.cpp -o hello'''<br />
# You can copy this file to the usb drive on the device: '''scp hello root@ip.address.of.device:/media/internal'''<br />
# You can go log on the device with novaterm: '''novaterm'''<br />
# You can run your test program: '''/media/internal/hello'''<br />
<br />
If that works then on to the next steps.<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. Without this file, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include file.<br />
<br />
* Need to check name<br />
* code sourcery's toolchain<br />
* which file where<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources. <br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''<br />
# <br />
<br />
<pre> <br />
#<br />
# qmake configuration for building with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
#GCCBASE = /opt/PalmPDK.441/arm-gcc/bin<br />
<br />
GCCBASE = /opt/PalmPDK.palm/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK.palm/include<br />
TSLIB_LIBDIR = /opt/PalmPDK.palm/device/lib<br />
<br />
<br />
#TSLIB_INCDIR += $$GCCBASE<br />
#TSLIB_INCDIR += /opt/PalmPDK.palm/arm-gcc/sysroot/usr/include<br />
<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
#QMAKE_CFLAGS_RELEASE = -O3 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CFLAGS_RELEASE = -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize -ffast-math -fsingle-precision-constant<br />
<br />
# ok below<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# Not ok on 4.3.3: mix of vfp and hard<br />
#QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=hard -ftree-vectorize <br />
<br />
#QMAKE_CFLAGS_RELEASE = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp <br />
#QMAKE_CXXFLAGS_RELEASE = -O3 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CXXFLAGS_RELEASE = -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize -ffast-math -fsingle-precision-constant<br />
<br />
# ok below<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# Not ok on 4.3.3: mix of vfp and hard<br />
#QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=hard -ftree-vectorize <br />
<br />
#QMAKE_CXXFLAGS_RELEASE = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
#QMAKE_LINK = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-g++<br />
#QMAKE_LINK_SHLIB = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-g++<br />
#QMAKE_RANLIB = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
#QMAKE_AR = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-ar cqs<br />
#QMAKE_OBJCOPY = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-objcopy<br />
#QMAKE_STRIP = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-strip<br />
<br />
<br />
#QMAKE_CFLAGS_RELEASE += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
#QMAKE_CXXFLAGS_RELEASE += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
<br />
#QMAKE_CFLAGS_DEBUG += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
#QMAKE_CXXFLAGS_DEBUG += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
#QMAKE_LFLAGS += -Wl,--allow-shlib-undefined --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
To do:<br />
# V Get and untar the source<br />
# Set-up the mkspecs<br />
# Get the webos plugins/gfxdrivers -> credit original author -> link to the updated version<br />
# modify the build stuff<br />
# patch the transformed driver (?)<br />
# ./configure command line<br />
# make make install<br />
# something on what's the outcome<br />
<br />
=== 3.x WebOS gfxdrivers ===<br />
<br />
This step gets the WebOS Qt gfxdrivers plugin. The initial plugin version was written by Darron Black [1,2]. With the changes in WebOS 2.x an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code].<br />
<br />
# Cd to the gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Add to ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# ---------------------- patch transformed driver<br />
<br />
== 4. apps ==<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21585HowtoQt2012-02-05T23:34:56Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes a Linux development environment, and Qt 4.8. The process for Qt 4.7.x is identical; no idea for Qt 5.<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
# You may check that all is fine<br />
## You can invoke gcc or g++ from the PDK arm toolchain to compile some "hello world" test program. E.g. /opt/PalmPDK/??????????<br />
## novaterm.....????????<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. Without this file, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include file.<br />
<br />
* Need to check name<br />
* code sourcery's toolchain<br />
* which file where<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources. <br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are mostly the same as the linux-arm-gnueabi-g++ mkspecs. So we copy them and modify them afterwards: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# Edit the linux-webos mkspecs to set-up the cross-compiler path and other build parameters. E.g. '''vi ~/~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws/linux-webos/qmake.conf'''<br />
# <br />
<br />
<pre> <br />
#<br />
# qmake configuration for building with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
#GCCBASE = /opt/PalmPDK.441/arm-gcc/bin<br />
<br />
GCCBASE = /opt/PalmPDK.palm/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK.palm/include<br />
TSLIB_LIBDIR = /opt/PalmPDK.palm/device/lib<br />
<br />
<br />
#TSLIB_INCDIR += $$GCCBASE<br />
#TSLIB_INCDIR += /opt/PalmPDK.palm/arm-gcc/sysroot/usr/include<br />
<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
#QMAKE_CFLAGS_RELEASE = -O3 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CFLAGS_RELEASE = -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize -ffast-math -fsingle-precision-constant<br />
<br />
# ok below<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# Not ok on 4.3.3: mix of vfp and hard<br />
#QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=hard -ftree-vectorize <br />
<br />
#QMAKE_CFLAGS_RELEASE = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp <br />
#QMAKE_CXXFLAGS_RELEASE = -O3 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CXXFLAGS_RELEASE = -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize -ffast-math -fsingle-precision-constant<br />
<br />
# ok below<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# Not ok on 4.3.3: mix of vfp and hard<br />
#QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=hard -ftree-vectorize <br />
<br />
#QMAKE_CXXFLAGS_RELEASE = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
#QMAKE_LINK = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-g++<br />
#QMAKE_LINK_SHLIB = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-g++<br />
#QMAKE_RANLIB = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
#QMAKE_AR = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-ar cqs<br />
#QMAKE_OBJCOPY = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-objcopy<br />
#QMAKE_STRIP = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-strip<br />
<br />
<br />
#QMAKE_CFLAGS_RELEASE += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
#QMAKE_CXXFLAGS_RELEASE += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
<br />
#QMAKE_CFLAGS_DEBUG += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
#QMAKE_CXXFLAGS_DEBUG += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
#QMAKE_LFLAGS += -Wl,--allow-shlib-undefined --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
To do:<br />
# V Get and untar the source<br />
# Set-up the mkspecs<br />
# Get the webos plugins/gfxdrivers -> credit original author -> link to the updated version<br />
# modify the build stuff<br />
# patch the transformed driver (?)<br />
# ./configure command line<br />
# make make install<br />
# something on what's the outcome<br />
<br />
=== 3.x WebOS gfxdrivers ===<br />
<br />
This step gets the WebOS Qt gfxdrivers plugin. The initial plugin version was written by Darron Black [1,2]. With the changes in WebOS 2.x an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code].<br />
<br />
# Cd to the gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Add to ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# ---------------------- patch transformed driver<br />
<br />
== 4. apps ==<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21583HowtoQt2012-02-05T23:30:26Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes a Linux development environment, and Qt 4.8. The process for Qt 4.7.x is identical; no idea for Qt 5.<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
# You may check that all is fine<br />
## You can invoke gcc or g++ from the PDK arm toolchain to compile some "hello world" test program. E.g. /opt/PalmPDK/??????????<br />
## novaterm.....????????<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. Without this file, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include file.<br />
<br />
* Need to check name<br />
* code sourcery's toolchain<br />
* which file where<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources. <br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are derived from the mostly the same as the linux-arm-gnueabi-g++ mkspecs. We copy this: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# <br />
<br />
<pre> <br />
#<br />
# qmake configuration for building with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
#GCCBASE = /opt/PalmPDK.441/arm-gcc/bin<br />
<br />
GCCBASE = /opt/PalmPDK.palm/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK.palm/include<br />
TSLIB_LIBDIR = /opt/PalmPDK.palm/device/lib<br />
<br />
<br />
#TSLIB_INCDIR += $$GCCBASE<br />
#TSLIB_INCDIR += /opt/PalmPDK.palm/arm-gcc/sysroot/usr/include<br />
<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
#QMAKE_CFLAGS_RELEASE = -O3 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CFLAGS_RELEASE = -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize -ffast-math -fsingle-precision-constant<br />
<br />
# ok below<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# Not ok on 4.3.3: mix of vfp and hard<br />
#QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=hard -ftree-vectorize <br />
<br />
#QMAKE_CFLAGS_RELEASE = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp <br />
#QMAKE_CXXFLAGS_RELEASE = -O3 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CXXFLAGS_RELEASE = -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize -ffast-math -fsingle-precision-constant<br />
<br />
# ok below<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# Not ok on 4.3.3: mix of vfp and hard<br />
#QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=hard -ftree-vectorize <br />
<br />
#QMAKE_CXXFLAGS_RELEASE = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
#QMAKE_LINK = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-g++<br />
#QMAKE_LINK_SHLIB = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-g++<br />
#QMAKE_RANLIB = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
#QMAKE_AR = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-ar cqs<br />
#QMAKE_OBJCOPY = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-objcopy<br />
#QMAKE_STRIP = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-strip<br />
<br />
<br />
#QMAKE_CFLAGS_RELEASE += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
#QMAKE_CXXFLAGS_RELEASE += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
<br />
#QMAKE_CFLAGS_DEBUG += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
#QMAKE_CXXFLAGS_DEBUG += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
#QMAKE_LFLAGS += -Wl,--allow-shlib-undefined --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</pre> <br />
<br />
<br />
To do:<br />
# V Get and untar the source<br />
# Set-up the mkspecs<br />
# Get the webos plugins/gfxdrivers -> credit original author -> link to the updated version<br />
# modify the build stuff<br />
# patch the transformed driver (?)<br />
# ./configure command line<br />
# make make install<br />
# something on what's the outcome<br />
<br />
=== 3.x WebOS gfxdrivers ===<br />
<br />
This step gets the WebOS Qt gfxdrivers plugin. The initial plugin version was written by Darron Black [1,2]. With the changes in WebOS 2.x an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code].<br />
<br />
# Cd to the gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Add to ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# ---------------------- patch transformed driver<br />
<br />
== 4. apps ==<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21581HowtoQt2012-02-05T23:29:44Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes a Linux development environment, and Qt 4.8. The process for Qt 4.7.x is identical; no idea for Qt 5.<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
# You may check that all is fine<br />
## You can invoke gcc or g++ from the PDK arm toolchain to compile some "hello world" test program. E.g. /opt/PalmPDK/??????????<br />
## novaterm.....????????<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. Without this file, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include file.<br />
<br />
* Need to check name<br />
* code sourcery's toolchain<br />
* which file where<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources. <br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are derived from the mostly the same as the linux-arm-gnueabi-g++ mkspecs. We copy this: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# <br />
<br />
<blockquote> <br />
#<br />
# qmake configuration for building with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
#GCCBASE = /opt/PalmPDK.441/arm-gcc/bin<br />
<br />
GCCBASE = /opt/PalmPDK.palm/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK.palm/include<br />
TSLIB_LIBDIR = /opt/PalmPDK.palm/device/lib<br />
<br />
<br />
#TSLIB_INCDIR += $$GCCBASE<br />
#TSLIB_INCDIR += /opt/PalmPDK.palm/arm-gcc/sysroot/usr/include<br />
<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
#QMAKE_CFLAGS_RELEASE = -O3 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CFLAGS_RELEASE = -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize -ffast-math -fsingle-precision-constant<br />
<br />
# ok below<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# Not ok on 4.3.3: mix of vfp and hard<br />
#QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=hard -ftree-vectorize <br />
<br />
#QMAKE_CFLAGS_RELEASE = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp <br />
#QMAKE_CXXFLAGS_RELEASE = -O3 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CXXFLAGS_RELEASE = -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize -ffast-math -fsingle-precision-constant<br />
<br />
# ok below<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# Not ok on 4.3.3: mix of vfp and hard<br />
#QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=hard -ftree-vectorize <br />
<br />
#QMAKE_CXXFLAGS_RELEASE = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
#QMAKE_LINK = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-g++<br />
#QMAKE_LINK_SHLIB = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-g++<br />
#QMAKE_RANLIB = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
#QMAKE_AR = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-ar cqs<br />
#QMAKE_OBJCOPY = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-objcopy<br />
#QMAKE_STRIP = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-strip<br />
<br />
<br />
#QMAKE_CFLAGS_RELEASE += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
#QMAKE_CXXFLAGS_RELEASE += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
<br />
#QMAKE_CFLAGS_DEBUG += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
#QMAKE_CXXFLAGS_DEBUG += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
#QMAKE_LFLAGS += -Wl,--allow-shlib-undefined --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</blockquote> <br />
<br />
<br />
To do:<br />
# V Get and untar the source<br />
# Set-up the mkspecs<br />
# Get the webos plugins/gfxdrivers -> credit original author -> link to the updated version<br />
# modify the build stuff<br />
# patch the transformed driver (?)<br />
# ./configure command line<br />
# make make install<br />
# something on what's the outcome<br />
<br />
=== 3.x WebOS gfxdrivers ===<br />
<br />
This step gets the WebOS Qt gfxdrivers plugin. The initial plugin version was written by Darron Black [1,2]. With the changes in WebOS 2.x an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code].<br />
<br />
# Cd to the gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Add to ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# ---------------------- patch transformed driver<br />
<br />
== 4. apps ==<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21579HowtoQt2012-02-05T23:28:40Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes a Linux development environment, and Qt 4.8. The process for Qt 4.7.x is identical; no idea for Qt 5.<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
# You may check that all is fine<br />
## You can invoke gcc or g++ from the PDK arm toolchain to compile some "hello world" test program. E.g. /opt/PalmPDK/??????????<br />
## novaterm.....????????<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. Without this file, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include file.<br />
<br />
* Need to check name<br />
* code sourcery's toolchain<br />
* which file where<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources. <br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are derived from the mostly the same as the linux-arm-gnueabi-g++ mkspecs. We copy this: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# <br />
<br />
<code><br />
#<br />
# qmake configuration for building with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
#GCCBASE = /opt/PalmPDK.441/arm-gcc/bin<br />
<br />
GCCBASE = /opt/PalmPDK.palm/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK.palm/include<br />
TSLIB_LIBDIR = /opt/PalmPDK.palm/device/lib<br />
<br />
<br />
#TSLIB_INCDIR += $$GCCBASE<br />
#TSLIB_INCDIR += /opt/PalmPDK.palm/arm-gcc/sysroot/usr/include<br />
<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
#QMAKE_CFLAGS_RELEASE = -O3 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CFLAGS_RELEASE = -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize -ffast-math -fsingle-precision-constant<br />
<br />
# ok below<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# Not ok on 4.3.3: mix of vfp and hard<br />
#QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=hard -ftree-vectorize <br />
<br />
#QMAKE_CFLAGS_RELEASE = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp <br />
#QMAKE_CXXFLAGS_RELEASE = -O3 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CXXFLAGS_RELEASE = -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize -ffast-math -fsingle-precision-constant<br />
<br />
# ok below<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# Not ok on 4.3.3: mix of vfp and hard<br />
#QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=hard -ftree-vectorize <br />
<br />
#QMAKE_CXXFLAGS_RELEASE = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
#QMAKE_LINK = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-g++<br />
#QMAKE_LINK_SHLIB = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-g++<br />
#QMAKE_RANLIB = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
#QMAKE_AR = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-ar cqs<br />
#QMAKE_OBJCOPY = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-objcopy<br />
#QMAKE_STRIP = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-strip<br />
<br />
<br />
#QMAKE_CFLAGS_RELEASE += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
#QMAKE_CXXFLAGS_RELEASE += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
<br />
#QMAKE_CFLAGS_DEBUG += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
#QMAKE_CXXFLAGS_DEBUG += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
#QMAKE_LFLAGS += -Wl,--allow-shlib-undefined --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
</code><br />
<br />
<br />
To do:<br />
# V Get and untar the source<br />
# Set-up the mkspecs<br />
# Get the webos plugins/gfxdrivers -> credit original author -> link to the updated version<br />
# modify the build stuff<br />
# patch the transformed driver (?)<br />
# ./configure command line<br />
# make make install<br />
# something on what's the outcome<br />
<br />
=== 3.x WebOS gfxdrivers ===<br />
<br />
This step gets the WebOS Qt gfxdrivers plugin. The initial plugin version was written by Darron Black [1,2]. With the changes in WebOS 2.x an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code].<br />
<br />
# Cd to the gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Add to ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# ---------------------- patch transformed driver<br />
<br />
== 4. apps ==<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21577HowtoQt2012-02-05T23:27:16Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes a Linux development environment, and Qt 4.8. The process for Qt 4.7.x is identical; no idea for Qt 5.<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
# You may check that all is fine<br />
## You can invoke gcc or g++ from the PDK arm toolchain to compile some "hello world" test program. E.g. /opt/PalmPDK/??????????<br />
## novaterm.....????????<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. Without this file, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include file.<br />
<br />
* Need to check name<br />
* code sourcery's toolchain<br />
* which file where<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources. <br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
We set-up the mkspecs for WebOS (compiler parameters required for cross-compilation):<br />
<br />
# Cd to the qws mkspecs: '''cd ~/qt-everywhere-opensource-src-4.8.0/mkspecs/qws'''<br />
# The WebOS mkspecs are derived from the mostly the same as the linux-arm-gnueabi-g++ mkspecs. We copy this: '''cp -r linux-arm-gnueabi-g++ linux-webos'''<br />
# <br />
<br />
#<br />
# qmake configuration for building with arm-linux-g++<br />
#<br />
<br />
#for 4.7.4:<br />
#include(../../common/g++.conf)<br />
#include(../../common/linux.conf)<br />
#include(../../common/qws.conf)<br />
<br />
# for 4.8<br />
include(../../common/linux.conf)<br />
include(../../common/gcc-base-unix.conf)<br />
include(../../common/g++-unix.conf)<br />
include(../../common/qws.conf)<br />
<br />
# modifications to g++.conf<br />
#Toolchain<br />
<br />
#Base directory of gcc toolchain<br />
#GCCBASE = /opt/PalmPDK.441/arm-gcc/bin<br />
<br />
GCCBASE = /opt/PalmPDK.palm/arm-gcc/bin<br />
TSLIB_INCDIR = /opt/PalmPDK.palm/include<br />
TSLIB_LIBDIR = /opt/PalmPDK.palm/device/lib<br />
<br />
<br />
#TSLIB_INCDIR += $$GCCBASE<br />
#TSLIB_INCDIR += /opt/PalmPDK.palm/arm-gcc/sysroot/usr/include<br />
<br />
<br />
<br />
#Compiler Flags to take advantage of the ARM architecture<br />
#QMAKE_CFLAGS_RELEASE = -O3 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CFLAGS_RELEASE = -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize -ffast-math -fsingle-precision-constant<br />
<br />
# ok below<br />
QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# Not ok on 4.3.3: mix of vfp and hard<br />
#QMAKE_CFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=hard -ftree-vectorize <br />
<br />
#QMAKE_CFLAGS_RELEASE = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp <br />
#QMAKE_CXXFLAGS_RELEASE = -O3 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CXXFLAGS_RELEASE = -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
#QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize -ffast-math -fsingle-precision-constant<br />
<br />
# ok below<br />
QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp -ftree-vectorize<br />
QMAKE_CXXFLAGS_DEBUG = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# Not ok on 4.3.3: mix of vfp and hard<br />
#QMAKE_CXXFLAGS_RELEASE = -O2 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=hard -ftree-vectorize <br />
<br />
#QMAKE_CXXFLAGS_RELEASE = -O0 -march=armv7-a -mtune=cortex-a8 -mfpu=neon -mfloat-abi=softfp<br />
<br />
# For official pdk<br />
QMAKE_CC = $$GCCBASE/arm-none-linux-gnueabi-gcc<br />
QMAKE_CXX = $$GCCBASE/arm-none-linux-gnueabi-g++<br />
QMAKE_LINK = $$QMAKE_CXX<br />
QMAKE_LINK_SHLIB = $$QMAKE_CXX<br />
QMAKE_RANLIB = $$GCCBASE/arm-none-linux-gnueabi-ranlib<br />
#QMAKE_LINK = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-g++<br />
#QMAKE_LINK_SHLIB = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-g++<br />
#QMAKE_RANLIB = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-ranlib<br />
<br />
# modifications to linux.conf<br />
QMAKE_AR = $$GCCBASE/arm-none-linux-gnueabi-ar cqs<br />
QMAKE_OBJCOPY = $$GCCBASE/arm-none-linux-gnueabi-objcopy<br />
QMAKE_STRIP = $$GCCBASE/arm-none-linux-gnueabi-strip<br />
#QMAKE_AR = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-ar cqs<br />
#QMAKE_OBJCOPY = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-objcopy<br />
#QMAKE_STRIP = /opt/PalmPDK.palm/arm-gcc/bin/arm-none-linux-gnueabi-strip<br />
<br />
<br />
#QMAKE_CFLAGS_RELEASE += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
#QMAKE_CXXFLAGS_RELEASE += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
<br />
#QMAKE_CFLAGS_DEBUG += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
#QMAKE_CXXFLAGS_DEBUG += --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
<br />
<br />
QMAKE_INCDIR = $$TSLIB_INCDIR <br />
QMAKE_LIBDIR = $$TSLIB_LIBDIR <br />
QMAKE_LIBS += -lrt -lz <br />
<br />
#QMAKE_LFLAGS += -Wl,--allow-shlib-undefined --sysroot=/opt/PalmPDK.palm/arm-gcc/sysroot<br />
QMAKE_LFLAGS += -Wl,--allow-shlib-undefined <br />
<br />
load(qt_config)<br />
<br />
<br />
<br />
<br />
To do:<br />
# V Get and untar the source<br />
# Set-up the mkspecs<br />
# Get the webos plugins/gfxdrivers -> credit original author -> link to the updated version<br />
# modify the build stuff<br />
# patch the transformed driver (?)<br />
# ./configure command line<br />
# make make install<br />
# something on what's the outcome<br />
<br />
=== 3.x WebOS gfxdrivers ===<br />
<br />
This step gets the WebOS Qt gfxdrivers plugin. The initial plugin version was written by Darron Black [1,2]. With the changes in WebOS 2.x an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code].<br />
<br />
# Cd to the gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Add to ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# ---------------------- patch transformed driver<br />
<br />
== 4. apps ==<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21575HowtoQt2012-02-05T23:19:15Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes a Linux development environment, and Qt 4.8. The process for Qt 4.7.x is identical; no idea for Qt 5.<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
# You may check that all is fine<br />
## You can invoke gcc or g++ from the PDK arm toolchain to compile some "hello world" test program. E.g. /opt/PalmPDK/??????????<br />
## novaterm.....????????<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. Without this file, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include file.<br />
<br />
* Need to check name<br />
* code sourcery's toolchain<br />
* which file where<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
This step gets the Qt 4.8 sources. <br />
<br />
# Cd to your home directory: '''cd ~'''<br />
# Get the Qt 4.8 sources: '''http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
# Untar: '''tar xvfz qt-everywhere-opensource-src-4.8.0.tar.gz'''<br />
<br />
<br />
<br />
To do:<br />
# V Get and untar the source<br />
# Set-up the mkspecs<br />
# Get the webos plugins/gfxdrivers -> credit original author -> link to the updated version<br />
# modify the build stuff<br />
# patch the transformed driver (?)<br />
# ./configure command line<br />
# make make install<br />
# something on what's the outcome<br />
<br />
=== 3.x WebOS gfxdrivers ===<br />
<br />
This step gets the WebOS Qt gfxdrivers plugin. The initial plugin version was written by Darron Black [1,2]. With the changes in WebOS 2.x an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code].<br />
<br />
# Cd to the gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Add to ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# ---------------------- patch transformed driver<br />
<br />
== 4. apps ==<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21573HowtoQt2012-02-05T23:15:47Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes a Linux development environment, and Qt 4.8. The process for Qt 4.7.x is identical; no idea for Qt 5.<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
# You may check that all is fine<br />
## You can invoke gcc or g++ from the PDK arm toolchain to compile some "hello world" test program. E.g. /opt/PalmPDK/??????????<br />
## novaterm.....????????<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. Without this file, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include file.<br />
<br />
* Need to check name<br />
* code sourcery's toolchain<br />
* which file where<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
To do:<br />
# Get and untar the source<br />
# Set-up the mkspecs<br />
# Get the webos plugins/gfxdrivers -> credit original author -> link to the updated version<br />
# modify the build stuff<br />
# patch the transformed driver (?)<br />
# ./configure command line<br />
# make make install<br />
# something on what's the outcome<br />
<br />
=== 3.x WebOS gfxdrivers ===<br />
<br />
This step gets the WebOS Qt gfxdrivers plugin. The initial plugin version was written by Darron Black [1,2]. With the changes in WebOS 2.x an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code].<br />
<br />
# Cd to the gfxdrivers directory: '''cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers'''<br />
# Get the WebOS gfxdrivers plugin: '''svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos'''<br />
# Add to ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# ---------------------- patch transformed driver<br />
<br />
== 4. apps ==<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21571HowtoQt2012-02-05T23:09:25Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes a Linux development environment, and Qt 4.8. The process for Qt 4.7.x is identical; no idea for Qt 5.<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
# You may check that all is fine<br />
## You can invoke gcc or g++ from the PDK arm toolchain to compile some "hello world" test program. E.g. /opt/PalmPDK/??????????<br />
## novaterm.....????????<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. Without this file, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include file.<br />
<br />
* Need to check name<br />
* code sourcery's toolchain<br />
* which file where<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
To do:<br />
# Get and untar the source<br />
# Set-up the mkspecs<br />
# Get the webos plugins/gfxdrivers -> credit original author -> link to the updated version<br />
# modify the build stuff<br />
# patch the transformed driver (?)<br />
# ./configure command line<br />
# make make install<br />
# something on what's the outcome<br />
<br />
=== 3.x WebOS gfxdrivers ===<br />
<br />
This step gets the WebOS Qt gfxdrivers plugin. The initial plugin version was written by Darron Black [1,2]. With the changes in WebOS 2.x an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code].<br />
<br />
# Cd to the gfxdrivers directory: cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers<br />
# Get the WebOS gfxdrivers plugin: svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos<br />
# Add to ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro the line: '''contains(gfx-plugins, webos) :SUBDIRS += webos'''<br />
# ---------------------- patch transformed driver<br />
<br />
== 4. apps ==<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21569HowtoQt2012-02-05T23:05:10Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes a Linux development environment, and Qt 4.8. The process for Qt 4.7.x is identical; no idea for Qt 5.<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
# You may check that all is fine<br />
## You can invoke gcc or g++ from the PDK arm toolchain to compile some "hello world" test program. E.g. /opt/PalmPDK/??????????<br />
## novaterm.....????????<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. Without this file, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include file.<br />
<br />
* Need to check name<br />
* code sourcery's toolchain<br />
* which file where<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
To do:<br />
# Get and untar the source<br />
# Set-up the mkspecs<br />
# Get the webos plugins/gfxdrivers -> credit original author -> link to the updated version<br />
# modify the build stuff<br />
# patch the transformed driver (?)<br />
# ./configure command line<br />
# make make install<br />
# something on what's the outcome<br />
<br />
=== 3.x WebOS gfxdrivers ===<br />
<br />
This step gets the WebOS Qt gfxdrivers plugin. The initial plugin version was written by Darron Black [1,2]. With the changes in WebOS 2.x an extended version is required that handles keyboard input for "non-root" users. That version is available from [http://code.google.com/p/qt-webos Qt gfxdrivers plugin for WebOS on Google Code].<br />
<br />
# Cd to the gfxdrivers directory: cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers<br />
# Get the WebOS gfxdrivers plugin: svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos<br />
# Add to ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers/gfxdrivers.pro the line: contains(gfx-plugins, webos) :SUBDIRS += webos<br />
<br />
<br />
<br />
== 4. apps ==<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21567HowtoQt2012-02-05T23:03:04Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes a Linux development environment, and Qt 4.8. The process for Qt 4.7.x is identical; no idea for Qt 5.<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
# You may check that all is fine<br />
## You can invoke gcc or g++ from the PDK arm toolchain to compile some "hello world" test program. E.g. /opt/PalmPDK/??????????<br />
## novaterm.....????????<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. Without this file, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include file.<br />
<br />
* Need to check name<br />
* code sourcery's toolchain<br />
* which file where<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
To do:<br />
# Get and untar the source<br />
# Set-up the mkspecs<br />
# Get the webos plugins/gfxdrivers -> credit original author -> link to the updated version<br />
# modify the build stuff<br />
# patch the transformed driver (?)<br />
# ./configure command line<br />
# make make install<br />
# something on what's the outcome<br />
<br />
=== 3.x WebOS gfxdrivers ===<br />
<br />
This step gets the WebOS Qt gfxdrivers plugin. The initial plugin version was written by Darron Black [1,2]. With the changes in WebOS 2.x an extended version is required that handles keyboard input for "non-root" users. That version is available at [http://code.google.com/p/qt-webos Qt WebOS].<br />
<br />
# Cd to the gfxdrivers directory: cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers<br />
# Get the WebOS gfxdrivers plugin: svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos<br />
<br />
<br />
<br />
== 4. apps ==<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21565HowtoQt2012-02-05T22:58:01Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes a Linux development environment, and Qt 4.8. The process for Qt 4.7.x is identical; no idea for Qt 5.<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
# You may check that all is fine<br />
## You can invoke gcc or g++ from the PDK arm toolchain to compile some "hello world" test program. E.g. /opt/PalmPDK/??????????<br />
## novaterm.....????????<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. Without this file, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include file.<br />
<br />
* Need to check name<br />
* code sourcery's toolchain<br />
* which file where<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
To do:<br />
# Get and untar the source<br />
# Set-up the mkspecs<br />
# Get the webos plugins/gfxdrivers -> credit original author -> link to the updated version<br />
# modify the build stuff<br />
# patch the transformed driver (?)<br />
# ./configure command line<br />
# make make install<br />
# something on what's the outcome<br />
<br />
=== 3.x WebOS gfxdrivers ===<br />
<br />
This step gets the WebOS qt gfxdrivers.<br />
<br />
# Cd to the gfxdrivers directory: cd ~/qt-everywhere-opensource-src-4.8.0/src/plugins/gfxdrivers<br />
# Get the WebOS gfxdrivers plugin: svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos<br />
<br />
<br />
<br />
== 4. apps ==<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21563HowtoQt2012-02-05T22:49:39Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes a Linux development environment, and Qt 4.8. The process for Qt 4.7.x is identical; no idea for Qt 5.<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
# You may check that all is fine<br />
## You can invoke gcc or g++ from the PDK arm toolchain to compile some "hello world" test program. E.g. /opt/PalmPDK/??????????<br />
## novaterm.....????????<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. Without this file, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include file.<br />
<br />
* Need to check name<br />
* code sourcery's toolchain<br />
* which file where<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
To do:<br />
# Get and untar the source<br />
# Set-up the mkspecs<br />
# Get the webos plugins/gfxdrivers -> credit original author -> link to the updated version<br />
# modify the build stuff<br />
# patch the transformed driver (?)<br />
# ./configure command line<br />
# make make install<br />
# something on what's the outcome<br />
<br />
# Get the WebOS gfxdrivers plugin: svn checkout http://qt-webos.googlecode.com/svn/trunk/ webos<br />
<br />
<br />
<br />
== 4. apps ==<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21559HowtoQt2012-02-04T23:50:34Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes a Linux development environment, and Qt 4.8. The process for Qt 4.7.x is identical; no idea for Qt 5.<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
# You may check that all is fine<br />
## You can invoke gcc or g++ from the PDK arm toolchain to compile some "hello world" test program. E.g. /opt/PalmPDK/??????????<br />
## novaterm.....????????<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. Without this file, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include file.<br />
<br />
* Need to check name<br />
* code sourcery's toolchain<br />
* which file where<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
To do:<br />
# Get and untar the source<br />
# Set-up the mkspecs<br />
# Get the webos plugins/gfxdrivers -> credit original author -> link to the updated version<br />
# modify the build stuff<br />
# patch the transformed driver (?)<br />
# ./configure command line<br />
# make make install<br />
# something on what's the outcome<br />
<br />
== 4. apps ==<br />
<br />
== 5. deploy ==<br />
<br />
<br />
== A. Links ==<br />
[1] [http://www.griffin.net/2010/02/qt-on-the-palm-pre.html Qt on the Palm Pre]<br />
[2] [https://gitorious.org/~darronb/qt/qt-palm-pre Qt port to webOS by Darron Black on gitorious]</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21557HowtoQt2012-02-04T23:44:48Z<p>DanRog: </p>
<hr />
<div>This document is not yet complete - stay tuned<br />
<br />
= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes a Linux development environment, and Qt 4.8. The process for Qt 4.7.x is identical; no idea for Qt 5.<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
# Check that all is fine: /opt/PalmPDK/??????????<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. Without this file, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include file.<br />
<br />
* Need to check name<br />
* code sourcery's toolchain<br />
* which file where<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
To do:<br />
# Get and untar the source<br />
# Set-up the mkspecs<br />
# Get the webos plugins/gfxdrivers -> credit original author -> link to the updated version<br />
# modify the build stuff<br />
# patch the transformed driver (?)<br />
# ./configure command line<br />
# make make install<br />
# something on what's the outcome</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21555HowtoQt2012-02-04T14:32:56Z<p>DanRog: </p>
<hr />
<div>= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes a Linux development environment, and Qt 4.8. The process for Qt 4.7.x is identical; no idea for Qt 5.<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
# Check that all is fine: /opt/PalmPDK/??????????<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. Without this file, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach is to provide the missing include file.<br />
<br />
* Need to check name<br />
* code sourcery's toolchain<br />
* which file where<br />
<br />
== 3. Getting Qt 4.8, setting it up for cross-compilation ==<br />
<br />
To do:<br />
# Get and untar the source<br />
# Set-up the mkspecs<br />
# Get the webos plugins/gfxdrivers -> credit original author -> link to the updated version<br />
# modify the build stuff<br />
# patch the transformed driver (?)<br />
# ./configure command line<br />
# make make install<br />
# something on what's the outcome</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21553HowtoQt2012-02-04T14:28:36Z<p>DanRog: </p>
<hr />
<div>= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes a Linux development environment, and Qt 4.8. The process for Qt 4.7.x is identical; no idea for Qt 5.<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device. VirtualBox can be skipped. Java may be necessary.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05] and the installation procedure. Follow the instructions on there. But essentially this boils down to:<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
# Check that all is fine: /opt/PalmPDK/??????????<br />
<br />
<br />
== 2. Optional: completing the PDK with some missing includes ==<br />
<br />
The Palm PDK contains an arm toolchain which can be used as-is to cross-compile Qt. This step can be skipped, unless you want maximum performance with JavaScript in WebKit.<br />
<br />
There is one issue with the Palm PDK. The Qt configuration script relies on the existence of one include file to know whether programs can identify the characteristics of the CPU, such as the availability of Neon instructions. Without this file, Qt will cross-compile and work, but the just-in-time JavaScript compiler in WebKit will be deactivated. This decreases JavaScript performance by a factor ~3.<br />
<br />
Therefore the recommended approach solut<br />
<br />
This include is missing</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21551HowtoQt2012-02-04T14:20:14Z<p>DanRog: </p>
<hr />
<div>= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes a Linux development environment, and Qt 4.8. The process for Qt 4.7.x is identical; no idea for Qt 5.<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05]<br />
# Download novacom from that page<br />
# Download the SDK from that page<br />
# Install novacom and the SDK following the instructions. I.e.:<br />
## sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
## sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
# The SDK is now in /opt/PalmPDK<br />
# Check that all is fine: /opt/PalmPDK/??????????<br />
<br />
<br />
<br />
== 2. Optional: Getting and setting up the Palm PDK ==</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21549HowtoQt2012-02-04T14:18:47Z<p>DanRog: </p>
<hr />
<div>= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes a Linux development environment, and Qt 4.8. The process for Qt 4.7.x is identical; no idea for Qt 5.<br />
<br />
The steps include:<br />
# Getting and setting-up the Palm PDK<br />
# Optionally: completing the PDK with some missing includes<br />
# Getting Qt 4.8, setting it up for cross-compilation<br />
# Cross-compilation of Qt 4.8<br />
# Updated webos port of Qt<br />
# Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==<br />
<br />
Qt is cross-compiled with the official Palm PDK. The PDK plays nice: it can be installed alongside the webos internals WIDK without conflicts; there is no need to modify paths or environment variables.<br />
<br />
Note that I haven't "fully" installed the PDK. In particular I haven't set-up the emulator. The basic stuff needed are: the arm gcc toolchain, and novacom to communicate with the device.<br />
<br />
# Read about the [https://developer.palm.com/content/resources/develop/sdk_pdk_download.html#linux Palm SDK 3.05]<br />
## Download novacom from that page<br />
## Download the SDK from that page<br />
## Install novacom and the SDK following the instructions. I.e.:<br />
sudo dpkg -i palm-sdk_3.0.5-svn528736-pho676_i386.deb<br />
sudo dpkg -i palm-novacom_1.0.80_i386.deb <br />
## The SDK is now in /opt/PalmPDK<br />
<br />
<br />
<br />
== 2. Optional: Getting and setting up the Palm PDK ==</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21547HowtoQt2012-02-04T14:07:48Z<p>DanRog: </p>
<hr />
<div>= Qt and QML on WebOS devices =<br />
<br />
This document explains how to set-up [http://qt.nokia.com Qt 4.8 (Trolltech/Nokia's cross-platform application and UI framework)] on WebOS devices, and then how to cross-compile Qt or QML apps.<br />
<br />
This guide assumes a Linux development environment, and Qt 4.8. The process for Qt 4.7.x is identical; no idea for Qt 5.<br />
<br />
The steps include<br />
* Getting and setting-up the Palm PDK<br />
* Optionally: completing the PDK with some missing includes<br />
* Getting Qt 4.8, setting it up for cross-compilation<br />
* Cross-compilation of Qt 4.8<br />
* Updated webos port of Qt<br />
* Application tweaks to look for libs in the right places<br />
<br />
== 1. Getting and setting up the Palm PDK ==</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21545HowtoQt2012-02-04T13:59:02Z<p>DanRog: </p>
<hr />
<div>Will cover:<br />
* Getting the PDK running<br />
* Patching the PDK with the missing asm includes<br />
* Cross-compilation of Qt 4.8<br />
* Updated webos port of Qt<br />
* Application tweaks to look for libs in the right places<br />
<br />
== Setting up the PDK ==</div>DanRoghttp://wiki.webos-internals.org/index.php?title=HowtoQt&diff=21543HowtoQt2012-02-04T09:57:40Z<p>DanRog: Created page with "Will cover: * Getting the PDK running * Patching the PDK with the missing asm includes * Cross-compilation of Qt 4.8 * Updated webos port of Qt * Application tweaks to ..."</p>
<hr />
<div>Will cover:<br />
* Getting the PDK running<br />
* Patching the PDK with the missing asm includes<br />
* Cross-compilation of Qt 4.8<br />
* Updated webos port of Qt<br />
* Application tweaks to look for libs in the right places</div>DanRoghttp://wiki.webos-internals.org/index.php?title=Portal:Tools&diff=21541Portal:Tools2012-02-04T09:55:50Z<p>DanRog: </p>
<hr />
<div>__notoc__<br />
{{portal-header|<br />
This page lists tools used in any form.<br />
}}<br />
{{portal-two-columns<br />
|column1=<br />
== webOS Internal Related Tools ==<br />
<br />
* [[Getting started|Accessing Developer Mode]]<br />
* [[Backing_Up_via_Rsync|Backing Up via Rsync]]<br />
* [[Com Palm Appinstaller]]<br />
* [[Com Palm Downloadmanager|Com Palm Downloadmanager]] <br />
* [[Crond|Crond]]<br />
* [[Detecting Application Errors, Syslog|Detecting Application Errors, Syslog]] <br />
* [[How to solve 3G data problems]]<br />
* [[Important_Personal_Data_Locations|Important Personal Data Locations]]<br />
<!--* [[/var/luna/data|/var/luna/data]]--><br />
* [[/usr/bin/lunaprop|/usr/bin/lunaprop]]<br />
* [[Java Services|Java Services]] <br />
* [[Luna Send|Luna Send]] <br />
* [[PalmDatabase.db3 File|PalmDatabase.db3 File]] <br />
<!--* [[mediadb.db3 File|mediadb.db3 File]]--><br />
<!--* [[fileindexer File|fileindexer File]]--><br />
* [[Profile.d|Profile.d]] <br />
* [[Tellbootie|Tellbootie]]<br />
* [[Webos Doctor Versions|Webos Doctor Versions]]<br />
<br />
==Cross-Compiling and Kernels==<br />
* [[Autobuilder Setup|Autobuilder Setup]]<br />
* [[WebOS Internals PDK]]<br />
* [[Cross Compiling|Cross Compiling]] <br />
* [[Custom Kernels|Custom Kernels]] <br />
* [[Optware Cross Compilation|Optware Cross Compilation]] <br />
* [[Building_a_cross_toolchain|Building a cross-toolchain for armv7 on Gentoo]]<br />
* [[Adding_patches_through_git|Adding patches through git]]<br />
* [[HowtoQt|How to get Qt/QML libs and apps on WebOS]]<br />
<br />
|column2=<br />
<br />
==PDK Related Pages==<br />
<br />
[[WebOS Internals PDK]] WebOS-Internals alternative to Palm's PDK <br />
<br />
[[PDK on Linux]] Running Palm's official PDK on linux. <br />
<br />
<br />
==SDK Related Tools ([[Comparison of Editors|Comparison Chart]]) ==<br />
<!-- Warning Do not edit the order of the top two editors (Eclipse and Komodo) --><br />
===Eclipse===<br />
<br />
[http://www.eclipse.org/downloads/ Eclipse] is the editor officially supported by Palm. You can find the Eclipse WebOS plugin [http://developer.palm.com/index.php?option=com_content&view=article&id=1639 here].<br />
<br />
===Komodo Edit===<br />
<br />
[http://www.activestate.com/komodo_edit/ Komodo Edit] is an easy to use cross platform open source editor. Use along side the webOS [http://www.webos.templarian.com/komodo/ Add-on] for easier development. Complete [http://www.webos.templarian.com/komodo/ Code Completion] is also available for Mojo. [[Komodo|Wiki Page with Screensots and Install Guide]].<br />
<br />
===Aptana Studio===<br />
<br />
[http://www.aptana.com/studio/download Aptana Studio] is a standalone version of an Eclipse plugin. Very easy to use. You can install the Aptana WebOS plugin by directing Aptana to check [https://cdn.downloads.palm.com/sdkdownloads/1.1/eclipse-plugin/eclipse-3.4/site.xml this link]. If you do not know how to set this up, please look at official Palm documentation [http://developer.palm.com/index.php?option=com_content&view=article&id=1639 here].<br />
}}</div>DanRog