How to Build and Install WxGuiTesting


1. wxWidgets,, a cross-platform programming framework in C++. wxGuiTesting is all about unit and regression testing wxWidgets programs. wxGuiTesting is tested against versiont 2.8.6 on Microsoft Windows XP®, Linux Debian Etch, and Macintosh OSX® versions 4 and 5. Mandatory.

2. CppUnit,, a C++ unit testing framework. wxGuiTesting has been tested against version 1.12.0. Mandatory.

3. VTK,, is a graphics toolkit which works on top of opengl. wxGuiTesting is capable of capturing and replaying events via vtk. Optional.

4. wxVTK,, a wx control for VTK. There's an older version in the sources, but you may want to get the latest. Optional.

5. wxCRP,, a template generator for Microsoft Windows®. Some templates are provided for automatically generating wxGuiTesting test suites with wxCRP. Optional.

6. Bakefile,, a cross-platform builder of native build chains. Build chains are provided for Microsoft Visual C® nmake, Microsoft Visual Studio 6® project files, and GNU autoconf. If you need to create other build chains for your toolset, you'll need bakefile to do so.

7. DOxygen,, a source-code documentation system. You'll need this to build the class documentation into a nice set of html pages with pretty inheritance graphs. Optional.




Set the following environment variables. If you're going to use nmake from the command prompt, you can just do it from the command line first; otherwise, use the Control Panel.

WXWIN=[DRIVE:] VTK_DIR=[DRIVE:] (if you're going to use VTK)

If the DLLs for wxWidgets, CppUnit and VTK aren't already on your path, fix that too while you're at it.

Microsoft NMake:

It is important to install wxWidgets, CppUnit, and (if used) VTK on paths with no spaces in them.

Navigate to build/msw. You'll find there two files, and Edit to define the various variables. You'll need to set the WX_SHARED, WX_DEBUG, WX_UNICODE, WX_MONOLITHIC, and WX_VERSION to match a wxWidgets library which you have installed already. SHARED, UNICODE, and BUILD set the parameters for the wxGuiTesting library and test applications. If you're using VTK, set USE_VTK to TRUE.

Now run nmake -f The library and executables will be build in the present directory.

Microsoft Visual Studio® or Visual C++®:

Setup these additional environment variables:

CPPUNIT=[DRIVE:] CPPUNIT_LIB=cppunit library name without extension, e.g. cppunitd_dll

You'll find the solution and project files in build/msw; open MSVS and load wxGuiTesting.sln or wxGuiTesting.dsw.

Now comes the fun part, because there's no automatic way to configure MSVS.

First select from the list of builds the one which matches your wxWidgets installation and build intentions (For example, DLL Unicode Debug Multilib USE_VTK=0).

If you're using a build with USE_VTK=0, it's prudent to open Configuration Manager (select the solution, then right-click: It's on the context menu. It's also available from the property pages) and make sure that the VTKUnitTest project isn't selected for building.

If you set up the environment variables correctly, you're ready to go. Build the solution (either from the Build Menu or by pressing F7 on the keyboard).

GNU Autoconf (UNIX and Macintosh OSX):

Make a new directory at the top level (I like to call it build_osx or build_unix), change to that directory and run
make install
If you don't specify otherwise (via the --prefix option to configure) your library and headers will wind up in /usr/local/lib and /usr/local/include, respectively.

If you want VTK support, specify --with-vtk=/path/to/VTK. If you're using a version of VTK other than 5.0, specify --with-vtk-version=#.# (replacing #.# with the actual version number, of course).

The test and sample apps will stay in your build directory (in the bin subdirectory).

MacOSX note: The Makefile can build app bundles for you, but you need to tell it where your wxWidgets sources are, e.g.

../configure WXSRCPATH=/usr/local/src/wxMac-2.8.6
so that it can find the file. If you don't have sources (OSX Tiger and Leopard both include wxWidgets), there's one from wxWidgets 2.8.4 in build/macosx/src/mac/carbon. Just set WXSRCPATH to ../build/macosx (assuming that you're building in a subdirectory of this one).

By default, configure will set SHARED, UNICODE, and DEBUG to match the primary library found by wx-config. If you want otherwise, tell configure (e.g., `../configure DEBUG=0 to build a library without symbols against a debug version of wxWidgets).

On systems other than Macintosh OS-X version 4 (Tiger), you may want to modify the WX_CXXFLAGS in the Makefile to replace -I with -isystem. This will suppress the amazing quantity of warnings emanating from wxWidgets headers. Tiger (and maybe Leopard, not yet tested) has problems with -isystem which while it suppresses the warnings also interferes with linking, so this isn't a universal solution. On the other hand, wxMac seems to be a bit cleaner than wxGTK in regards to warnings.

wxWidgets Logo Get wxGuiTesting at Fast, secure and Free Open Source software downloads
Generated on Tue Mar 17 17:29:30 2009 for wxGuiTesting by doxygen 1.5.5