Skip to content
Toolchains, tools and dependencies, all in one place, made easy
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci
.vscode
art
bin
docs
etc/brew
scripts
src
.babelrc
.gitignore
LICENSE
README.md
package-lock.json
package.json

README.md

logo

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()
You can’t perform that action at this time.