[ Lit Window Library at SourceForge ] [ Lit Window Productions Homepage ] [ wxWidgets Tips&Tricks ] [ wxVisualSetup ]

Building the Lit Window Library

Requirements

Before you can build the Lit Window Library, you must complete the following steps

install wxWidgets 2.4 or 2.5
set the WXWIN environment variable to the path where wxWidgets is installed
build the main wxWidgets libraries either as static or as a DLL
build the XRC resource library from the wxWidgets/contrib/src/xrc directory

The following steps are recommended but optional

build the release version of the xrc resource compiler from the /contrib/utils/wxrc directory
download, install and build the CPPUNIT unittest framework http://sourceforge.net/projects/cppunit/. The Lit Window Library has been developed with CPPUNIT 1.9.10
download and install DialogBlocks http://www.anthemion.co.uk/dialogblocks
download and install Doxygen http://www.doxygen.org if you want to be able to build the documentation

Lit Window Library directories

The Lit Window Library directories are as follows

doc: contains a vision document and the doxygen generated documentation in doc/html

lib: the library binaries

bin: any generated binaries that are not libraries

build: containing all material to build the Lit Window Library and its releases

build/msvc: the Visual Studio project files and workspaces

build/win_scripts: scripts for the Windows platform. These scripts build project files, the documentation and other things and are used to prepare a Lit Window Library release. They are not normally of interest to users of the library.

The library is split into two parts, lwbase and lwwx. Each part has the same directory structure. The directories are

lwbase/include: lwbase include files

lwbase/src: lwbase source files

lwbase/src/doc: lwbase documentation source files for the doxygen documentation

lwwx/include: lwwx include files

lwwx/src: lwwx source files

lwwx/src/doc: lwwx documentation source files for the doxygen documentation

lwwx/samples: lwwx samples

Building the library

There are two sets of MS Visual Studio C++ 6.0 project files.

Building and using static libraries: Use build/msvc/lwall_lib.dsw

Building and using shared libraries (DLL): Use build/msvc/lwall_dll.dsw

To build the libraries

Open the appropriate project file lwall_lib or lwall_dll.
Select 'RssReader' as the application to build.
Select the desired configuration, Debug or Release, Multibyte or Unicode charset (Note: Unicode builds usually lack a little behind and may be broken for a while).
Hit F7 to build.

To run the unittests: If you have CPPUNIT installed, you can run the unittests to test the lwbase part of the library. Choose 'unittest' from the project file, build and run it.

VERY IMPORTANT NOTE: If you get compiler or linker errors, read the section about Compiler messages before asking for help. The Lit Window Library stretches the capabilities of compilers such as Microsoft Visual Studio C++ 6.0 and sometimes requires special settings to work.

Running unittests

Build and run the 'unittests' project. This will build the base library and run a couple of unit tests. As of this writing there exist 39 unittests. They should run okay.

Note:: When the unittests finish some error messages will be written to stderr regardless of wether the unittests run okay or flag an error. This is normal because the unittests test errors as well.

Building the Lit Window Library

Requirements

Lit Window Library directories

Building the library

Running unittests

Running the rssreader tutorial

Running the generic_ui application

Building the documentation