Windy/cubiomes-viewer
1
0
Fork 0
mirror of https://github.com/Cubitect/cubiomes-viewer.git synced 2025-01-07 03:17:01 +08:00
Code Issues Packages Projects Releases Wiki Activity
trunk
cubiomes-viewer/buildguide.md
Cubitect d686740b43 Use system fontconfig in static build
2024-02-10 20:30:48 +01:00

3.4 KiB
Raw Permalink Blame History

Cubiomes Viewer Build Instructions

Cubiomes Viewer is a Qt5 application and requires:

  • Qt5.9 or newer
  • GNU C++ compiler (GCC or Clang).

The cubiomes library is included as a submodule to this repository.

The Compiler

You should have either GCC or Clang installed.

Windows users can use MinGW, which can be installed together with Qt, using the Qt Installer.

Get Qt5

Depending on your operating system you may have several options for installing Qt5, but Using the Qt Installer should be the most general method. Many Linux distros already provide Qt in their repositories and you can also Get Qt With Your Package Manager instead if you wish.

For a static build you will have to Compile Qt from Source.

Using the Qt Installer

You can use the Qt Online Installer if you have a Qt account or don't mind creating one. It is also possible to use the Qt Offline Installer without an account, but you have to disconnect from the internet when you launch the installer, otherwise it will require a Qt account again, which is a little irritating.

Choose an installation path without spaces.

The only required component is the Qt5 base install for your compiler. (Make sure to select a compiler which supports GNU extensions, such as MinGW.)

I would also recommend installing QtCreator, as well as MinGW on Windows from the Developer Tools.

Get Qt With Your Package Manager

Debian
$ sudo apt install build-essential qt5-default
Fedora
$ sudo dnf install qt5-qtbase-devel qt5-linguist
macOS
$ xcode-select --install
$ brew install qt@5
$ brew link qt@5

Compile Qt from Source

You can get the Qt sources from the Qt download archive. For cubiomes-viewer it is sufficient to get the qtbase submodule.

Check the system requirements on the Qt Wiki, which will depend on the platform and Qt version.

A possible configuration for a static build may be:

$ mkdir qt5; cd qt5
$ wget https://download.qt.io/archive/qt/5.15/5.15.12/submodules/qtbase-everywhere-opensource-src-5.15.12.tar.xz
$ tar xf qtbase-everywhere-opensource-src-5.15.12.tar.xz
$ ./qtbase-everywhere-src-5.15.12/configure -release -static -opensource -confirm-license -nomake examples -opengl -fontconfig -system-freetype -qt-zlib -qt-libjpeg -qt-libpng -qt-pcre -qt-harfbuzz -prefix .
$ make -s -j 4

Get the Cubiomes Sources

The cubiomes-viewer repository includes the cubiomes library as a submodule and requires a recursive clone:

$ git clone --recursive https://github.com/Cubitect/cubiomes-viewer.git

If you have QtCreator you can now just open the cubiome-viewer.pro file and configure the project.

Alternatively you can manually prepare a build directory:

$ cd cubiomes-viewer
$ mkdir build
$ cd build

and build cubiomes-viewer:

$ qmake ..
$ make

Notes:

With some Qt installs it is qmake-qt5 instead. With MinGW the make command is something like minwgw32-make instead. If the commands are not found, make sure that the Qt bin directory is in the PATH variable. (The same applies to C:/Qt/Qt15.12.12/Tools/mingw730_64/bin or wherever your compiler is installed.)