|
|
- # Antkeeper Superbuild
-
- This repository contains a CMake superbuild system and all dependencies required to build Antkeeper.
-
- ## Download
-
- Download the `antkeeper-superbuild` repository and all of its Git submodules:
-
- git clone --recursive https://github.com/antkeeper/antkeeper-superbuild.git
-
- ## Configuration & Building
-
- CMake is required to configure and build the application. Depending on the target build platform, CMake should be invoked from one of the following directories:
-
- build/linux32 // 32-bit GNU/Linux application
- build/linux64 // 64-bit GNU/Linux application
- build/win32 // 32-bit Windows application
- build/win64 // 64-bit Windows application
-
- The following arguments may be passed to CMake during configuration:
-
- -DCMAKE_BUILD_TYPE // [Debug, Release]
-
- ### GNU/Linux
-
- Building on GNU/Linux requires CMake, GCC, G++, and GNU Make. Open a terminal in the project root directory and run the following commands:
-
- cd build/linux64
- cmake ../.. -G "Unix Makefiles" -DCMAKE_BUILD_TYPE=...
- cmake --build .
-
- ### Windows
-
- Building on Windows requires CMake and Visual Studio Build Tools. Additionally, [NSIS](http://nsis.sourceforge.net/) is required if you want to build a distributable installer program. In order to correctly build for your target architecture, you must use the `x86 Native Tools Command Prompt` or the `x64 Native Tools Command Prompt` for 32-bit and 64-bit applications, respectively. Then navigate to the project root directory and run the following commands:
-
- cd build\win64
- cmake ..\.. -G "NMake Makefiles" -DCMAKE_BUILD_TYPE=...
- cmake --build .
-
- ## Testing
-
- After building, a standalone version of the application will be located somewhere in the `bin` directory according to the build type, build platform, and version string. This application can be executed with the following command:
-
- cmake --build . --target run
-
- ## Distribution
-
- The built application can be packaged into a distributable format with the following command:
-
- cmake --build . --target dist
-
- The resulting package will be located in the `dist` directory.
-
- ## Contributing
-
- If any changes have been made to the submodules, commit those first. Each submodule can then be updated to their latest commits with the following command:
-
- git submodule update --recursive --remote
-
- ## License
-
- Antkeeper superbuild is licensed under the GNU General Public License, version 3. For more information, see [`LICENSE.md`](./LICENSE.md).
-
- ### 3rd-Party Software
-
- | Name | Author(s) | License | File(s) |
- | :------------------------------ | :--------------------- | :-------------------------- | :------------------------------------------------------------------ |
- | dr_wav | David Reid | Public Domain (Unlicense) | [dr_wav.h](./modules/dr_wav/dr_wav.h) |
- | Easing Functions (Equations) | Robert Penner | MIT License | [easings.hpp](./modules/antkeeper-source/src/animation/easings.hpp) |
- | EnTT | Michele Caini | MIT License | [entt/*](./modules/entt/) |
- | khrplatform.h | The Khronos Group Inc. | MIT License | [khrplatform.h](./modules/glad/khrplatform.h) |
- | OpenGL loader generated by glad | David Herberth | Public Domain / WTFPL / CC0 | [glad.h](./modules/glad/glad.h), [glad.c](./modules/glad/glad.c) |
- | JSON for Modern C++ | Niels Lohmann | MIT License | [json.hpp](./modules/nlohmann/json.hpp) |
- | OpenAL Soft | | GNU GPL v2.0 | [openal-soft/*](./modules/openal-soft/) |
- | Simple DirectMedia Layer | Sam Lantinga | zlib License | [SDL2/*](./modules/SDL2/) |
- | stb_image | Sean Barrett | Public Domain / MIT License | [stb_image.h](./modules/stb/stb_image.h) |
- | stb_image_write | Sean Barrett | Public Domain / MIT License | [stb_image_write.h](./modules/stb/stb_image_write.h) |
|
