CXXPODS

Documentation can be found here: documentation

Overview

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.

Install

Linux, macOS

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

curl -s https://raw.githubusercontent.com/cxxpods/cxxpods/master/scripts/client-install.sh | bash

NPM (Windows, Linux, macOS)

You can also install via npm if you have node and npm installed.

npm i -g cxxpods

Quickstart

It takes a few simple steps.

• Create a cxxpods.yml file in the root of your project

name: cxxpods-example

dependencies:
  opencv: 3.4.1

• Then run configure

cxxpods project configure

• In your root CMakeLists.txt BEFORE your project declaration add something like the following:

cmake_minimum_required(VERSION 3.10)

# INSERT THIS LINE
include(${CMAKE_CURRENT_LIST_DIR}/.cxxpods/cxxpods.cmake)

project(cxxpods_example)

Cross-Compiling "Toolchains"

Create your standard cmake toolchain file and use it as follows:

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:

include(${CMAKE_CURRENT_LIST_DIR}/.cxxpods/cxxpods.toolchain.cmake)

and add the following to the bottom of your toolchain file

cxxpods_toolchain_export()