This repository is for configuring C/C++ dependencies to be compatible with the gcmake-rust tool.
This repository is best explained in the gcmake-rust predefined dependency configuration doc page.
If using cppfront or glm, make sure to read their corresponding configuration READMEs. Your build will probably break if you don't.
NOTE: Updating the repo requires a working gcmake-rust executable.
Run gcmake-rust dep-config update
to update your local copy of this repository
(in ~/.gcmake/gcmake-dependency-configs) to the latest version of the currently checked out branch,
or to clone the repo if it could not be found. The repo is cloned to the develop
branch by default.
To update and check out a specific branch, use gcmake-rust dep-config update --to-branch 'the-branch-name'
.
Just NOTE that it's recommended to stay on the develop
branch.
All subdirectory dependencies will be cloned and built automatically as part of your project.
Dependencies which must be manually built and installed each have their own README with build and installation instructions, and are listed here:
It's also recommended to use CCache when building large dependencies like wxWidgets and SDL2, as it can provide massive recompilation speedups. See the GCMake doc page on using CCache for information on how to do that.
CppFront can also be pre-built and installed on the system, but is generally just be embedded in a project like other subdirectory dependencies. Embedding CppFront by default makes it easier for other people to build your project in one step, since they most likely don't have CppFront already installed on their system. See the dependency README on cppfront and documentation on using CppFront with gcmake-rust for more information on the topic.
- gcmake-rust: The gcmake C/C++ project configuration tool
- gcmake-test-project: The 'test case' project for gcmake-rust which also acts as its working example.
- gcmake-dependency-configs: The dependency compatibility layer repository which allows non-gcmake projects to be imported and consumed 'out of the box' by gcmake-rust.