General Installation Information
In order to use Lively for Qt, follow the steps below:
- Install the Qt platform on your target computer or device.
by running the
- Use the generated
qs_evaltool to run the system using the syntax shown in file
"Qtly.bat". The general syntax is:
"qs_eval ...application files... QtInspector.js Qtly.js"
In order to run Lively for Qt without any applications or additional tools,
1. Installing the Qt Platform
The following sections contain instructions for the installation of Qt for Windows XP, Mac OS X 10.4 & 10.5, Ubuntu Linux 8.10 and Nokia's Maemo Platform. The instructions should be applicable to other systems as well. Information about supported platforms for Qt can be found in http://doc.trolltech.com/4.5/supported-platforms.html. Platform specific notes are available at http://doc.trolltech.com/4.5/platform-notes-platforms.html.
Installation on Windows XP
- Download Qt libraries 4.5 for Windows.
- Download the MinGW compiler in order to compile the QtScriptGenerator (MinGW can be chosen to be downloaded and installed with Qt).
- Execute the Qt installer. The default installation path should be fine. Note that you should install Qt to a directory whose name does not contain whitespaces.
- The installer adds the Qt
bindirectory to the system path and configures other needed environment variables (Qt 4.5.0 Command Prompt can be found in Start menu under Qt by Nokia v.4.5.0 (OpenSource)).
- Additional helpful information for MinGW-based installation.
- The system can also be built using Microsoft Visual Studio 2005 or later. From the Microsoft Visual Studio 2005 Command Prompt, first type
nmake. The configuration step takes about 20-30 minutes, and the
nmakebuild about 2-3 hours on a typical laptop computer.
Installation on Ubuntu Linux 8.10 and Mac OS X
- Download Qt libraries 4.5 for Linux/X11 or Qt libraries 4.5 for Mac
- Decompress the gzipped tar package in the console:
tar xvzf qt-x11-opensource-src-4.5.0.tar.gz
- Switch to the decompressed directory and configure Qt by giving out the command:
./configureYou may add parameters to the configure command; as default Qt is installed under /usr/local/Trolltech/Qt.4.5.0. The list of configuration options can be obtained by
- After the configuration has ended, check that the components of Qt are available that you wish to include, i.e. OpenGL, Phonon etc. Those may require further libraries to be installed. The configure program provides an output where all the compilation options are listed and can be easily checked.
- The actual build is started with command
- When the build finishes, install Qt by giving out the command
- In order to make Qt libraries available in the system, add the Qt bin directory to the system PATH, e.g. add the following entries to the $HOME/.profile file.
- Add also the QTDIR environment variable that points to the installation directory of Qt to the $HOME/.profile file.
Installation on Maemo Scratchbox (Nokia N800/N810)
- In order to use the system on Nokia N800/N810, you will need Maemo Scratchbox and the Maemo SDK. To install those, follow the instructions provided at http://maemo.org/development/sdks/maemo_4-1-2_diablo/.
- When you have a working development environment, follow the instructions at Maemo Wiki for the installation of the Qt platform on Maemo.
Verifying the Qt Installation
A successful Qt build will usually take several hours. If the compilation succeeded without errors, you should verify the installation by running some of the demo applications, and by reviewing the online documentation provided with Qt.
- To run the demo applications, execute the
qtdemoprogram provided in directory
- To review the online documentation, execute the
assistantprogram provided in directory
- Unzip the download package, and read the instructions in the README file provided with the ZIP file.
Build QtScriptGenerator as follows (this build process should be nearly identical on all target platforms):
- Open a new shell (in Windows: Qt Command Prompt or Visual Studio 2005 Command Prompt).
- Make sure the
QTDIRenvironment variable is defined and points to the root of the Qt installation directory (see the instructions above). Also make sure that
(QTDIR)/binis part of your
- Switch to the top-level directory of the QtScriptGenerator.
- In subdirectory
generator, compile the generator by first invoking
nmakeif you are using Microsoft Visual Studio). This will take about 1-2 minutes. Note that Qt Script Generator does not compile under Maemo Scratchbox unless it is compiled in the
- Next, execute the generator by invoking
generated_cppsubdirectory. This step will take about 2-4 minutes. If the generator is not able to detect the header files, you should provide the location of the Qt header files with compilation directive
--include-paths. The necessary include files are generally located in directory
- When the generator has generated the required classes,
switch to directory
qs_evalexecutable in directory
qtbindings/qs_eval/release. QtScriptGenerator includes a set of code files (with file type
*.qs) that can be used to test and verify that the environment is functional. The files are located in subdirectory examples. Use the
qs_evaltool to execute some of the sample applications.
qtbindings.profile in subdirectory
qtbindingsand then rebuilding the QtScriptGenerator.
qs_eval file.qs(it is recommended that you add the directory containing
- To execute the Lively for Qt system, place the files from ZIP file of the Lively for Qt system
releasedirectory of the
qs_evaltool. The necessary path will look something like:
Then execute the command line included in file
In order to run Lively for Qt without any applications or additional tools, just say:
Notes on Invoking
- Note that qs_eval does not display any error messages if the file(s) to be executed cannot be found.
qs_eval. Otherwise, the requested files are not necessarily found.
Qt API Documentation
- The general Qt API documentation can be viewed either by opening
(QTDIR)/bin/assistanttool or by viewing Qt API documentation on the web.
4. Running Lively for Qt Inside a Web Browser
Lively for Qt can be run in any web browser using a Qt web browser plugin. Instructions for installing the necessary web browser plugin(s) will be available here later.