Installation

Note

We currently do not offer any binaries. Instead, the source code has to be compiled manually. We are working on simplifying the installation of the framework.

Windows

Using command-line:

  1. First lets clone the repository and change the directory to Stratega.

    git clone https://github.com/GAIGResearch/Stratega.git
cd Stratega

  2. If you want to check the last updated (not stable) branch checkout dev.

    git checkout dev

  3. Lets configure cmake by running the following code.

    cmake . -B out

  4. Finally change the directory to the output and build the project with

    cd out
cmake --build .

Using Visual Studio 2019:

Stratega is compiled using CMake. Luckily Visual Studio already provides a simple way to do this.

  1. Install Visual Studio 2019 Community from here

  2. Clone Stratega from here (use the master/dev branch)

  3. In Visual Studio open the folder (not project) containing the Stratega source code

  4. Execute Project->Generate Cache, Visual Studio may automatically do this when opening the folder

  5. Execute Build->Build All to generate the executables

  6. Under Select Startup Item… choose GUI.exe and press F5 to run it

Mac OS

  1. First lets clone the repository and change the directory to Stratega.

    git clone https://github.com/GAIGResearch/Stratega.git
cd Stratega

  2. If you want to check the last updated (not stable) branch checkout dev.

    git checkout dev

  3. Go to the main CMakeLists.txt in the root folder, comment like 2 and uncomment lines 5,6,7

    #project(Stratega LANGUAGES C CXX)

#Uncomment if building for Apple
project(Stratega LANGUAGES C CXX OBJCXX OBJC)
enable_language(OBJC)
enable_language(OBJCXX)

  4. In the same CMakeLists.txt change option BUILD_SHARED_LIBS (Line 38) to ON

    # options
option(BUILD_SHARED_LIBS "Enable compilation of shared libraries" ON)

  5. Lets configure cmake by running the following code.

    cmake . -B out -DCMAKE_BUILD_TYPE=Release

  6. Finally change the directory to the output and build the project with

    cd out
make

  7. After the generation you will need to copy all the dlls(dylib files in mac) from the output folder /_deps/sfml-build/lib to /usr/local/lib folder

  8. Copy the content of /_deps/sfml-build/include to /usr/local/include.

  9. Copy the framework files from your output folder/_deps/sfml-src/extlibs/libs-osx/Frameworks to /Library/Frameworks (need root access)

  10. Now you can execute the gui/arena

If you have a Mac with the new M1 arm architecture there is two steps that you will need to do additionaly before configure the cmake:

  1. Go to cmake/targets/settings/conan.cmake, open the file and uncomment line 18 (ARCH armv8)

  2. Go to the main CMakeLists.txt in the root folder and switch on the option SGA_BUILD_SFML_FROM_SOURCE (The new SFML 2.6.x version allows the M1 compilation).

Linux

Note

Coming Soon

Compiling with documentation (Advanced)

Stratega generates documentation using Doxygen (and some other related dependencies). By default, the generation of documentation is disabled (see CMakeLists.txt, STRATEGA_BUILD_DOCS set to OFF).

If you wish to generate documentation, you must:

  1. Install Doxygen manually.

  2. If, despite installing Doxygen, the Generate Cache process still gives any error, follow these complete installation instructions for potentially missing dependencies.

  3. Finally, set ENABLE_BUILD_DOCS to ON compile the framework starting from the Project->Generate Cache step.