Getting Started With Lighthouse
| IMPORTANT: The content of this page is outdated. Reason: Article says it's outdated.|
If you have checked or updated this page and found the content to be suitable, please remove this notice.
| This article is nominated for deletion. Reason: Please move any useful content to Qt Platform Abstraction and redirect there. Thank you!|
Please raise your support/opposition to this nomination in the article's discussion page.
The information presented here is obsoleted according to http://labs.qt.nokia.com/2011/05/31/lighthouse-has-grown-up-now/
Getting started with Lighthouse (a.k.a. QPA)
You need a Unix-like system, a reasonably modern C++ compiler, and an up-to-date version of git (1.6 or newer recommended). (If you do not have git, there is a way to download tarballs from qt.gitorious.org, but I'm not going to show you how: You really want to use git, especially if you are ever going to update to newer versions.)
Clone the Lighthouse repositoryFirst choose some convenient place to put the code. For the purpose of this document I will use
mkdir -p~/dev cd ~/dev
git clone git://gitorious.org/+qt-developers/qt/lighthouse.git
Configure and build
We will use shadow builds for this. Shadow building means building outside the source directory tree. It is of course possible to build Lighthouse inside the source tree, but use shadow builds anyway. You will thank me later: With shadow builds you can have several different build configurations side by side.
The only limitation is that the shadow build directory has to be outside the source tree; otherwise Qt's build system will be fatally confused. Apart from that you could put the build directory anywhere, but here I'll put it next to the source directory.Create a build directory, and
cd ~/dev mkdir build-lighthouse cd build-lighthouse
Running the configure script from inside the build directory sets up the shadow build:
../qt-lighthouse/configure -qpa -developer-build
make -C src
Run some examples
We didn't compile any examples in the previous step, so we have to compile them as we need them. We'll choose the industrial standard example for Qt testing:
cd examples/widgets/wiggly/ make
./wiggly -platform minimal
Note: you have to press Ctrl-C to stop the program, otherwise your file system will fill up with images.Now you can use your favorite image viewer to look at the images (
cd ../../../src/plugins/platforms/testlite/ make
Go back to the example,
and run it with the new backend:
./wiggly -platform testlite
Now you can start on the advanced stuff
The short version: Look at the files in qtbase/src/plugins/platforms/minimal/. That should show what needs to be implemented to get a new plugin off the ground. The long version might get written up as Writing Your Own Lighthouse Backend.