CXXPods enables simple CMake dependency management
npm install cxxpods!logo
Documentation can be found here: documentation
CXXPods is a command line tool that allows for both simple c/c++ and very complex multi-platform, cross-compiling dependency managerment.
Think of it as a highly customizable (obviously because it needs to support complex native code) NPM or Maven like package management solution that deals in source artifacts instead of compiled or binary artifacts.
It comes as an amalgamation of other attempts including awesome projects like mason, hunter & conan.
In order to be as comprehensive as possible, there is a single enforced guideline, your project must you CMake.
On linux or macOS you can run the following snippet to install a binary version of cxxpods, no need to install node, npm or anything else. It will be installed to /usr/local/bin
``bash`
curl -s https://raw.githubusercontent.com/cxxpods/cxxpods/master/scripts/client-install.sh | bash
You can also install via npm if you have node and npm installed.
`bash`
npm i -g cxxpods
It takes a few simple steps.
- Create a cxxpods.yml file in the root of your project
`yaml
name: cxxpods-example
dependencies:
opencv: 3.4.1
`
- Then run configure
`bash`
cxxpods project configure
- In your root CMakeLists.txt BEFORE your project declaration
add something like the following:
`cmake
cmake_minimum_required(VERSION 3.10)
project(cxxpods_example)
`
Create your standard cmake toolchain file and
use it as follows:
`yaml
name: cxxpods-example
profiles: [Debug,Release]
toolchains:
"aarch64-linux-gnu": cmake/aarch64.cmake
# file would be at this relative location from the project root
dependencies:
protobuf: 3.1.0
opencv: 3.4.1
`
In order to use with non-cmake dependencies and scripts
add the following to the top of your toolchain file:
`cmake`
include(${CMAKE_CURRENT_LIST_DIR}/.cxxpods/cxxpods.toolchain.cmake)
and add the following to the bottom of your toolchain file
`cmake``
cxxpods_toolchain_export()