nstool/BUILDING.md

31 lines
1.2 KiB
Markdown
Raw Permalink Normal View History

2019-01-31 09:10:19 +00:00
# Building
## Git Submodules
This project makes use of git submodules to import dependencies into the source tree.
After cloning this repository using git, prior to building NSTool the dependencies need to be downloaded.
Run these two commands to initialise and download the dependencies:
```
git submodule init
git submodule update
```
2019-01-31 09:10:19 +00:00
## Linux (incl. Windows Subsystem for Linux) & MacOS - Makefile
### Requirements
* `make`
* Terminal access
* Typical GNU compatible development tools (e.g. `clang`, `g++`, `c++`, `ar` etc) with __C++11__ support
### Using Makefile
* `make` (default) - Compile program
2019-02-17 07:22:43 +00:00
* Compiling the program requires local dependencies to be compiled via `make deps` beforehand
2019-01-31 09:10:19 +00:00
* `make clean` - Remove executable and object files
2019-02-17 07:22:43 +00:00
* `make deps` - Compile locally included dependency libraries
* `make clean_deps` - Remove compiled library binaries and object files
2019-01-31 09:10:19 +00:00
2021-11-09 08:40:36 +00:00
## Native Windows - Visual Studio
2019-01-31 09:10:19 +00:00
### Requirements
2021-11-09 08:40:36 +00:00
* [Visual Studio Community](https://visualstudio.microsoft.com/vs/community/) 2015 / 2017 / 2019
2019-01-31 09:10:19 +00:00
### Compiling NSTool
* Open `build/visualstudio/nstool.sln` in Visual Studio
2019-02-17 07:22:43 +00:00
* Select Target (e.g `Debug`|`Release` & `x86`|`x64`)
2019-01-31 09:10:19 +00:00
* Navigate to `Build`->`Build Solution`