source: branches/vendor/trolltech/qt/current/INSTALL @ 2

Last change on this file since 2 was 2, checked in by Dmitry A. Kuminov, 12 years ago

Initially imported qt-all-opensource-src-4.5.1 from Trolltech.

File size: 5.0 KB
Line 
1                  INSTALLING Qt/All Source Version 4.5.1.
2
31.  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 2000,
8    %USERPROFILE% should be something like C:\Documents and
9    Settings\username.
10
11    For the open source version you do not need a license file.
12
132.  Unpack the archive if you have not done so already:
14
15    On Unix (X11 and Mac):
16        cd /tmp
17        gunzip %DISTNAME%.tar.gz        # uncompress the archive
18        tar xvf %DISTNAME%.tar          # unpack it
19
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.
23
24    On Windows, uncompress the files into the directory you want Qt
25    installed, e.g. C:\Qt\4.5.1.
26
27    NOTE: The install path must not contain any spaces.
28
294. Environment variables
30
31   In order to build and use Qt, the PATH environment variable needs
32   to be extended:
33
34        PATH               - to locate qmake, moc and other Qt tools
35
36   On Windows, this is done by adding c:\Qt\4.5.1\bin
37   to the PATH variable. On Unix, this is done by adding
38   /tmp/%DISTNAME%.
39
40   For newer versions of Windows, PATH can be extended through
41   "Control Panel->System->Advanced->Environment variables" and for
42   older versions by editing c:\autoexec.bat.
43
44   In .profile (if your Unix shell is bash), add the following lines:
45
46        PATH=/usr/local/Trolltech/Qt-4.5.1/bin:$PATH
47        export PATH
48
49   In .login (in case your Unix shell is csh or tcsh), add the following line:
50
51        setenv PATH /usr/local/Trolltech/Qt-4.5.1/bin:$PATH
52
53   If you use a different Unix shell, please modify your environment
54   variables accordingly.
55
56   For some X11 compilers that do not support rpath you must also
57   extended the LD_LIBRARY_PATH environment variable to include
58   /usr/local/Trolltech/Qt-4.5.1/lib. On Linux or Mac with GCC
59   this step is not needed.
60
614.  Building
62
634.1 Building on Unix
64
65    To configure the Qt library for your machine type, run the
66    ./configure script in the package directory.
67
68    By default, Qt is configured for installation in the
69    /usr/local/Trolltech/Qt-4.5.1 directory, but this can be
70    changed by using the -prefix option. Alternatively, the
71    -prefix-install option can be used to specify a "local"
72    installation within the source directory.
73
74        cd /tmp/%DISTNAME%
75        ./configure
76
77    Type "./configure -help" to get a list of all available options.
78
79    To create the library and compile all the demos, examples, tools,
80    and tutorials, type:
81
82        make
83
84    If you did not configure Qt using the -prefix-install option,
85    you need to install the library, demos, examples, tools, and
86    tutorials in the appropriate place. To do this, type:
87
88        su -c "make install"
89
90    and enter the root password. On some systems, you have to use the
91    sudo command as follows:
92
93        sudo make install
94
95    and enter your password, this requires that you have administrator access
96    to your machine.
97
98    Note that on some systems the make utility is named differently,
99    e.g. gmake. The configure script tells you which make utility to
100    use.
101
102    If you need to reconfigure and rebuild Qt from the same location,
103    ensure that all traces of the previous configuration are removed
104    by entering the build directory and typing
105
106        make confclean
107
108    before running the configure script again.
109
1104.2 Building on Windows
111
112    To configure the Qt library for your machine type:
113
114        C:
115        cd \Qt\4.5.1
116        configure
117
118    Type "configure -help" to get a list of all available options.
119
120    If you are using the "-direct3d" option, make sure that you have
121    the Direct3D SDK installed, and that you have run the
122    %DXSDK_DIR%\Utilities\Bin\dx_setenv.cmd command, before attempting
123    to run configure.
124
125    The actual commands needed to build Qt depends on your development
126    system. For Microsoft Visual Studio to create the library and
127    compile all the demos, examples, tools and tutorials type:
128
129        nmake
130
131    If you need to reconfigure and rebuild Qt from the same location,
132    ensure that all traces of the previous configuration are removed
133    by entering the build directory and typing
134
135        nmake confclean
136
137    before running the configure script again.
138
1395.  That's all. Qt is now installed.
140
141    If you are new to Qt, we suggest that you take a look at the demos
142    and examples to see Qt in action. Run the Qt Examples and Demos
143    either by typing 'qtdemo' on the command line or through the
144    desktop's Start menu.
145
146    You might also want to try the following links:
147
148        http://doc.trolltech.com/4.5.1/how-to-learn-qt.html
149        http://doc.trolltech.com/4.5.1/tutorial.html
150        http://qtsoftware.com/developer
151
152    We hope you will enjoy using Qt. Good luck!
Note: See TracBrowser for help on using the repository browser.