_images/logo.pnglogo

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)