|  | Home · All Classes · Main Classes · Grouped Classes · Modules · Functions |

# Installing Qt/Mac

1. If you have the commercial edition of Qt, install your license file as `$HOME/.qt-license`.

   For the open source version you do not need a license file.

2. Unpack the archive if you have not done so already. For example, if you have the `qt-mac-opensource-desktop-4.0.1.tar.gz` package, type the following commands at a command line prompt:

           cd /tmp
           gunzip qt-mac-opensource-desktop-4.0.1.tar.gz        # uncompress the archive
           tar xvf qt-mac-opensource-desktop-4.0.1.tar          # unpack it

   This creates the directory `/tmp/qt-mac-opensource-desktop-4.0.1` containing the files from the archive.

3. Building

   To configure the Qt library for your machine type:

           cd /tmp/qt-x11-opensource-src-4.0.1
           ./configure

   Type `./configure -help` to get a list of all available options.

   To create the library and compile all the demos, examples, tools, and tutorials, type:

               make

   To install the library, demos, examples, tools, and tutorials, type:

               su -c "make install"

   and enter the root password. Qt is by default installed into `/usr/local/Trolltech/Qt-4.0.1` but this can be changed by using the `-prefix` parameter.

4. Environment variables

   In order to use Qt, some environment variables need to be extended.

               PATH               - to locate qmake, moc and other Qt tools

   This is done like this:

   In `.profile` (if your shell is bash), add the following lines:

               PATH=/usr/local/Trolltech/Qt-4.0.1/bin:$PATH
               export PATH

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

               setenv PATH /usr/local/Trolltech/Qt-4.0.1/bin:$PATH

   If you use a different shell, please modify your environment variables accordingly.

5. That's all. Qt is now installed.

   If you are new to Qt, we suggest that you take a look at the demos and examples to see Qt in action. Run the Qt Examples and Demos either by typing `qtdemo` on the command line or through the desktop's Start menu.

   You might also want to try the following links:

   - How to Learn Qt
   - Qt Tutorial
   - http://www.trolltech.com/developer

We hope you will enjoy using Qt. Good luck!