Skip to content

Linux Builds

Paul Manias edited this page Dec 9, 2024 · 3 revisions

GCC

Your Linux system may require a few package dependencies to be installed if a complete build of Parasol is desired. For an Apt based system such as Debian or Ubuntu, execute the following:

sudo apt-get install libasound2-dev libxrandr-dev libxxf86dga-dev cmake g++ xsltproc

The following will configure the build process for a standard install to /usr that will be available to all users:

cmake -S . -B release -DCMAKE_BUILD_TYPE=Release

The full build and install process can then be performed with:

cmake --build release -j 8 -- -O
sudo cmake --install release

Portable Builds

The release that we make available to the public is a portable build. Portable builds can be distributed as a compressed archive. There is no need for the user to perform an install, and the executable can be launched directly from its folder. The following cmake instruction can be used to create your own portable version of Parasol:

cmake -S . -B portable -DCMAKE_BUILD_TYPE=Release -DPARASOL_STATIC=ON -DINSTALL_EXAMPLES=TRUE -DINSTALL_INCLUDES=FALSE -DCMAKE_INSTALL_PREFIX=parasol-$(date +'%Y%m%d') -DRUN_ANYWHERE=TRUE

Debug Builds

To compile a build that can be debugged with gdb, the following can be used as a template:

cmake -S . -B debug -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=parasol-gdb -DRUN_ANYWHERE=TRUE -DPARASOL_STATIC=ON

Troubleshooting

If problems occur at any stage during the build and you suspect an issue in the execution of a command, enable logging of the build process with the --verbose option.