Readme
This commit is contained in:
73
README.md
Normal file
73
README.md
Normal file
@@ -0,0 +1,73 @@
|
|||||||
|
# Build-script
|
||||||
|
|
||||||
|
You ever just get sick and tired of having to deal with all those build systems?
|
||||||
|
|
||||||
|
You know, having to type out `cmake` and `ninja` soooo much?
|
||||||
|
|
||||||
|
Well this repo is for you!
|
||||||
|
|
||||||
|
Probably? Maybe?
|
||||||
|
|
||||||
|
This was mostly a bored at midnight project while thinking about having to make
|
||||||
|
yet another build script, this time in powershell.
|
||||||
|
Sort of got tired of having to deal with having 16, yes 16!, build scripts
|
||||||
|
getting passed around for everything single project.
|
||||||
|
Hence the creation of this. A single program to include, *or add to path*, with
|
||||||
|
my projects that does everything *I* need.
|
||||||
|
|
||||||
|
With that said, this is mostly a program I built for me and it very much expects
|
||||||
|
how I setup cmake.
|
||||||
|
It *should* work for most projects with a CMakeLists.txt in the root dir as long
|
||||||
|
as a `./build/` dir doesn't already exist with needed content. But there's no promises.
|
||||||
|
|
||||||
|
## Building
|
||||||
|
|
||||||
|
`Precompiled releases for both windows and linux are available in the Releases
|
||||||
|
tab. They can compile this project :3`
|
||||||
|
|
||||||
|
This project uses CMake for its build system.
|
||||||
|
Make sure you have a valid CMake version 3.28+ installation as well as a valid
|
||||||
|
build system for cmake generated files.
|
||||||
|
|
||||||
|
All needed dependences are included with the project through the use of CPM.
|
||||||
|
All you need is cmake and compiler!
|
||||||
|
|
||||||
|
### Fedora
|
||||||
|
|
||||||
|
`sudo dnf install cmake g++ tbb`
|
||||||
|
|
||||||
|
### Ubuntu
|
||||||
|
|
||||||
|
`sudo apt install cmake g++ libtbb-dev`
|
||||||
|
|
||||||
|
### Arch
|
||||||
|
|
||||||
|
`sudo pacman -S cmake g++ onetbb`
|
||||||
|
|
||||||
|
#### Building on Linux
|
||||||
|
|
||||||
|
The normal cmake build process is all you need.
|
||||||
|
|
||||||
|
1. Make the build directory `mkdir -p build`
|
||||||
|
2. Configure the project `cmake . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release`
|
||||||
|
3. Build! `cmake --build build`
|
||||||
|
|
||||||
|
#### Building on Windows
|
||||||
|
|
||||||
|
##### With cmake-gui & Visual Studio
|
||||||
|
|
||||||
|
1. Git clone the repo
|
||||||
|
2. Run [cmake-gui](https://cmake.org/download/)
|
||||||
|
3. Select the location you cloned the repo into as the source directory
|
||||||
|
4. Create a new directory called 'build' in the source directory and select it
|
||||||
|
as the build directory
|
||||||
|
5. Configure and generate
|
||||||
|
6. Open the generated Visual studio project
|
||||||
|
7. Right click the project in the project explorer and select 'build'
|
||||||
|
|
||||||
|
### A note for MacOS users
|
||||||
|
|
||||||
|
I do not have a MacOS system to build or test on, so building is solely up to you.
|
||||||
|
All code has been kept as cross-platform as possible so it *should* just work,
|
||||||
|
but if you run into any issues, feel free to submit a pull request with an updated
|
||||||
|
codebase or readme with compilation instructions.
|
||||||
Reference in New Issue
Block a user