]> git.saurik.com Git - wxWidgets.git/blob - docs/msw/install.txt
TWIN32 compatibility added; wxMotif uses wxGTK's wxPostScriptDC;
[wxWidgets.git] / docs / msw / install.txt
1
2 Installing wxWindows 2.0
3 ------------------------
4
5 Unarchiving
6 -----------
7
8 If there is a setup program, run the setup program that comes with the Windows version.
9 Do not install into a path that contains spaces. The installation program should set the
10 WXWIN environment variable, which will be activated when your machine is rebooted.
11
12 If there is no setup program, it will come as a series of .zip
13 files:
14
15 wx200gen.zip Generic source code and samples (required)
16 wx200msw.zip Windows-specific source code and samples (required)
17 wx200doc.zip Documentation source code (not required)
18 wx200hlp.zip WinHelp documentation
19 wx200pdf.zip Acrobat PDF documentation
20 wx200htm.zip HTML documentation
21 wx200vc.zip MS VC++ 5.0 project files
22 wx200cw.zip Metrowerks CodeWarrior project files
23
24 Unarchive the required files plus any optional documentation
25 files into a suitable directory such as c:\wx. Alter your
26 WXWIN environment variable to point to this directory.
27
28 Compilation
29 -----------
30
31 At present, wxWindows compiles with VC++ 4.0/5.0/6.0,
32 BC++ 4.5/5.0, Gnu-Win32 b19/b20, and Mingw32. It may compile
33 with 16-bit compilers (BC++ and VC++ 1.5) but this hasn't
34 been tested lately.
35
36 Visual C++ 4.0/5.0/6.0 compilation
37 ----------------------------------
38
39 Using project files:
40
41 1. Unarchive wx200vc.zip, the VC++ 5 project makefiles.
42 2. Open src/wxvc.dsp, set Debug or Release configuration, and
43 compile. This will produce lib/wxvc.lib or lib/wxvc_debug.lib.
44 3. Open a sample project file, choose a configuration, and compile.
45 The project files don't use precompiled headers, to save
46 space, but you can switch PCH compiling on for greater speed.
47
48 Using makefiles:
49
50 1. Make sure your WXWIN variable is set.
51 2. Change directory to wx\src\msw. Type 'nmake -f makefile.nt' to
52 make the wxWindows core library.
53 3. Change directory to wx\samples and type 'nmake -f makefile.nt'
54 to make all the samples. You can also make them individually.
55
56 Note (1): if you wish to use templates, please edit
57 include\wx\msw\setup.h and set wxUSE_DEBUG_NEW_ALWAYS to 0.
58 Without this, the redefinition of 'new' will cause problems in
59 the headers. Alternatively, #undef new before including template headers.
60
61 Note (2): libraries and applications generated with makefiles and
62 project files are unlikely to be compatible, so use one method or
63 the other.
64
65 Visual C++ 1.5 compilation
66 --------------------------
67
68 1. Make sure your WXWIN variable is set, and uses the FAT (short
69 name) form.
70 2. Change directory to wx\src\msw. Type 'nmake -f makefile.dos' to
71 make the wxWindows core library.
72 3. Change directory to a sample, such as wx\samples\minimal, and
73 type 'nmake -f makefile.dos'.
74
75 Borland C++ 4.5/5.0 compilation
76 -------------------------------
77
78 1. Make sure your WXWIN variable is set, and uses the FAT (short
79 name) form if doing a 16-bit compile.
80 2. Change directory to wx\src\msw. Type 'make -f makefile.b32' to
81 make the wxWindows core library. Ignore the warnings about
82 'XXX' not found in library.
83 3. Change directory to a sample such as minimal, and type
84 'make -f makefile.b32'.
85 4. For release versions, recompile wxWindows and samples using
86 'make -f makefile.b32 clean'
87 'make -f makefile.b32 FINAL=1'
88 for the library and samples.
89
90 Note: the wxWindows library and (some) samples compile in 16-bit mode
91 using makefile.bcc, but at present the wxWindows resource system is switched
92 off in this mode. See issues.txt for details.
93
94 Borland C++Builder compilation
95 ------------------------------
96
97 C++Builder compilation is the same as for Borland C++ above.
98
99 Tested with C++Builder 1.0 and 3.0. Only makefiles are currently
100 supplied.
101
102 Watcom C++ 10.6 compilation
103 ---------------------------
104
105 1. Make sure your WXWIN variable is set, and uses the FAT (short
106 name) form.
107 2. Change directory to wx\src\msw. Type 'wmake -f makefile.wat' to
108 make the wxWindows core library.
109 3. Change directory to wx\samples\minimal and type 'wmake -f makefile.wat'
110 to make this sample.
111
112 Metrowerks CodeWarrior compilation
113 ----------------------------------
114
115 1. Downloaded and unzip wx200cw.zip.
116 2. Load the make_cw.mcp project in wx\src, and compile.
117 3. Load the make_cw.mcp project in wx\samples\minimal, and compile.
118 Further project files for samples will be available in due
119 course.
120
121 Symantec C++ compilation
122 ------------------------
123
124 1. Make sure your WXWIN variable is set, and uses the FAT (short
125 name) form.
126 2. Edit setup.h and set wxUSE_DRAG_AND_DROP to 0.
127 3. Change directory to wx\src\msw. Type 'make -f makefile.sc' to
128 make the wxWindows core library.
129 4. Change directory to wx\samples\minimal and type 'make -f makefile.sc'
130 to make this sample.
131
132 Note: the minimal sample doesn't link properly ('Error: no
133 start address').
134 32-bit compilation only (partially) supported at present, using SC++ 6.1.
135 Some functionality is missing using this compiler (see makefile).
136 Add -D__WIN95__ if your SC++ has Windows 95 support, and ignore
137 Step (2). 16-bit compilation is left as an excercise for the user!
138
139 Salford C++ compilation
140 -----------------------
141
142 1. Make sure your WXWIN variable is set, and uses the FAT (short
143 name) form.
144 2. Edit SALFORDDIR and RESOURCEDIR in src/makesl.env as per
145 notes.
146 3. Change directory to wx\src\msw. Type 'mk32 -f makefile.sl all' to
147 make the wxWindows core library.
148 4. Change directory to wx\samples\minimal and type 'mk32 -f makefile.sl'
149 to make this sample.
150
151 Unfortunately, Salford C++ seems to have problems with its code generation for
152 operations on objects, as seen in wxFrame::OnMenuHighlight
153 (minimal sample) or wxWindow::SetValidator (mdi sample). Also the
154 the debugging version of the library is 90MB, with samples coming in
155 at 40MB :-) However, wxWindows at least makes a good test suite for
156 improving the compiler.
157
158 Gnu-Win32 b19/b20/Mingw32 compilation
159 -------------------------------------
160
161 wxWindows 2.0 supports Gnu-Win32/Cygwin b19, b20, Mingw32, and Mingw32/EGCS.
162
163 Thanks are due to Keith Garry Boyce (garp@opustel.com) and Cygnus for making
164 it all possible.
165
166 From wxWindows 2.0 beta 9, both Gnu-Win32 and Mingw32 (the minimal
167 distribution of Gnu-Win32) can be used with the same makefiles.
168
169 Here are the steps required:
170
171 - Retrieve and install the latest beta of Gnu-Win32, or Mingw32, as per the
172 instructions with either of these packages.
173
174 - If using Mingw32 (including the EGCS variant), you need some
175 extra files to use the wxWindows makefiles. You can find these
176 files in ports/mingw32 on the ftp site or CD-ROM, as extra.zip.
177 These should be extracted to the Mingw32 directory.
178 IMPORTANT: also see mingw32.txt in this directory (docs/msw)
179 about a fix that has to be applied to a Mingw32 header file.
180
181 - Modify the file wx/src/cygnus.bat (or mingw32.bat or mingegcs.bat)
182 to set up appropriate variables, if necessary mounting drives.
183 Run it before compiling.
184
185 - For Gnu-Win32, make sure there's a \tmp directory on your
186 Windows drive or bison will crash.
187
188 - Edit wx/src/makeg95.env and search for MINGW32. Take note of
189 the comments for adjusting settings to suit Gnu-Win32 or
190 Mingw32. Basically, this is just a case of adding the __MINGW32__ symbol
191 to OPTIONS for Mingw32, or removing it for Cygnus Gnu-Win32.
192 For Mingw32/EGCS, add both __MINGW32__ and __EGCS__.
193
194 - Mingw32 may not support winsock.h, so comment out
195 socket-related files in src/msw/makefile.g95.
196
197 - Use the makefile.g95 files for compiling wxWindows and samples,
198 e.g.:
199 > cd c:\wx\src\msw
200 > make -f makefile.g95
201 > cd c:\wx\samples\minimal
202 > make -f makefile.g95
203
204 - Use the 'strip' command to reduce executable size.
205
206 - With Cygnus Gnu-Win32, you can invoke gdb --nw myfile.exe to
207 debug an executable. If there are memory leaks, they will be
208 flagged when the program quits.
209
210 - If using GnuWin32 b18, you will need to copy windres.exe
211 from e.g. the Mingw32 distribution, to a directory in your path.
212
213 All targets have 'clean' targets to allow removal of object files
214 and other intermediate compiler files.
215
216 Gotchas:
217
218 - libwx.a is 48 MB or more - but much less if compiled with no
219 debug info (-g0) and level 4 optimization (-O4).
220 - install.exe doesn't have built-in decompression because lzexpand.lib
221 isn't available with Gnu-Win32. However, you can use it with external
222 decompression utilities.
223 - Doesn't compile src/msw/ole files, so no drag and drop.
224
225 References:
226
227 - The GNU-WIN32 site is at
228 http://www.cygnus.com/gnu-win32/
229 - Mingw32 is available at:
230 http://agnes.dida.physik.uni-essen.de/~janjaap/mingw32/index.html
231 - See also http://web.ukonline.co.uk/julian.smart/wxwin/gnuwin32.htm
232
233 TWIN32 and gcc on Linux
234 -----------------------
235
236 The wxWindows 2 for Windows port may be compiled using
237 the TWIN32 emulator package from www.willows.com. However,
238 TWIN32 is by no means finished so this should be taken as
239 something to think about for the future, rather than
240 a tool for writing products with.
241
242 Use makefile.twn in much the same way as makefile.g95, as
243 described above. Not all sample makefiles are supplied yet.
244
245 Notes
246 -----
247
248 - Debugging: under Windows 95, debugging output isn't output in
249 the same way that it is under NT or Windows 3.1. Set
250 wxUSE_DBWIN32 to 1 if you wish to enable code to output debugging
251 info to an external debug monitor, such as Andrew Tucker's DBWIN32.
252 You can download DBWIN32 from:
253
254 http://ftp.digital.com/pub/micro/NT/WinSite/programr/dbwin32.zip
255
256 and it's also on the wxWindows CD-ROM under Packages.
257