... | ... | @@ -22,10 +22,17 @@ please visit the [Releases](https://gitlab.inria.fr/OCSR/UMANS/-/releases) page |
|
|
|
|
|
To compile the UMANS codebase on your machine, perform the following steps:
|
|
|
|
|
|
1. Clone or download the code from [our GitLab repository](https://gitlab.inria.fr/OCSR/UMANS/).
|
|
|
0. Download a C++ compiler or an IDE with C++ support, such as Visual Studio.
|
|
|
1. Clone or download the UMANS source code from [our GitLab repository](https://gitlab.inria.fr/OCSR/UMANS/).
|
|
|
2. Download and install [CMake](https://cmake.org/).
|
|
|
3. *(Optional)* Download and install [Qt](https://www.qt.io/). This is only needed if you want to compile the *UMANS-GUI* application. For first-time users, we recommend that you start *without* the GUI application (and without Qt), because most installation problems are related to Qt.
|
|
|
4. Use CMake to turn the codebase into a programming project for your IDE/compiler of choice. If you have not installed Qt, you need to disable the option UMANS_USE_GUI_APPLICATION in CMake. This will make sure that the *UMANS-GUI* project does not get created. You can always go back later to re-enable the option.
|
|
|
3. *(Optional)* Download and install [Qt](https://www.qt.io/).
|
|
|
- Qt is only needed if you want to compile the *UMANS-GUI* application. For first-time users, we recommend that you start *without* the GUI application (and without Qt), because most installation problems are related to Qt.
|
|
|
- Please use Qt version 5.12 or later. We have not tested any older versions.
|
|
|
- You do not have to install *all* components of Qt. Most importantly, you will need the *Qt bindings for your IDE/compiler*, for example "MSVC 2017 x64" if you are using Visual Studio 2017 on a 64-bit machine. Also, you may want to install Qt Creator if you ever want to edit the UMANS GUI itself. (Qt Creator is not required for compiling the code, though.)
|
|
|
4. Use CMake to turn the codebase into a programming project for your IDE/compiler of choice.
|
|
|
- We recommend you to use the CMake GUI for easier control.
|
|
|
- If you have not installed Qt, you need to disable the option UMANS_USE_GUI_APPLICATION in CMake. This will make sure that the *UMANS-GUI* project does not get created. You can always use CMake again later to re-enable the option.
|
|
|
- If you *do* want to use the *UMANS-GUI* project, and if you have installed Qt, keep the UMANS_USE_GUI_APPLICATION option enabled. You may need to tell CMake where your Qt installation is located, by filling in the CMake variables that start with "Qt5". (Also, please make sure that you choose the same compiler in CMake as the one you chose for your Qt installation.)
|
|
|
5. Compile the code in your IDE/compiler.
|
|
|
This should build the two or three applications mentioned before.
|
|
|
|
... | ... | |