Classes - Annotated - Tree - Functions - Home - Structure

Installing Qt/X11

You may need to be root, depending on the permissions of the directories where you choose to install Qt.

• Unpack the archive if you have not done so already:

          cd /usr/local
          gunzip qt-x11-version.tar.gz     # uncompress the archive
          tar xf qt-x11-version.tar        # unpack it
  

  This creates the directory /usr/local/qt-version containing the files from the main archive.

  Rename qt-version to qt (or make a symlink):

          mv qt-version qt
  

  The rest of this file assumes that Qt is installed in /usr/local/qt.

• Set some environment variables in the file .profile (or .login, depending on your shell) in your home directory. (Create the file if it is not there already.)

  QTDIR	wherever you installed Qt
  PATH	to locate the moc program and other Qt tools
  MANPATH	to access the Qt man pages
  LD_LIBRARY_PATH	for the shared Qt library
  QT_FONTPATH	optional. A list of directories where Qt can find type1 or true type fonts for print embedding.

  This is done like this:

  In .profile (if your shell is bash, ksh, zsh or sh), add the following lines:

          QTDIR=/usr/local/qt
          PATH=$QTDIR/bin:$PATH
          MANPATH=$QTDIR/man:$MANPATH
          LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH
  
          export QTDIR PATH MANPATH LD_LIBRARY_PATH
  

  In .login (in case your shell is csh or tcsh), add the following lines:

          setenv QTDIR /usr/local/qt
          setenv PATH $QTDIR/bin:$PATH
          setenv MANPATH $QTDIR/man:$MANPATH
          setenv LD_LIBRARY_PATH $QTDIR/lib:$LD_LIBRARY_PATH
  

  If you have some true type or type1 fonts installed in non standard places, you might want to set the QT_FONTPATH environment variable to point to these directories. This is not needed, when all fonts are accessed through local font directories or a local font server, as Qt will automatically scan the fontpath and the font servers configuration file. All directories in the fontpath will need to have a valid fonts.dir file, so Qt can map from X11 font names to the corresponding embeddable font.

  After you have done this, you will need to login again, or re-source the profile before continuing, so that at least $QTDIR is set. The installation will give an error message and not proceed otherwise.

• Install your license file. For the free edition, you do not need a license file. For Professional and Enterprise editions, install your license file as described in your distribution.

• Building.

  This step compiles the Qt library, and builds the example programs, the tutorial, and the tools (eg. the Designer).

  Type:

          ./configure
  

  This will configure the Qt library for your machine. Note that GIF support is turned off by default. Run ./configure -help to get a list of configuration options. Read PLATFORMS for a list of supported platforms.

  To create the library and compile all examples and the tutorial:

          make
  

  If your platform or compiler is not supported, read PORTING. If it is supported but you have problems, see http://www.trolltech.com/platforms/

• In very few cases you may need to run /sbin/ldconfig or something similar at this point if you are using shared libraries.

  If you have problems running the example programs, e.g. messages like

           can't load library 'libqt.so.2'
  

  you probably need to put a reference to the qt library in a configuration file and run /sbin/ldconfig as root on your system. And don't forget to set LD_LIBRARY_PATH as explained in 2) above.

• The online HTML documentation is installed in /usr/local/qt/doc/html/ The main page is /usr/local/qt/doc/html/index.html The man pages are installed in /usr/local/qt/doc/man/

You're done. Qt is now installed.