Qt-4.8.0

Introduction to Qt4

The Qt4 package contains several C++ libraries with both GUI and non-GUI components. One of the major users of Qt4 is KDE4.

Package Information

Qt Dependencies

Required

X Window System

Recommended

Optional

D-BUS-1.4.16, GStreamer Base Plug-ins-0.10.25, PulseAudio-0.9.23, GLib-2.30.1, gtk+-2.24.8, OpenSSL-1.0.0e, Cups-1.5.0, MySQL-5.5.17, PostgreSQL-9.0.6, unixODBC-2.3.0, and SQLite-3.7.8

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/qt4

Installation of Qt4

There are several ways to install a complicated package such as Qt4. The files are not completely position independent. Installation procedures execute the program pkg-config to determine the location of package executables, libraries, headers, and other files. For Qt4, pkg-config will look for the appropriate lib/pkgconfig/Qt*.pc files which must be modified if relocating the package. These files are set up correctly by the build process.

The default installation places the files in /usr/local/qt/. Many commercial distributions place the files in the system's /usr hierarchy. The package can also be installed in an arbitrary directory.

The advantage of this method is that no updates to the /etc/ld.so.conf or /etc/man_db.conf files are required. The package files are distributed within several subdirectories of the /usr hierarchy. This is the method that most commercial distributions use.

[Note]

Note

There is no conflict between the Qt3 and Qt4 applications and headers so both can be installed at the same time. This may be necessary to build or run Qt3 applications like KDE3 and Qt4 applications like Doxygen's doxywizard on the same system.

To set up both Qt3 and Qt4 on the same system, choose the primary version for the /opt/qt symbolic link and add the explicit library directory of the other version to /etc/ld.so.conf.

On a system with both versions of Qt, there is a name conflict with Qt applications such as qmake, assistant, and designer. In such a case, make sure the PATH variable lists the proper /opt/qt<version>/bin directory before the other Qt bin directory.

[Caution]

Caution

If Qt4 is being reinstalled and the /usr directory is used as the prefix, run the following commands from a console or non-Qt4 based window manager. It overwrites Qt4 libraries that should not be in use during the install process.

[Note]

Note

The build time and space required for the full Qt4 is quite long. The instructions below do not build the tutorials and examples. Removing the -nomake lines will create a complete build.

The method recommended by the Qt4 developers does not use the /usr directory prefix. It has the advantage of keeping all the package files consolidated in a dedicated directory hierarchy. By using this method, an update can be made without overwriting a previous installation and users can easily revert to a previous version by changing one symbolic link.

The Qt4 developers use a default location of /usr/local/qt/, however the procedure below puts the files in /opt/qt-4.8.0/ and then creates a symbolic link to /opt/qt/.

Install Qt4 by running the following commands:

./configure -prefix /opt/qt-4.8.0  \
            -release                 \
            -nomake examples         \
            -nomake demos            \
            -system-sqlite           \
            -no-nis                  \
            &&
make
[Note]

Phonon

If KDE4 is intended to be installed, add -no-phonon to the ./configure command above. While installing KDE4, a separate version of the Phonon libraries will be installed which better matches the needs of the KDE4 desktop.

This package does not come with a test suite.

Now, as the root user:

make install

If you installed Qt4 in the /opt directory, again as the root user issue:

ln -v -sfn qt-4.8.0 /opt/qt

Command Explanations

-nomake examples, -nomake demos: These switches disable building programs that are only of interest to a Qt4 developer.

There are several optional directories that can be specified in the ./configure line. These include -bindir, -libdir, -docdir, and -headerdir. For a complete list, run ./configure -help.

-plugin-sql-<driver> or -qt-sql-<driver>: These switches build SQL support into the Qt4 libraries.

[Note]

Note

To check if mysql is autodetected properly, examine the output of ./configure -qt-sql-mysql -help. Other database support will require similar configure parameters.

Configuring Qt4

Configuration Information

If you installed Qt4 in a location other than /usr, you also need to update the following configuration files so that Qt4 is correctly found by other packages and system processes.

As the root user, update the /etc/ld.so.conf file and the dynamic linker's run-time cache file:

cat >> /etc/ld.so.conf << "EOF" &&
# Begin qt addition to /etc/ld.so.conf

/opt/qt/lib

# End qt addition
EOF
ldconfig

Update the PKG_CONFIG_PATH environment variable in your ~/.bash_profile or /etc/profile with the following:

PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/opt/qt/lib/pkgconfig

If you want the Qt4 executables in your shell search path, update the PATH environment variable in your ~/.bash_profile or /etc/profile to include /opt/qt/bin.

Contents

Installed Programs: assistant, assistant_adp, designer, lconvert, linguist, lrelease, lupdate, moc, pixeltool, qcollectiongenerator, qdbus, qdbuscpp2xml, qdbusviewer, qdbusxml2cpp, qhelpconverter, qhelpgenerator,qmake, qt3to4, qtconfig, qtdemo, rcc, uic, uic3, and xmlpatterns
Installed Libraries: libphonon.so, libQt3Support.so, libQtAssistantClient.so, libQtCLucene.so, libQtCore.so, libQtDesigner.so, libQtDBus.so, libQtDesignerComponents.so, libQtGui.so, libQtHelp.so, libQtNetwork.so, libQtOpenGL.so, libQtScript.so, libQtScriptTools.so, libQtSql.so, libQtSvg.so, libQtTest.so, libQtUiTools.a, libQtWebKit.so, libQtXml.so, libQtXmlPatterns.so, and numerous plugin modules installed in /opt/qt/plugins
Installed Directories: /opt/qt-4.8.0

Short Descriptions

assistant

is a tool for presenting on-line documentation.

designer

is a full-fledged GUI builder. It includes powerful features such as preview mode, automatic widget layout, support for custom widgets, and an advanced property editor.

linguist

provides support for translating applications into local languages.

lrelease

is a simple command line tool. It reads a Qt project file and produces message files used by the application.

lupdate

reads a Qt project file, finds the translatable strings in the specified source, header and Qt Designer interface files, and produces or updates the translation files listed in the project file.

moc

generates Qt meta object support code.

pixeltool

is a desktop magnifier and as you move your mouse around the screen it will show the magnified contents in its window.

qmake

qmake uses information stored in project files to determine what should go in the makefiles it generates.

qt3to4

qt3to4 is a tool to help update Qt3 code to Qt4.

qtconfig

is used to customize the appearance of Qt applications.

qtdemo

is a portal into various demonstrations of Qt applications.

rcc

is a resource compiler used in conjucntion with designer.

uic

is a Qt user interface compiler.

uic3

is a tool to generate Qt4 code out of user interface files generated by the Qt3 version of designer.

Last updated on 2012-01-10 21:25:24 +0000