LabRPS: Created page with " {{TOCright}} This guide will walk through the steps necessary to build LabRPS on Windows using the MSYS2/MinGW environment. Basic familiarity with Bash shell commands will be useful for understanding what each step does, but following the guide by rote should result in a working build even if you don't understand exactly what you did to get it. === Before you start === Download and install [https://www.msys2.org MSYS2] if you have not already. When launching MSYS2,..."

2024-11-26T19:05:36Z

Created page with " {{TOCright}} This guide will walk through the steps necessary to build LabRPS on Windows using the MSYS2/MinGW environment. Basic familiarity with Bash shell commands will be useful for understanding what each step does, but following the guide by rote should result in a working build even if you don't understand exactly what you did to get it. === Before you start === Download and install [https://www.msys2.org MSYS2] if you have not already. When launching MSYS2,..."

New page

{{TOCright}}

This guide will walk through the steps necessary to build LabRPS on Windows using the MSYS2/MinGW environment. Basic familiarity with Bash shell commands will be useful for understanding what each step does, but following the guide by rote should result in a working build even if you don't understand exactly what you did to get it.

=== Before you start ===

Download and install [https://www.msys2.org MSYS2] if you have not already. When launching MSYS2, use the "MSYS2 MinGW 64-bit" runtime unless you know what you are doing and have a specific reason not to. If you use the UCRT console, make sure to adapt your installation to use the UCRT packages instead.

<pre>
pacman -Syu
</pre>

and then relaunching and running

<pre>
pacman -Su
</pre>

before proceeding.

=== Install basic development tools ===

In all of the following steps, when prompted by MSYS2's shell, accept the default installations of everything by pressing "Enter" when asked.

First, install the mingw-w64 GCC toolchain:

<pre>
pacman -S --needed base-devel mingw-w64-x86_64-toolchain mingw-w64-x86_64-cmake mingw-w64-x86_64-ninja
</pre>

This will probably take several minutes to complete, as the compiler toolchain is quite large.

Install git:

<pre>
pacman -S git
</pre>

Close your current console window and relaunch the MSYS2 MinGW 64 console (in a standard installation this will be in your Start menu in the MSYS2 folder).

=== Check out the LabRPS sources ===

To get the LabRPS source code, clone it from the main git repository:

<pre>
git clone https://github.com/LabRPS/LabRPS
</pre>

If you do not want to compile the latest HEAD, once you have the source you can check out a specific tag:

<pre>
cd LabRPS
git checkout tags/1.0 -b releases/LabRPS-1-0
</pre>

Or a specific pull request (in this example, PR 1234):

<pre>
cd LabRPS
git fetch origin pull/1234/head:pr/1234
git checkout pr/1234
</pre>

Note that not all versions can be compiled on MSYS2, several changes were required to enable it and these were not present in the 0.19 or earlier versions. For example, the 0.19.3 tag will not be compilable.

=== Install required libraries ===

LabRPS depends on many 3rd-party libraries for its functionality. They may be installed individually, or as a single unified command.


Now, install the following required dependencies using pacman:

* mingw-w64-x86_64-qt5
* mingw-w64-x86_64-med
* mingw-w64-x86_64-swig
* mingw-w64-x86_64-qtwebkit
* mingw-w64-x86_64-python-ply
* mingw-w64-x86_64-python-six
* mingw-w64-x86_64-python-yaml
* mingw-w64-x86_64-python-numpy
* mingw-w64-x86_64-python-matplotlib
* mingw-w64-x86_64-pyside2-qt5
* mingw-w64-x86_64-python-markdown
* mingw-w64-x86_64-python-pygit2

The following is a single command to install everything in the list above:

<pre>
pacman -S mingw-w64-x86_64-qt5 mingw-w64-x86_64-med mingw-w64-x86_64-swig mingw-w64-x86_64-qtwebkit mingw-w64-x86_64-pyside2-qt5 mingw-w64-x86_64-python-ply mingw-w64-x86_64-python-six mingw-w64-x86_64-python-yaml mingw-w64-x86_64-python-numpy mingw-w64-x86_64-python-matplotlib mingw-w64-x86_64-python-markdown mingw-w64-x86_64-python-pygit2
</pre>

=== Build LabRPS ===

Make a directory for the build: note this is typically not a subdirectory of the source directory (it is often useful to be able to delete either the source or the build directory independently).

<pre>
mkdir LabRPS-build
cd LabRPS-build
</pre>

Run cMake:

<pre>
cmake ../LabRPS
</pre>

And finally:

<pre>
cmake --build ./
</pre>

{{Userdocnavi}}
[[Category:Developer_Documentation]]
[[Category:Developer]]

Compile on MinGW - Revision history