pianobooster/BUILD.md

91 lines
2.6 KiB
Markdown
Raw Normal View History

2019-07-10 05:56:00 +02:00
# Linux and BSD Unix
2019-06-05 05:03:40 +02:00
2019-06-27 06:55:18 +02:00
Ensure that the build required packages are installed. Full list of them you can find [here](pkgs).
2019-06-05 05:03:40 +02:00
2019-06-27 06:55:18 +02:00
Then type:
2019-06-20 05:10:35 +02:00
2019-07-01 23:59:01 +02:00
`cmake .`
2019-06-20 05:10:35 +02:00
2019-07-05 11:25:24 +02:00
or
`cmake . -DCMAKE_INSTALL_PREFIX="/usr"`
2019-07-01 23:59:01 +02:00
`make`
2019-06-20 05:10:35 +02:00
2019-06-27 06:55:18 +02:00
Finally as root type:
2019-06-20 05:10:35 +02:00
2019-07-01 23:59:01 +02:00
`make install -C build`
2019-06-20 05:10:35 +02:00
2019-06-27 06:55:18 +02:00
(The pianobooster binary executable is now in the "build" subdirectory.)
2019-06-05 05:03:40 +02:00
2019-06-27 06:55:18 +02:00
To build a debug version create a dir called "debug" and change to that dir and then type:
2019-06-20 05:10:35 +02:00
2019-07-01 23:59:01 +02:00
`cmake -DCMAKE_BUILD_TYPE=Debug .`
2019-06-05 05:03:40 +02:00
2019-06-27 06:55:18 +02:00
(Alternatively you can use qmake followed by make.)
2019-06-05 05:03:40 +02:00
2019-06-27 06:55:18 +02:00
See [DEB](pkgs/deb) for more details.
2019-06-11 00:12:58 +02:00
2019-06-27 06:55:18 +02:00
See [RPM](pkgs/rpm/pianobooster.spec) for more details.
2019-06-27 06:55:18 +02:00
See [ARCH](pkgs/arch/PKGBUILD) for more details.
2019-06-13 07:55:18 +02:00
2019-07-10 05:56:00 +02:00
See [TGZ](pkgs/slack) for more details.
2019-06-05 05:03:40 +02:00
# macOS
2019-06-27 06:55:18 +02:00
Install latest Xcode (from Apple Developer Connection, free registration required).
2019-06-05 05:03:40 +02:00
2019-06-27 06:55:18 +02:00
Install CMake and QT libraries via Homebrew:
2019-06-05 05:03:40 +02:00
2019-12-22 11:14:53 +01:00
`$ brew install cmake qt5 ftgl jack`
2019-06-05 05:03:40 +02:00
2019-06-27 06:55:18 +02:00
Generate XCode project file via CMake:
2019-06-05 05:03:40 +02:00
2019-07-01 23:59:01 +02:00
`$ cmake -G Xcode . -DCMAKE_PREFIX_PATH=$(brew --prefix qt)`
2019-06-05 05:03:40 +02:00
2019-06-27 06:55:18 +02:00
Open the project file in XCode, set whatever options you like (universal or single architecture,
debug or release etc.) and compile.
2019-06-05 05:03:40 +02:00
2019-06-27 06:55:18 +02:00
To make a self contained application bundle use QT's macdeployqt tool (included in QT 4.5.0).
2019-06-05 05:03:40 +02:00
# Windows
2019-06-27 06:55:18 +02:00
To compile in Windows install the Open Source version of Qt and CMake and optionally Geany.
When installing Qt select the option to download and install the MinGW compiler. Open the
Qt Command Prompt and then change to the "PianoBooster" directory and then type the
command below:
2019-06-05 05:03:40 +02:00
2019-07-01 23:59:01 +02:00
`"C:\Program Files\CMake 2.6\bin\cmake.exe" -G "MinGW Makefiles" .`
2019-06-20 05:10:35 +02:00
2019-06-27 06:55:18 +02:00
Once this is completed type:
2019-06-05 05:03:40 +02:00
2019-07-01 23:59:01 +02:00
`make`
2019-06-05 05:03:40 +02:00
2019-06-27 06:55:18 +02:00
Or alternatively you can install QtCreator and then open the pianobooster.pro.
2019-06-05 05:03:40 +02:00
# Build options
2019-07-02 06:38:30 +02:00
**USE_FTGL**: link with ftgl; enabled by default; disabling notes localization.
2019-06-27 06:55:18 +02:00
**NO_DOCS**: do not install documents; disabled by default.
2019-07-01 23:52:08 +02:00
**NO_LICENSE**: do not install license; disabled by default.
2019-09-03 13:20:26 +02:00
**NO_CHANGELOG**: do not install changelog; disabled by default.
2019-06-27 06:55:18 +02:00
**WITH_MAN**: install man page; disabled by default.
2019-06-27 06:55:18 +02:00
**INSTALL_ALL_LANGS**: install all languages; disabled by default for cmake and always enabled for qmake.
**USE_BUNDLED_RTMIDI**: build with bundled (not system) rtmidi. This is only required
for older distributions that do not include the system rtmidi; disabled by default.
2019-06-27 06:55:18 +02:00
**USE_SYSTEM_FONT**: do not use and do not install bundled font, use system font instead; enabled by default.
2019-06-27 06:55:18 +02:00
**USE_FONT**: build with specified font; null by default.
2019-07-01 14:16:33 +02:00
2019-07-09 06:54:52 +02:00
**DATA_DIR**: build with specified data directory; "share/games/pianobooster" is default.
2019-07-01 14:16:33 +02:00
**NO_LANGS**: do not install languages; disabled by default.