summaryrefslogtreecommitdiffstats
path: root/doc/html/install-mac.html
blob: d533808e290dacaa09c2fc7c8f4e0e52ae665a30 (plain)
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
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/doc/installation.doc:179 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Installing Qt/Mac</title>
<style type="text/css"><!--
fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; }
--></style>
</head>
<body>

<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
 <a href="index.html">
<font color="#004faf">Home</font></a>
 | <a href="classes.html">
<font color="#004faf">All&nbsp;Classes</font></a>
 | <a href="mainclasses.html">
<font color="#004faf">Main&nbsp;Classes</font></a>
 | <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
 | <a href="groups.html">
<font color="#004faf">Grouped&nbsp;Classes</font></a>
 | <a href="functions.html">
<font color="#004faf">Functions</font></a>
</td>
<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>

 
<p> You may need to be logged in as root, depending on the permissions of
the directories where you choose to install Qt.
<p> <ol type=1>
<li>  Unpack the archive if you have not done so already:
<p> <pre>
    cd /Developer
    gnutar xzf qt-mac-version.tar.gz
</pre>
 
<p> This creates the directory /Developer/qt-<em>version</em> containing the
files from the main archive.
<p> Rename qt-<em>version</em> to qt (or make a symlink):
<p> <pre>
    mv qt-version qt
</pre>
 
<p> The rest of this file assumes that Qt is unpacked in <tt>/Developer/qt</tt>.
<p> <li>  Set some environment variables in the file <tt>.profile</tt> (or <tt>.login</tt>,
depending on your shell) in your home directory. Create the
file if it is not there already.
<p> <ul>
<li> QTDIR -- the directory in which you're building Qt
<li> PATH -- to locate the <a href="moc.html#moc">moc</a> program and other Qt tools
<li> MANPATH -- to access the Qt man pages
<li> LD_LIBRARY_PATH -- for the shared Qt library
</ul>
<p> This is done like this:
<p> In <tt>.profile</tt> (if your shell is bash, ksh, zsh or sh), add the
following lines:
<p> <pre>
    QTDIR=/Developer/qt
    PATH=$QTDIR/bin:$PATH
    MANPATH=$QTDIR/man:$MANPATH
    DYLD_LIBRARY_PATH=$QTDIR/lib:$DYLD_LIBRARY_PATH

    export QTDIR PATH MANPATH DYLD_LIBRARY_PATH
</pre>
 
<p> In <tt>.login</tt> (in case your shell is csh or tcsh), add the following lines:
<p> <pre>
    setenv QTDIR /Developer/qt
    setenv PATH $QTDIR/bin:$PATH
    setenv MANPATH $QTDIR/man:$MANPATH
    setenv DYLD_LIBRARY_PATH $QTDIR/lib:$DYLD_LIBRARY_PATH
</pre>
 
<p> After you have done this, you will need to login again, or
re-source the profile before continuing.
<p> <li>  If you have the commercial edition of Qt, install your license
file as <tt>$HOME/.qt-license</tt>.
<p> <li>  Compile the Qt library, and build the example programs,
the tutorial and the tools (e.g. <a href="designer-manual.html">Qt
    Designer</a>) as follows.
<p> Type:
<pre>
    cd $QTDIR
    ./configure
</pre>
 
<p> This will configure the Qt library for your machine. Note that
GIF support is turned off by default. Run <tt>./configure -help</tt>
to get a list of configuration options.
<p> To create the library and compile all examples and the tutorial:
<pre>
    make
</pre>
 
If you have problems, see
<a href="http://www.trolltech.com/platforms/">http://www.trolltech.com/platforms/</a>.
<p> <li>  Once you have built Qt, it is ready to use. If Qt has not been
configured with the -static option, then in order to be able to
launch Qt applications from the Finder you must place the relevant
libraries in a directory where they can be found. We recommend
making these symbolic links (if you have configured Qt with -thread
please change the libqt below with libqt-mt):
<p> <pre>
    ln -sf $QTDIR/lib/libqt.3.dylib /usr/lib
    ln -sf $QTDIR/lib/libqui.1.dylib /usr/lib
</pre>
 
<p> You may need to have 'administrator' access to do this, (in which
case, precede each command with <tt>sudo'</tt>, e.g. <tt>sudo ln -s ...</tt>). If
you use sudo you'll be prompted for the administrator password.
<p> If you do not have administrator access, or you would prefer to do
a user install (rather than system install) of the libraries you
can do (if you have configured Qt with -thread please change the libqt
below with libqt-mt):
<p> <pre>
    ln -sf $QTDIR/lib/libqt.3.dylib $HOME/lib
    ln -sf $QTDIR/lib/libqui.1.dylib $HOME/lib
</pre>
 
</ol>
<p> That's all! Qt is now installed. Qt's documentation can be read with
Qt Assistant or by any web browser; the contents page is
<tt>$QTDIR/doc/html/index.html</tt>.
<p> 
<!-- eof -->
<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2007
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
<td align=right><div align=right>Qt 3.3.8</div>
</table></div></address></body>
</html>