source: trunk/doc/html/install-mac.html

Last change on this file was 190, checked in by rudi, 14 years ago

reference documentation added

File size: 5.2 KB
Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/doc/installation.doc:179 -->
3<html>
4<head>
5<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
6<title>Installing Qt/Mac</title>
7<style type="text/css"><!--
8fn { margin-left: 1cm; text-indent: -1cm; }
9a:link { color: #004faf; text-decoration: none }
10a:visited { color: #672967; text-decoration: none }
11body { background: #ffffff; color: black; }
12--></style>
13</head>
14<body>
15
16<table border="0" cellpadding="0" cellspacing="0" width="100%">
17<tr bgcolor="#E5E5E5">
18<td valign=center>
19 <a href="index.html">
20<font color="#004faf">Home</font></a>
21 | <a href="classes.html">
22<font color="#004faf">All&nbsp;Classes</font></a>
23 | <a href="mainclasses.html">
24<font color="#004faf">Main&nbsp;Classes</font></a>
25 | <a href="annotated.html">
26<font color="#004faf">Annotated</font></a>
27 | <a href="groups.html">
28<font color="#004faf">Grouped&nbsp;Classes</font></a>
29 | <a href="functions.html">
30<font color="#004faf">Functions</font></a>
31</td>
32<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Installing Qt/Mac</h1>
33
34
35<p> You may need to be logged in as root, depending on the permissions of
36the directories where you choose to install Qt.
37<p> <ol type=1>
38<li> Unpack the archive if you have not done so already:
39<p> <pre>
40 cd /Developer
41 gnutar xzf qt-mac-version.tar.gz
42</pre>
43
44<p> This creates the directory /Developer/qt-<em>version</em> containing the
45files from the main archive.
46<p> Rename qt-<em>version</em> to qt (or make a symlink):
47<p> <pre>
48 mv qt-version qt
49</pre>
50
51<p> The rest of this file assumes that Qt is unpacked in <tt>/Developer/qt</tt>.
52<p> <li> Set some environment variables in the file <tt>.profile</tt> (or <tt>.login</tt>,
53depending on your shell) in your home directory. Create the
54file if it is not there already.
55<p> <ul>
56<li> QTDIR -- the directory in which you're building Qt
57<li> PATH -- to locate the <a href="moc.html#moc">moc</a> program and other Qt tools
58<li> MANPATH -- to access the Qt man pages
59<li> LD_LIBRARY_PATH -- for the shared Qt library
60</ul>
61<p> This is done like this:
62<p> In <tt>.profile</tt> (if your shell is bash, ksh, zsh or sh), add the
63following lines:
64<p> <pre>
65 QTDIR=/Developer/qt
66 PATH=$QTDIR/bin:$PATH
67 MANPATH=$QTDIR/man:$MANPATH
68 DYLD_LIBRARY_PATH=$QTDIR/lib:$DYLD_LIBRARY_PATH
69
70 export QTDIR PATH MANPATH DYLD_LIBRARY_PATH
71</pre>
72
73<p> In <tt>.login</tt> (in case your shell is csh or tcsh), add the following lines:
74<p> <pre>
75 setenv QTDIR /Developer/qt
76 setenv PATH $QTDIR/bin:$PATH
77 setenv MANPATH $QTDIR/man:$MANPATH
78 setenv DYLD_LIBRARY_PATH $QTDIR/lib:$DYLD_LIBRARY_PATH
79</pre>
80
81<p> After you have done this, you will need to login again, or
82re-source the profile before continuing.
83<p> <li> If you have the commercial edition of Qt, install your license
84file as <tt>$HOME/.qt-license</tt>.
85<p> <li> Compile the Qt library, and build the example programs,
86the tutorial and the tools (e.g. <a href="designer-manual.html">Qt
87 Designer</a>) as follows.
88<p> Type:
89<pre>
90 cd $QTDIR
91 ./configure
92</pre>
93
94<p> This will configure the Qt library for your machine. Note that
95GIF support is turned off by default. Run <tt>./configure -help</tt>
96to get a list of configuration options.
97<p> To create the library and compile all examples and the tutorial:
98<pre>
99 make
100</pre>
101
102If you have problems, see
103<a href="http://www.trolltech.com/platforms/">http://www.trolltech.com/platforms/</a>.
104<p> <li> Once you have built Qt, it is ready to use. If Qt has not been
105configured with the -static option, then in order to be able to
106launch Qt applications from the Finder you must place the relevant
107libraries in a directory where they can be found. We recommend
108making these symbolic links (if you have configured Qt with -thread
109please change the libqt below with libqt-mt):
110<p> <pre>
111 ln -sf $QTDIR/lib/libqt.3.dylib /usr/lib
112 ln -sf $QTDIR/lib/libqui.1.dylib /usr/lib
113</pre>
114
115<p> You may need to have 'administrator' access to do this, (in which
116case, precede each command with <tt>sudo'</tt>, e.g. <tt>sudo ln -s ...</tt>). If
117you use sudo you'll be prompted for the administrator password.
118<p> If you do not have administrator access, or you would prefer to do
119a user install (rather than system install) of the libraries you
120can do (if you have configured Qt with -thread please change the libqt
121below with libqt-mt):
122<p> <pre>
123 ln -sf $QTDIR/lib/libqt.3.dylib $HOME/lib
124 ln -sf $QTDIR/lib/libqui.1.dylib $HOME/lib
125</pre>
126
127</ol>
128<p> That's all! Qt is now installed. Qt's documentation can be read with
129Qt Assistant or by any web browser; the contents page is
130<tt>$QTDIR/doc/html/index.html</tt>.
131<p>
132<!-- eof -->
133<p><address><hr><div align=center>
134<table width=100% cellspacing=0 border=0><tr>
135<td>Copyright &copy; 2007
136<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
137<td align=right><div align=right>Qt 3.3.8</div>
138</table></div></address></body>
139</html>
Note: See TracBrowser for help on using the repository browser.