Installation, and requirements

The following components must be installed first before building LibCXX Windows Library:

Note

Linux distributions typically have separate runtime and development packages for these libraries. In all cases, the development packages must be installed to build LibCXX Windows Library, and only the runtime packages are required to run the applications.

Implicit from these requirements: using LibCXX Windows Library to build applications requires knowledge and familiarity with the core LibCXX classes and templates, as well as the GNU toolchain (autoconf, automake, and libtool).

Configuring and building

The recommended approach is to convert LibCXX Windows Library into an installable package; rather than manually building and installing LibCXX Windows Library directly. The source tarball is directly buildable on Fedora. Running rpmbuild -ta libcxxw-version.tar.bz2 creates the following packages:

  • The main binary rpm package, with runtime libraries.

  • The devel subpackage, containing header files and other supporting files used for developing applications that use the LibCXX Windows Library.

  • The devel-internals subpackage, containing additional header files exposing internal library API's, for developing custom display elements.

Use the following documentation as a guide for building LibCXX Windows Library on non RPM-based Linux distirbutions.

Run the configure script, followed by make (or gmake). configure takes the usual options that specify non-default installation directories, for various files.

Run (g)make install DESTDIR=/tmp/libcxxw-install. This creates an installation image in the /tmp/libcxxw-install directory, to use as a basis for creating an installable package. A plain (g)make install will do it for real, of course. However, using an installable package is strongly recommended.

In addition to (g)make install, the cxxwtheme.desktop should be included in the installable package, and placed in the desktop application directory (usually /usr/share/applications).