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