Getting started with wxWidgets

If you're new to wxWidgets, this page should help you choose the tools you need. Note that this does not discuss wxWidgets 2, available for Windows and GTK.

Which version of wxWidgets?

If you're running Windows 3.1, Windows 95 or Windows NT, the choice is easy: you need the latest release of Julian Smart's version of wxWidgets, here.

If you're running a variant of Unix, there is more choice. Julian Smart's version of wxWidgets comes with XView and Motif variants, here. Motif is recommended, since XView is an outdated GUI and will not be supported in wxWidgets 2. However, XView has the virtue of being free, whereas Motif has to be purchased.

A good solution is to use Markus Holzem's Xt port of wxWidgets, here. Xt (the X toolkit) is available on all X systems, and wxXt is much more flexible than wxWidgets under XView. The licence for wxXt is slightly more restrictive than Julian Smart's version, but not much.

Mac version: there are several versions, all derived from volunteer code:

It's worth trying both the AIAI and ITA versions to see which suits you better.


Which Motif?

Under Linux, I use Metro Link Motif 1.2.4. SWiM Motif has been used successfully with wxWidgets, and there is also RedHat Motif.

The free Lesstif Motif clone may work with wxWidgets; some people have reported success. This probably depends upon your application but it's worth a try.


Which Windows compiler?

The following are known to work with wxWidgets:

Which is best? Well, VC++ has a very good, stable debugger but compiles quite slowly. BC++ compiles quickly, but has a rather inadequate debugger. I've found Watcom C++ to be a very slow compiler but other users have disagreed. Cygwin is free, but is slow, partly because it does not do precompiled headers which can make a big difference. See also the Platforms page.


Which Unix compiler?

Just about any Unix compiler should be fine, including gcc. See the Platforms pages for compiler reports.


Which Mac compiler?

MetroWerks CodeWarrior is the recommended compiler for Classic Mac OS (e.g. Mac OS 8.x/9.x). The Apple Developer Tools include the recommended compiler (e.g. gcc) for Mac OS X.


Which editor?

On Unix, most people use Emacs, and some use Vi. Others, anybody?

On Windows, there's a big choice:


IDE or command line?

wxWidgets 1.xx doesn't come with project files for specific IDEs (Integrated Development Environments). wxWidgets 2 has project files for VC++ 5.0 and above, and CodeWarrior. wxWidgets 1.xx has a lot of sub-projects which are better suited to makefiles, which can recursively compile all components.

However, there is nothing to stop you as a user using the IDE for your own projects, which may happen to make use of the wxWidgets libraries.


Other tools

Most Unix installations will have all other required tools for wxWidgets compilation, such as LEX (the lexical analyser generator) and YACC (the parser generator).

These two tools are not required when using commercial Windows compilers because I supply .c files which are pre-generated. But if you want to regenerate them for any reason, you will need to get hold of LEX and YACC (or compatible tools). See the Tools page.


Further topics