|
1 | 1 | INSTALLING Qt Source Package Version %VERSION%. |
2 | 2 |
|
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 |
9 | | - Settings\username. |
| 3 | +For full installation instructions for each supported platform, please |
| 4 | +see http://qt.nokia.com/doc/%VERSION%/installation.html, the file |
| 5 | +doc/html/installation.html in this package, or follow one of the following |
| 6 | +links: |
| 7 | + |
| 8 | +Embedded Linux: http://qt.nokia.com/doc/%VERSION%/qt-embedded-install.html |
| 9 | +Mac OS X: http://qt.nokia.com/doc/%VERSION%/install-mac.html |
| 10 | +Windows: http://qt.nokia.com/doc/%VERSION%/install-win.html |
| 11 | +Windows CE: http://qt.nokia.com/doc/%VERSION%/install-wince.html |
| 12 | +X11 Platforms: http://qt.nokia.com/doc/%VERSION%/install-x11.html |
| 13 | +Symbian Platform: http://qt.nokia.com/doc/%VERSION%/install-symbian.html |
10 | 14 |
|
11 | | - For the open source version you do not need a license file. |
12 | | - |
13 | | -2. 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\%VERSION%. |
26 | | - |
27 | | - NOTE: The install path must not contain any spaces. |
28 | | - |
29 | | -4. Environment variables |
30 | | - |
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 |
33 | | - |
34 | | - On Windows, this is done by adding C:\Qt\%VERSION%\bin |
35 | | - to the PATH variable. On Unix, this is done by adding |
36 | | - /tmp/%DISTNAME%. |
37 | | - |
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. |
41 | | - |
42 | | - In .profile (if your Unix shell is bash), add the following lines: |
43 | | - |
44 | | - PATH=/usr/local/Trolltech/Qt-%VERSION%/bin:$PATH |
45 | | - export PATH |
46 | | - |
47 | | - In .login (in case your Unix shell is csh or tcsh), add the following line: |
48 | | - |
49 | | - setenv PATH /usr/local/Trolltech/Qt-%VERSION%/bin:$PATH |
50 | | - |
51 | | - If you use a different Unix shell, please modify your environment |
52 | | - variables accordingly. |
53 | | - |
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. |
58 | | - |
59 | | -4. Building |
60 | | - |
61 | | -4.1 Building on Unix |
62 | | - |
63 | | - To configure the Qt library for your machine type, run the |
64 | | - ./configure script in the package directory. |
65 | | - |
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. |
69 | | - |
70 | | - cd /tmp/%DISTNAME% |
71 | | - ./configure |
72 | | - |
73 | | - Type "./configure -help" to get a list of all available options. |
74 | | - |
75 | | - To create the library and compile all the demos, examples, tools, |
76 | | - and tutorials, type: |
77 | | - |
78 | | - make |
79 | | - |
80 | | - If you did not configure Qt using the -prefix-install option, |
81 | | - you need to install the library, demos, examples, tools, and |
82 | | - tutorials in the appropriate place. To do this, type: |
83 | | - |
84 | | - su -c "make install" |
85 | | - |
86 | | - and enter the root password. On some systems, you have to use the |
87 | | - sudo command as follows: |
88 | | - |
89 | | - sudo make install |
90 | | - |
91 | | - and enter your password, this requires that you have administrator access |
92 | | - to your machine. |
93 | | - |
94 | | - Note that on some systems the make utility is named differently, |
95 | | - e.g. gmake. The configure script tells you which make utility to |
96 | | - use. |
97 | | - |
98 | | - If you need to reconfigure and rebuild Qt from the same location, |
99 | | - ensure that all traces of the previous configuration are removed |
100 | | - by entering the build directory and typing |
101 | | - |
102 | | - make confclean |
103 | | - |
104 | | - before running the configure script again. |
105 | | - |
106 | | -4.2 Building on Windows |
107 | | - |
108 | | - To configure the Qt library for your machine type: |
109 | | - |
110 | | - C: |
111 | | - cd \Qt\%VERSION% |
112 | | - configure |
113 | | - |
114 | | - Type "configure -help" to get a list of all available options. |
115 | | - |
116 | | - If you are using the "-direct3d" option, make sure that you have |
117 | | - the Direct3D SDK installed, and that you have run the |
118 | | - %DXSDK_DIR%\Utilities\Bin\dx_setenv.cmd command, before attempting |
119 | | - to run configure. |
120 | | - |
121 | | - The actual commands needed to build Qt depends on your development |
122 | | - system. For Microsoft Visual Studio to create the library and |
123 | | - compile all the demos, examples, tools and tutorials type: |
124 | | - |
125 | | - nmake |
126 | | - |
127 | | - If you need to reconfigure and rebuild Qt from the same location, |
128 | | - ensure that all traces of the previous configuration are removed |
129 | | - by entering the build directory and typing |
130 | | - |
131 | | - nmake confclean |
132 | | - |
133 | | - before running the configure script again. |
134 | | - |
135 | | -5. That's all. Qt is now installed. |
136 | | - |
137 | | - If you are new to Qt, we suggest that you take a look at the demos |
138 | | - and examples to see Qt in action. Run the Qt Examples and Demos |
139 | | - either by typing 'qtdemo' on the command line or through the |
140 | | - desktop's Start menu. |
141 | | - |
142 | | - You might also want to try the following links: |
143 | | - |
144 | | - http://qt.nokia.com/doc/%VERSION%/how-to-learn-qt.html |
145 | | - http://qt.nokia.com/doc/%VERSION%/tutorial.html |
146 | | - http://qt.nokia.com/developer |
147 | | - |
148 | | - We hope you will enjoy using Qt. Good luck! |
0 commit comments