Home | All Classes | Main Classes | Annotated | Grouped Classes | Functions

Installing Qt/X11

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

  1. 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.

  2. 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.

    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
    

    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.

    On AIX set LIBPATH and on HP-UX set SHLIB_PATH instead of LD_LIBRARY_PATH.

    Note that the SGI MIPSpro o32 and Sun WorkShop 5.0 targets are no longer supported as of Qt 3.3.

  3. Install your license file as $HOME/.qt-license. For the free edition and evaluation version, you do not need a license file.

  4. Compile the Qt library, and build the example programs, the tutorial and the tools (e.g. Qt Designer) as follows.

    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 you have problems, see http://www.trolltech.com/platforms/.

  5. 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.

  6. 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/. The documentation is also accessible using Qt Assistant.

You're done. Qt is now installed.


Copyright © 2007 TrolltechTrademarks
Qt 3.3.8