2. Dependencies - edo9300/edopro GitHub Wiki
All platforms
From the edopro folder (set your platform name appropriately):
./travis/install-local-dependencies.sh windows|linux|osx [use_irrklang]
This downloads freetype 2.6.5 on all platforms and extracts it in the appropriate subdirectory. On Windows, it additionally downloads Irrlicht and extracts it in the appropriate folder as well. If a second parameter is provided, it will also download the corrseponding irrklang archive from which it will then use the required headers, use this if you plan to use irrklang as sound engine, but the irrklang backend is not recomended and the currently used one is sfml
(all the dependencies for this backend are provided by the steps below).
Windows
Dependencies are built with vcpkg
and we make use of its MSBuild-integration.
You can or install all the dependencies by yourself, or download the prebuilt archives that are always up to date and synced with the latest edopro builds (the latter is recomended).
Prebuilt Windows libraries
If you want to use the prebuilt libraries, download the archive for your corresponding Visual Studio version from here, and extract it in a folder or your liking. After that, open a terminal window inside the new folder and run
vcpkg integrate install
Now visual studio instances will load the proper libraries from this vcpkg instance automatically.
Manual install the required libraries
TODO
Linux
Some common dependencies are obtained from your package manager and the rest are built with vcpkg
for binary compatibility between distributions, but you can also retrieve them from your package manager or build from source manually.
From your package manager obtain development versions of OpenGL headers. For example, on Debian-based distributions:
sudo apt install libgl1-mesa-dev libglu-dev -y
Install vcpkg and set up user-wide integration following Microsoft's instructions. Then build the dependencies from source.
git clone https://github.com/microsoft/vcpkg.git
cd vcpkg
./bootstrap-vcpkg.sh
./vcpkg integrate install
./vcpkg install libevent sqlite3 curl libgit2 fmt nlohmann-json
This will build dependencies from source, so it can take some time depending on your machine, especially to build OpenSSL. If you'd like to get started quickly, you can download and extract this cached 7z archive to your vcpkg folder before running the install command.
Install lua with C++ bindings to your system with ./ocgcore/travis/install-lua.sh linux
macOS
Most dependencies are obtained from Homebrew. For binary compatibility and best behaviour, libevent and a patched irrlicht are built from source with Xcode against the 10.11 SDK, but you can also install them from Homebrew.
brew install libevent freetype sqlite curl libgit2 fmt nlohmann-json
To retrieve the 10.11 SDK and build from source, from the edopro folder:
./travis/get-osx-sdk.sh 10.11
export MACOSX_DEPLOYMENT_TARGET=10.11
export SDKROOT="/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.11.sdk"
./travis/install-osx-dependencies.sh
If you don't want to build the dependencies yourself, you can install them from cache with ./travis/get-osx-cache.sh
Install lua with C++ bindings to your system with ./ocgcore/travis/install-lua.sh osx
. You may need to install readline
, such as with sudo apt install libreadline-dev -y
Known issues:
- irrlicht built against macOS 10.14 will have glitchy textboxes.