Skip to content

Building from sources

Vitaly Novichkov edited this page Jun 19, 2018 · 3 revisions

Introduction

This information explains the procedure to follow in order to create a build of the software based on the source code.
It is mainly aimed at the packagers and contributors.

If you are a regular user, it is not necessarily needed to build the software yourself.
Check for existing builds in Downloads, or the package repositories provided by your operating system distributor.

Usage Information

As of OPL3BankEditor version 1.5, the source tree contains two build methods which serve different purposes.

  • a CMake build system for modern computers (Qt version = 5)
  • a QMake build system (Qt versions both 5 and 4)

In most cases, you should favor the CMake build. It enables to obtain some features not necessarily accessible in the QMake build. It has a dynamic detection of audio libraries, so it can enable a Jack build for CAM usage on GNU/Linux.

If you wish to obtain a build for Qt 4, use QMake. This permits backwards compatibility up to Windows 98 (Qt 4.4.3 last that support Windows 98). This build method is also the one which permits to drive a real hardware chip based on the OPL proxy.

Before build

Until begin the build, be sure you have also cloned submodules!

git submodule init
git submodule update

Building with CMake

Navigate to the project directory in a terminal and follow this build procedure.

mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr/local ..
make
sudo make install

This will result in a software installation located in /usr/local, with program shortcuts, icons and MIME type associations.

Building with QMake

The easiest way is to open FMBankEdit.pro in the QtCreator software and run a compilation. Alternatively, you can also build manually on the command line.

Navigate to the project directory in a terminal and follow this build procedure.

qmake CONFIG+=release CONFIG-=debug FMBankEdit.pro
make