1 INSTALLING Qt Source Package Version %VERSION%.
3 1. If you have the commercial edition of Qt, install your license
4 file as $HOME/.qt-license if you are on Unix. If you are on
5 Windows, copy the license file into your home directory
6 (this may be known as the userprofile environment variable) and
7 rename it to .qt-license. For example on Windows XP,
8 %USERPROFILE% should be something like C:\Documents and
11 For the open source version you do not need a license file.
13 2. Unpack the archive if you have not done so already:
15 On Unix (X11 and Mac):
17 gunzip %DISTNAME%.tar.gz # uncompress the archive
18 tar xvf %DISTNAME%.tar # unpack it
20 This creates the directory /tmp/%DISTNAME% containing the files
21 from the archive. We only support the GNU version of the tar
22 archiving utility. Note that on some systems it is called gtar.
24 On Windows, uncompress the files into the directory you want Qt
25 installed, e.g. C:\Qt\%VERSION%.
27 NOTE: The install path must not contain any spaces.
29 4. Environment variables
31 In order to build and use Qt, the PATH environment variable needs
32 to be extended to locate qmake, moc and other Qt tools
34 On Windows, this is done by adding C:\Qt\%VERSION%\bin
35 to the PATH variable. On Unix, this is done by adding
38 For newer versions of Windows, PATH can be extended through
39 "Control Panel->System->Advanced->Environment variables" and for
40 older versions by editing C:\autoexec.bat.
42 In .profile (if your Unix shell is bash), add the following lines:
44 PATH=/usr/local/Trolltech/Qt-%VERSION%/bin:$PATH
47 In .login (in case your Unix shell is csh or tcsh), add the following line:
49 setenv PATH /usr/local/Trolltech/Qt-%VERSION%/bin:$PATH
51 If you use a different Unix shell, please modify your environment
52 variables accordingly.
54 For some X11 compilers that do not support rpath you must also
55 extended the LD_LIBRARY_PATH environment variable to include
56 /usr/local/Trolltech/Qt-%VERSION%/lib. On Linux or Mac with GCC
57 this step is not needed.
63 To configure the Qt library for your machine type, run the
64 ./configure script in the package directory.
66 By default, Qt is configured for installation in the
67 /usr/local/Trolltech/Qt-%VERSION% directory, but this can be
68 changed by using the -prefix option. Alternatively, the
69 -prefix-install option can be used to specify a "local"
70 installation within the source directory.
75 Type "./configure -help" to get a list of all available options.
77 To create the library and compile all the demos, examples, tools,
82 If you did not configure Qt using the -prefix-install option,
83 you need to install the library, demos, examples, tools, and
84 tutorials in the appropriate place. To do this, type:
88 and enter the root password. On some systems, you have to use the
89 sudo command as follows:
93 and enter your password, this requires that you have administrator access
96 Note that on some systems the make utility is named differently,
97 e.g. gmake. The configure script tells you which make utility to
100 If you need to reconfigure and rebuild Qt from the same location,
101 ensure that all traces of the previous configuration are removed
102 by entering the build directory and typing
106 before running the configure script again.
108 4.2 Building on Windows
110 To configure the Qt library for your machine type:
116 Type "configure -help" to get a list of all available options.
118 If you are using the "-direct3d" option, make sure that you have
119 the Direct3D SDK installed, and that you have run the
120 %DXSDK_DIR%\Utilities\Bin\dx_setenv.cmd command, before attempting
123 The actual commands needed to build Qt depends on your development
124 system. For Microsoft Visual Studio to create the library and
125 compile all the demos, examples, tools and tutorials type:
129 If you need to reconfigure and rebuild Qt from the same location,
130 ensure that all traces of the previous configuration are removed
131 by entering the build directory and typing
135 before running the configure script again.
137 5. That's all. Qt is now installed.
139 If you are new to Qt, we suggest that you take a look at the demos
140 and examples to see Qt in action. Run the Qt Examples and Demos
141 either by typing 'qtdemo' on the command line or through the
142 desktop's Start menu.
144 You might also want to try the following links:
146 http://qt.nokia.com/doc/%VERSION%/how-to-learn-qt.html
147 http://qt.nokia.com/doc/%VERSION%/tutorial.html
148 http://qt.nokia.com/developer
150 We hope you will enjoy using Qt. Good luck!