0
|
1 |
/****************************************************************************
|
|
2 |
**
|
|
3 |
** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
|
|
4 |
** All rights reserved.
|
|
5 |
** Contact: Nokia Corporation (qt-info@nokia.com)
|
|
6 |
**
|
|
7 |
** This file is part of the documentation of the Qt Toolkit.
|
|
8 |
**
|
|
9 |
** $QT_BEGIN_LICENSE:LGPL$
|
|
10 |
** No Commercial Usage
|
|
11 |
** This file contains pre-release code and may not be distributed.
|
|
12 |
** You may use this file in accordance with the terms and conditions
|
|
13 |
** contained in the Technology Preview License Agreement accompanying
|
|
14 |
** this package.
|
|
15 |
**
|
|
16 |
** GNU Lesser General Public License Usage
|
|
17 |
** Alternatively, this file may be used under the terms of the GNU Lesser
|
|
18 |
** General Public License version 2.1 as published by the Free Software
|
|
19 |
** Foundation and appearing in the file LICENSE.LGPL included in the
|
|
20 |
** packaging of this file. Please review the following information to
|
|
21 |
** ensure the GNU Lesser General Public License version 2.1 requirements
|
|
22 |
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
|
|
23 |
**
|
|
24 |
** In addition, as a special exception, Nokia gives you certain additional
|
|
25 |
** rights. These rights are described in the Nokia Qt LGPL Exception
|
|
26 |
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
|
|
27 |
**
|
|
28 |
** If you have questions regarding the use of this file, please contact
|
|
29 |
** Nokia at qt-info@nokia.com.
|
|
30 |
**
|
|
31 |
**
|
|
32 |
**
|
|
33 |
**
|
|
34 |
**
|
|
35 |
**
|
|
36 |
**
|
|
37 |
**
|
|
38 |
** $QT_END_LICENSE$
|
|
39 |
**
|
|
40 |
****************************************************************************/
|
|
41 |
|
|
42 |
/*!
|
|
43 |
\group platform-specific
|
|
44 |
\title Platform-Specific Documentation
|
|
45 |
\brief Documents describing platform-specific features of Qt.
|
|
46 |
|
|
47 |
These documents describe platform-specific features provided by Qt, and
|
|
48 |
discuss issues related to particular platforms and environments.
|
|
49 |
|
|
50 |
\generatelist{related}
|
|
51 |
*/
|
|
52 |
|
|
53 |
/*!
|
|
54 |
\page platform-notes.html
|
|
55 |
\ingroup platform-specific
|
|
56 |
\title Platform Notes
|
|
57 |
\brief Information about the platforms on which Qt can be used.
|
|
58 |
|
|
59 |
This page contains information about the platforms Qt is currently known
|
|
60 |
to run on, with links to platform-specific notes, including any known bugs
|
|
61 |
or incompatibilities.
|
|
62 |
|
|
63 |
\list
|
|
64 |
\o \l{Platform Notes - X11}
|
|
65 |
\tableofcontents{1 Platform Notes - X11}
|
|
66 |
\o \l{Platform Notes - Windows}
|
|
67 |
\tableofcontents{1 Platform Notes - Windows}
|
|
68 |
\o \l{Platform Notes - Mac OS X}
|
|
69 |
\tableofcontents{1 Platform Notes - Mac OS X}
|
|
70 |
\o \l{Platform Notes - Symbian}
|
|
71 |
\tableofcontents{1 Platform Notes - Symbian}
|
|
72 |
\o \l{Platform Notes - Embedded Linux}
|
|
73 |
\tableofcontents{1 Platform Notes - Embedded Linux}
|
|
74 |
\o \l{Platform Notes - Windows CE}
|
|
75 |
\tableofcontents{1 Platform Notes - Windows CE}
|
|
76 |
\o \l{Platform Notes - QNX}
|
|
77 |
\tableofcontents{1 Platform Notes - QNX}
|
|
78 |
\o \l{Platform Notes - VxWorks}
|
|
79 |
\tableofcontents{1 Platform Notes - VxWorks}
|
|
80 |
\endlist
|
|
81 |
|
|
82 |
See also the \l{Compiler Notes} for information about compiler-specific
|
|
83 |
build issues. Information about the combinations of platforms and compilers
|
|
84 |
supported by Qt can be found on the \l{Supported Platforms} page.
|
|
85 |
|
|
86 |
If you have anything to add to this list or any of the platform or
|
|
87 |
compiler-specific pages, please submit it via the \l{Bug Report Form}
|
|
88 |
or through the \l{Public Qt Repository}.
|
|
89 |
*/
|
|
90 |
|
|
91 |
/*!
|
|
92 |
\page platform-notes-x11.html
|
|
93 |
\title Platform Notes - X11
|
|
94 |
\contentspage Platform Notes
|
|
95 |
|
|
96 |
This page contains information about the X11 platforms Qt is currently
|
|
97 |
known to run on, with links to platform-specific notes. More information
|
|
98 |
about the combinations of platforms and compilers supported by Qt can be
|
|
99 |
found on the \l{Supported Platforms} page.
|
|
100 |
|
|
101 |
\tableofcontents
|
|
102 |
|
|
103 |
\target AIX
|
|
104 |
\section1 AIX - 5.2
|
|
105 |
|
|
106 |
Qt has been tested on AIX 5.2, using the
|
|
107 |
\l{Compiler Notes#IBM xlC (AIX)}{xlC} compiler.
|
|
108 |
|
|
109 |
\table
|
|
110 |
\header \o Compiler \o Notes
|
|
111 |
\row \o xlC
|
|
112 |
\o If Qt is built correctly but all symbols are reported to be missing
|
|
113 |
when you link an application, your makeC++SharedLib script might be out
|
|
114 |
of date. Make sure you have the latest version from the
|
|
115 |
\l{http://www-306.ibm.com/software/awdtools/vacpp/support/}{IBM website}.
|
|
116 |
\row \o GCC
|
|
117 |
\o We have tested earlier versions of Qt 4 successfully with GCC version
|
|
118 |
3.3 and above. Some versions of GCC may fail to link Qt with a "TOC overflow"
|
|
119 |
message.
|
|
120 |
Fix this by upgrading to the latest maintenance release of the dynamic
|
|
121 |
linker. On AIX this is bos.rte.bind_cmds.4.1.5.3 or later.
|
|
122 |
Some versions of GCC may fail to build Qt with STL and large-file support
|
|
123 |
enabled, due to
|
|
124 |
\l{http://gcc.gnu.org/bugzilla/show_bug.cgi?id=9551}{a bug in GCC}.
|
|
125 |
Fix this by upgrading to the latest maintenance release of the compiler.
|
|
126 |
It is also possible to work around this problem by running configure with
|
|
127 |
either \c{-no-stl} or \c{-no-largefile}.
|
|
128 |
\endtable
|
|
129 |
|
|
130 |
\target FreeBSD
|
|
131 |
\section1 FreeBSD - 6.0-RELEASE
|
|
132 |
|
|
133 |
\note FreeBSD is a community supported platform. See the
|
|
134 |
\l{Supported Platforms} page for more information.
|
|
135 |
|
|
136 |
The system compiler on FreeBSD 4.x is gcc 2.95.4, which is not
|
|
137 |
officially supported by Qt 4. We develop using and recommend
|
|
138 |
ports/lang/gcc34. You will need to run configure with the
|
|
139 |
\c{-platform freebsd-g++34} arguments. Optionally, you may use
|
|
140 |
ports/lang/icc.
|
|
141 |
|
|
142 |
The system compiler on FreeBSD 5.x and 6.x is GCC 3.4.4, which should be
|
|
143 |
sufficient to build Qt. You do not need to add any special arguments when
|
|
144 |
running configure. Optionally, you may use ports/lang/icc.
|
|
145 |
|
|
146 |
Note that we do not actively test FreeBSD 4.x and 5.x. Our developers
|
|
147 |
migrated to 6.x after the Qt 4 launch. FreeBSD-CURRENT is not supported.
|
|
148 |
|
|
149 |
\target HP-UX
|
|
150 |
\section1 HP-UX
|
|
151 |
|
|
152 |
Qt supports HP-UX on both PA-RISC and the Itanium (IA64) architectures.
|
|
153 |
|
|
154 |
\section2 PA-RISC - B.11.11 or later
|
|
155 |
|
|
156 |
You can configure Qt for aCC in 32 and 64 bit mode (hpux-acc-64 or
|
|
157 |
hpux-acc-32), or gcc in 32 bit mode (hpux-g++). The default platform is
|
|
158 |
hpux-acc-32. The minimum required version for aCC (HP ANSI C++) on PA-RISC
|
|
159 |
is A.03.57. The supported gcc compiler is gcc 3.4.3.
|
|
160 |
|
|
161 |
\section2 Itanium - B.11.23 or later
|
|
162 |
|
|
163 |
You can configure Qt for aCC in 32 and 64 bit mode (hpuxi-acc-64 or
|
|
164 |
hpuxi-acc-32). gcc is currently unsupported. The default platform is
|
|
165 |
hpuxi-acc-64. The minimum required version for aCC (HP ANSI C++) on
|
|
166 |
Itanium is A.06.12.
|
|
167 |
|
|
168 |
\section2 OpenGL Support
|
|
169 |
|
|
170 |
Qt's \l{QtOpenGL}{OpenGL} module requires GLX 1.3 or later to be installed.
|
|
171 |
This is available for HP-UX 11i - see the
|
|
172 |
\l{http://docs.hp.com/en/5992-2331/ch04s02.html}{Graphics and Technical Computing Software}
|
|
173 |
section of the release notes for more information.
|
|
174 |
|
|
175 |
\target IRIX
|
|
176 |
\section1 IRIX - 6.5.x
|
|
177 |
|
|
178 |
\bold{IRIX is an unsupported platform - please see Qt's online
|
|
179 |
\l{Platform Support Policy} for details.}
|
|
180 |
|
|
181 |
Unpackaging and IRIX tar:
|
|
182 |
Because of long filenames some files will be cut off incorrectly with IRIX
|
|
183 |
tar. Please use GNU tar to unpack Qt packages.
|
|
184 |
|
|
185 |
\section1 Linux
|
|
186 |
|
|
187 |
There are no known problems with using Qt on production versions of
|
|
188 |
Linux/x86, Linux/ppc, Linux/amd64 and Linux/ia64 (including Altix(R)).
|
|
189 |
|
|
190 |
For the gcc/g++ compiler, please also see the relevant
|
|
191 |
\l{Compiler Notes#GCC}{compiler page}.
|
|
192 |
|
|
193 |
\section2 Installation problems
|
|
194 |
|
|
195 |
See also the \l{Installation FAQ}.
|
|
196 |
|
|
197 |
If you experience problems when installing new open source versions of Qt
|
|
198 |
versions, try to use the open source Qt archives (e.g., RPM)
|
|
199 |
provided by your Linux distribution. If you need to install the source (.tgz)
|
|
200 |
archive, be aware that you will probably end up with two different
|
|
201 |
versions of the Qt library installed on your system, which will probably
|
|
202 |
lead to link errors, like this:
|
|
203 |
\snippet doc/src/snippets/code/doc_src_platform-notes.qdoc 0
|
|
204 |
Fix this by removing the old version of the library.
|
|
205 |
|
|
206 |
If you have problems installing open source versions of Qt
|
|
207 |
provided by your Linux distribution (e.g., RPM), please consult the
|
|
208 |
maintainers of the distribution, not us.
|
|
209 |
|
|
210 |
Some RPM versions have problems installing some of the Qt RPM archives
|
|
211 |
where installation stops with an error message warning about a
|
|
212 |
"Failed Dependency". Use the \c{--nodeps} option to \c rpm to workaround
|
|
213 |
this problem.
|
|
214 |
|
|
215 |
\target Solaris
|
|
216 |
\section1 Solaris - 9 or later
|
|
217 |
|
|
218 |
\section2 Unpackaging and Solaris tar
|
|
219 |
|
|
220 |
On some Solaris systems, both Solaris tar and GNU tar have been reported
|
|
221 |
to truncate long filenames. We recommend using star instead
|
|
222 |
(http://star.berlios.de).
|
|
223 |
|
|
224 |
\section2 CC on Solaris
|
|
225 |
|
|
226 |
Be sure to check our \l{Compiler Notes#Sun Studio}{Forte Developer / Sun Studio}
|
|
227 |
notes.
|
|
228 |
|
|
229 |
\section2 GCC on Solaris
|
|
230 |
|
|
231 |
Be sure to check the installation notes for \l{GCC on Solaris}.
|
|
232 |
Do not use GCC with Sun's assembler/linker, this will result in link-time
|
|
233 |
errors in shared libraries. Use GNU binutils instead.
|
|
234 |
|
|
235 |
GCC 3.2.* is known to miscompile Qt due to an optimizer bug that will
|
|
236 |
cause the resulting binaries to hang. Please use GCC 3.4.2 or later.
|
|
237 |
*/
|
|
238 |
|
|
239 |
/*!
|
|
240 |
\page platform-notes-windows.html
|
|
241 |
\title Platform Notes - Windows
|
|
242 |
\contentspage Platform Notes
|
|
243 |
|
|
244 |
This page contains information about the Windows platforms Qt is currently
|
|
245 |
known to run on, with links to platform-specific notes. More information
|
|
246 |
about the combinations of platforms and compilers supported by Qt can be
|
|
247 |
found on the \l{Supported Platforms} page.
|
|
248 |
|
|
249 |
\tableofcontents
|
|
250 |
|
|
251 |
\section1 Windows Vista
|
|
252 |
|
|
253 |
At the time Qt %VERSION% was released, there were no known Vista-specific issues.
|
|
254 |
|
|
255 |
\target Windows NT
|
|
256 |
\section1 Windows XP, Windows 2000 and Windows NT
|
|
257 |
|
|
258 |
\section2 Installation location
|
|
259 |
|
|
260 |
Installing Qt into a directory with spaces, e.g. C:\\Program Files, may
|
|
261 |
cause linker errors like the following:
|
|
262 |
\snippet doc/src/snippets/code/doc_src_platform-notes.qdoc 2
|
|
263 |
|
|
264 |
Install Qt into a subdirectory without spaces to avoid this problem.
|
|
265 |
|
|
266 |
\section2 AccelGALAXY graphic card
|
|
267 |
|
|
268 |
When you use a NT 4.0 machine with the driver number
|
|
269 |
4,00,1381,1000,021,4.0.0 there is a problem with drag an drop and icons.
|
|
270 |
The computer freezes, and you have to reset. The problem disappears with
|
|
271 |
the newest version of the driver, available at
|
|
272 |
\l{http://www.es.com/}{www.es.com}.
|
|
273 |
|
|
274 |
\section2 Possible GL conflict
|
|
275 |
|
|
276 |
There is a known issue with running Microsoft NetMeeting, Lotus SameTime
|
|
277 |
and other applications that require screen grabbing while direct
|
|
278 |
rendering is enabled. Other GL-applications may not work as expected,
|
|
279 |
unless direct rendering is disabled.
|
|
280 |
*/
|
|
281 |
|
|
282 |
/*!
|
|
283 |
\page platform-notes-mac.html
|
|
284 |
\title Platform Notes - Mac OS X
|
|
285 |
\contentspage Platform Notes
|
|
286 |
|
|
287 |
This page contains information about the Mac OS X versions Qt is currently
|
|
288 |
known to run on, with links to platform-specific notes. More information
|
|
289 |
about the combinations of platforms and compilers supported by Qt can be
|
|
290 |
found on the \l{Supported Platforms} page.
|
|
291 |
|
|
292 |
\tableofcontents
|
|
293 |
|
|
294 |
\section1 General Information
|
|
295 |
|
|
296 |
Qt 4.4 and Qt 4.5 development is only supported on Mac OS X 10.4 and up.
|
|
297 |
Applications built against these version of Qt can be deployed on Mac OS X
|
|
298 |
10.3, but cannot be developed on that version of the operating system due
|
|
299 |
to compiler issues.
|
|
300 |
|
|
301 |
Qt 4.3 has been tested to run on Mac OS X 10.3.9 and up. See notes on
|
|
302 |
the binary package for more information.
|
|
303 |
|
|
304 |
Qt 4.1 has been tested to run on Mac OS X 10.2.8 and up. Qt 4.1.4 is the
|
|
305 |
last release to work with Mac OS X 10.2.
|
|
306 |
|
|
307 |
\section2 Required GCC version
|
|
308 |
|
|
309 |
Apple's gcc 4 that is shipped with the Xcode Tools for both Mac OS X 10.4
|
|
310 |
and 10.5 will compile Qt. There is preliminary support for gcc 4.2 which
|
|
311 |
is included with Xcode Tools 3.1+ (configurable with
|
|
312 |
\c{-platform macx-g++42}).
|
|
313 |
|
|
314 |
\section2 Binary Package
|
|
315 |
|
|
316 |
The binary package requires that you have your .qt-license file in your
|
|
317 |
home directory. Installer.app cannot complete without a valid .qt-license
|
|
318 |
file. Evaluation users of Qt will have information about how to create
|
|
319 |
this file in the email they receive.
|
|
320 |
|
|
321 |
The binary package was built on Mac OS X 10.4 with Xcode Tools 2.1
|
|
322 |
(gcc 4.0.0) for Qt 4.1.0, Xcode Tools 2.2 (gcc 4.0.1) for Qt 4.1.1-4.1.4
|
|
323 |
and Xcode Tools 2.3 for 4.2.0. It will only link executables built
|
|
324 |
against 10.4 (or a 10.4 SDK). You should be able to run applications
|
|
325 |
linked against these frameworks on Mac OS X 10.3.9 and Mac OS X 10.4+.
|
|
326 |
If you require a different configuration, you will have to use the
|
|
327 |
source package and build with GCC 3.3.
|
|
328 |
|
|
329 |
\section2 Mac OS X on Intel hardware
|
|
330 |
|
|
331 |
Qt 4 fully supports both the Intel and PowerPC architectures on the Mac.
|
|
332 |
As of Qt 4.1 it is possible to support the Intel architecture by
|
|
333 |
creating Universal Binaries with qmake. As of Qt 4.1 it is possible to
|
|
334 |
build Qt as a set of universal binaries and frameworks from configure by
|
|
335 |
adding these extra flags:
|
|
336 |
|
|
337 |
\snippet doc/src/snippets/code/doc_src_platform-notes.qdoc 3
|
|
338 |
|
|
339 |
If you are building on Intel hardware you can omit the sdk parameter, but
|
|
340 |
PowerPC hardware requires it.
|
|
341 |
|
|
342 |
You can also generate universal binaries using qmake. Simply add these
|
|
343 |
lines to your .pro file:
|
|
344 |
|
|
345 |
\snippet doc/src/snippets/code/doc_src_platform-notes.qdoc 4
|
|
346 |
|
|
347 |
\section2 Build Issues
|
|
348 |
|
|
349 |
If Qt does not build upon executing make, and fails with an error message
|
|
350 |
such as
|
|
351 |
|
|
352 |
\snippet doc/src/snippets/code/doc_src_platform-notes.qdoc 5
|
|
353 |
|
|
354 |
this could be an indication you have upgraded your version of Mac OS X
|
|
355 |
(e.g. 10.3 to 10.4), without upgrading your Developer Tools (Xcode Tools).
|
|
356 |
These must match in order to successfully compile files.
|
|
357 |
|
|
358 |
Please be sure to upgrade both simultaneously. If problems still occur,
|
|
359 |
contact support.
|
|
360 |
|
|
361 |
\section2 Fink
|
|
362 |
|
|
363 |
If you have installed the Qt for X11 package from \l{Fink},
|
|
364 |
it will set the QMAKESPEC environment variable to darwin-g++. This will
|
|
365 |
cause problems when you build the Qt for Mac OS X package. To fix this, simply
|
|
366 |
unset your QMAKESPEC or set it to macx-g++ before you run configure.
|
|
367 |
You need to have a fresh Qt distribution (make confclean).
|
|
368 |
|
|
369 |
\section2 MySQL and Mac OS X
|
|
370 |
|
|
371 |
There seems to be a issue when both -prebind and -multi_module are
|
|
372 |
defined when linking static C libraries into dynamic library. If you
|
|
373 |
get the following error message when linking Qt:
|
|
374 |
|
|
375 |
\snippet doc/src/snippets/code/doc_src_platform-notes.qdoc 6
|
|
376 |
|
|
377 |
re-link Qt using -single_module. This is only a problem when building the
|
|
378 |
MySQL driver into Qt. It does not affect plugins or static builds.
|
|
379 |
|
|
380 |
\section2 Qt and Precompiled Headers (PCH)
|
|
381 |
|
|
382 |
Starting with Qt 3.3.0 it is possible to use precompiled headers. They
|
|
383 |
are not enabled by default as it appears that some versions of Apple's
|
|
384 |
GCC and make have problems with this feature. If you want to use
|
|
385 |
precompiled headers when building the Qt source package, specify the
|
|
386 |
-pch option to configure. If, while using precompiled headers, you
|
|
387 |
encounter an internal compile error, try removing the -include header
|
|
388 |
statement from the compile line and trying again. If this solves the
|
|
389 |
problem, it probably is a good idea to turn off precompiled headers.
|
|
390 |
Also, consider filing a bug report with Apple so that they can
|
|
391 |
improve support for this feature.
|
|
392 |
*/
|
|
393 |
|
|
394 |
/*!
|
|
395 |
\page platform-notes-windows-ce.html
|
|
396 |
\title Platform Notes - Windows CE
|
|
397 |
\contentspage Platform Notes
|
|
398 |
|
|
399 |
This page contains information about the Windows CE and Windows Mobile
|
|
400 |
platforms Qt is currently known to run on, with links to platform-specific
|
|
401 |
notes. More information about the combinations of platforms and compilers
|
|
402 |
supported by Qt can be found on the \l{Supported Platforms} page.
|
|
403 |
*/
|
|
404 |
|
|
405 |
/*!
|
|
406 |
\page platform-notes-symbian.html
|
|
407 |
\title Platform Notes - Symbian
|
|
408 |
\contentspage Platform Notes
|
|
409 |
|
|
410 |
This page contains information about the Symbian platforms Qt is currently known
|
|
411 |
to run on. More information about the combinations of platforms and compilers
|
|
412 |
supported by Qt can be found on the \l{Supported Platforms} page.
|
|
413 |
|
|
414 |
For information about mixing exceptions with Symbian leaves,
|
|
415 |
see \l{Exception Safety with Symbian}
|
|
416 |
|
|
417 |
\section1 Multimedia and Phonon Support
|
|
418 |
|
|
419 |
Qt provides a backend for Qt's multimedia module, Phonon, which supports
|
|
420 |
video and sound playback through Symbian's Multimedia Framework, MMF.
|
|
421 |
|
|
422 |
In this release the support is experimental. Video playback may have
|
|
423 |
flickering issues, and support for effects and playback queueing is
|
|
424 |
incomplete.
|
|
425 |
|
|
426 |
The audio and video formats that Phonon supports depends on what support
|
|
427 |
the platform provides for MMF. The emulator is known to have limited
|
|
428 |
codec support.
|
|
429 |
|
|
430 |
In addition, there exists a backend for the Helix framework. However, due
|
|
431 |
to it not shipping with Qt, its availability depends on the Symbian
|
|
432 |
platform in use. If available, it is loaded instead of the MMF plugin.
|
|
433 |
|
|
434 |
*/
|
|
435 |
|
|
436 |
/*!
|
|
437 |
\page platform-notes-embedded-linux.html
|
|
438 |
\title Platform Notes - Embedded Linux
|
|
439 |
\contentspage Platform Notes
|
|
440 |
|
|
441 |
This page contains information about the Embedded Linux platforms Qt is
|
|
442 |
currently known to run on, with links to platform-specific notes. More
|
|
443 |
information about the combinations of platforms and compilers supported
|
|
444 |
by Qt can be found on the \l{Supported Platforms} page.
|
|
445 |
*/
|