Skip to content

Sample Usage#

Install the System Package Deployers#

These are maintained in a separate repo so we can use conan config install.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
$ conan config install https://github.com/DaverSomethingSomethingOrg/conan-system-packaging.git
Trying to clone repo: https://github.com/DaverSomethingSomethingOrg/conan-system-packaging.git
Repo cloned!
Copying file deb_deployer.py to /root/.conan2/extensions/deployers
Copying file rpm_deployer.py to /root/.conan2/extensions/deployers
Copying file Makefile to /root/.conan2/extensions/deployers/deb_deployer
Copying file rules to /root/.conan2/extensions/deployers/deb_deployer/debian
Copying file copyright to /root/.conan2/extensions/deployers/deb_deployer/debian
Copying file format to /root/.conan2/extensions/deployers/deb_deployer/debian/source
Copying file template-v1.0.0.spec to /root/.conan2/extensions/deployers/rpm_deployer
$

Custom Conan Profile#

We need to add an install_prefix option to a custom Conan profile. Specify the path you wish to build and install your toolchain to. (I use /opt/toolchain in this example)

~/.conan2/profiles/optPrefix
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
[settings]
arch=armv8
build_type=Release
compiler=gcc
compiler.cppstd=gnu17
compiler.libcxx=libstdc++11
compiler.version=11
os=Linux

[options]
*:install_prefix=/opt/toolchain

Creating a new Toolchain definition#

To connect all of our tool packages together into a single build and deployment, we create a simple Conan package definition that uses the install_prefix option and lists all primary tools as toplevel dependencies. This will help catch any diamond transitive depdendency version issues early in the process.

Sample toolchain conanfile.py
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
from conan import ConanFile
from conan.tools.layout import basic_layout

class Toolchain(ConanFile):
    settings = "os", "compiler", "build_type", "arch"

    options = {
        "install_prefix": [None, "ANY"],
    }
    default_options = {
        "install_prefix": None,
    }

    def requirements(self):

        self.requires("make/4.4.1")
        self.requires("binutils/2.44")
        self.requires("gcc/15.1.0")

        self.requires("clang/19.1.7")
        self.requires("llvm-core/19.1.7")
        self.requires("gtest/1.16.0")
        self.requires("cppunit/1.15.1")

        self.requires("cpython/3.12.7")
        self.requires("nodejs/20.16.0")
        self.requires("openjdk/21.0.2")

        self.requires("cmake/4.0.1")
        self.requires("meson/1.7.2")
        self.requires("ninja/1.12.1")
        self.requires("bazel/7.2.1")

        self.requires("doxygen/1.14.0")


    def layout(self):
        basic_layout(self, src_folder="src")

Running the package builds#

Sample Usage
1
2
3
4
5
6
7
8
9
# First seed the Conan Cache by installing all packages, building any
# (or all) that are missing
$ conan install --build=missing .

# Once the cache is seeded, run the RPM generator for each package
$ conan install --deployer-folder=rpm_deploy \
                --deployer=rpm_deployer \
                --profile=optToolchain \
                .
Sample Directory Tree Output
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
rpm_deploy
├── opt-toolchain-gcc-15.1.0
│   └── opt/toolchain
│       ├── bin/make
│       └── share/info/make.info
└── opt-toolchain-gmp-6.3.0
    └── opt/toolchain
        ├── include/gmp.h
        ├── lib/libgmp.a
        └── licenses/COPYING.LESSERv3