This information pertains to building CopperSpice for developing applications on Unix operating systems.

Building

For a typical CopperSpice setup refer to the table below.

(1)    This step only needs to be run if CopperSpice has been checked out from the Git repository or the configure.ac file or any Makefile.am files have been modified. Running this command unnecessarily will not do any harm. This command is run from a terminal window in the CopperSpice source directory (cs folder).

(2)    To configure CopperSpice using the default options, run configure in the CopperSpice build folder. This syntax will leave the CopperSpice source untouched in the cs folder and put the CopperSpice build in cs_build folder during the make process.

The CopperSpice libraries can be installed to a unique folder leaving the source, build, and system library folders untouched. The value for ––prefix specifies the CopperSpice install path.

An alternative to typing the prior command repeatedly, is to create a file like config-cs in the build folder. This file can pass the prefix and any other required options to configure. The following is a sample of a typical config-cs file.

To run configure using the config-cs file, use the following command and syntax from the CopperSpice build directory (cs_build folder).

Note

If you want to override the CXXFLAGS you can not pass the changes to make on the command line. Instead, create a file like config-cs and pass the changes when running configure.

(3)    To compile the CopperSpice libraries use the following syntax from your CopperSpice build directory (cs_build folder). This step is run every time CopperSpice source code is changed.

From the build folder run the following command to delete all of the object and intermediate files. The next time 'make' is run every file will be compiled, since they were deleted.

(4)    To install the CopperSpice libraries and deploy to the location specified in ––prefix, use the following syntax. This step is done every time CopperSpice is deployed.

Required Packages

In order to build CopperSpice on Unix several packages may need to be installed. The version number shown in the last column indicates what was tested with current release of CopperSpice. A newer version may work however we do not recommend and older version of any given package.

• Debian 8 (Jessie)
• Debian 9 (Stretch)

• Fedora 27
• Fedora 28
• Fedora 29

• FreeBSD 11.2

• Ubuntu 14.04
• Ubuntu 16.04
• Ubuntu 18.04

Debian 8 (Jessie)

Debian 9 (Stretch)

Fedora 27

Fedora 28

With this release the maintainers of the project removed the deprecated SUN RPC functionality. To support RPC two new libraries must be installed. The packages are called libtirpc-devel and libnsl2-devel. To support the new headers the CCXFLAGS and LDFLAGS must be passed as shown from configure.

Fedora 29

With this release the maintainers of the project removed the deprecated SUN RPC functionality. To support RPC two new libraries must be installed. The packages are called libtirpc-devel and libnsl2-devel. To support the new headers the CCXFLAGS and LDFLAGS must be passed as shown from configure.

FreeBSD 11.2

Ubuntu 14.04

Ubuntu 16.04

Ubuntu 18.04

OpenGL Dependencies

For additional information refer to OpenGL

Phonon Dependencies

The CsPhonon library uses the GStreamer multimedia framework as the backend for audio and video playback on Unix. The minimum required version of GStreamer is 0.10.

To build CsPhonon you will need the GStreamer library, base plugins, and development files for your system. The package names for GStreamer vary between Linux distributions. Search for gstreamer or libgstreamer in your distribution's package repository to find suitable packages.