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
libjpeg-6b, libmng-1.0.9,
LibTIFF-3.8.2, and libpng-1.2.29
Optional
NAS-1.9, D-BUS-1.0.2, GLib-2.12.12,
OpenSSL-0.9.8g, CUPS-1.2.12, MySQL-5.0.41, PostgreSQL-8.2.4, unixODBC-2.2.12, and SQLite
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
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
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.3.4/
and then creates a symbolic link
to /opt/qt/
.
Install Qt4 by running the
following commands:
./configure -prefix /opt/qt-4.3.4 \
-release \
-nomake examples \
-nomake demos \
-no-separate-debug-info &&
make
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.3.4 /opt/qt
Command Explanations
-release,
-no-separate-debug-info
: These switches minimizes the
time and space used to build Qt4
by not adding debug information to the libraries.
-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
To check if mysql is
autotetected 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.
Update the /etc/ld.so.conf
and
/etc/man_db.conf
files:
cat >> /etc/ld.so.conf << "EOF" &&
# Begin qt addition to /etc/ld.so.conf
/opt/qt/lib
# End qt addition
EOF
ldconfig &&
cat >> /etc/man_db.conf << "EOF"
# Begin qt addition to man_db.conf
MANDATORY_MANPATH /opt/qt/doc/man
# End qt addition to man_db.conf
EOF
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
.
As with most libraries, there is no explicit configuration to do.
After updating /etc/ld.so.conf
as
explained above, run /sbin/ldconfig so that
ldd can find the
shared libraries.