This repository contains toolchain definitions for the Bazel build system to cross compile C/C++ code for CloudABI. Instead of relying on a toolchain that is provided by the host operating system, these rules automatically download development tools (e.g. Clang) and cross compile core C/C++ libraries (e.g., cloudlibc) during build. This has the following advantages:
- It allows you to develop CloudABI applications without making any system-level changes. There is no need to install anything on your system, apart from an officially released version of Bazel.
- The toolchain may be versioned as part of the project, making it easier to obtain reproducible build output.
- It makes it easier to test upcoming versions of individual components (e.g., Clang, libc++, cloudlibc).
Add the following code to your WORKSPACE
file to declare the
toolchain.
load("@bazel_tools//tools/build_defs/repo:git.bzl", "git_repository")
git_repository(
name = "org_cloudabi_bazel_toolchains_cloudabi",
# NOT VALID! Replace this with a Git commit SHA.
commit = "...",
remote = "https://github.com/NuxiNL/bazel-toolchains-cloudabi.git",
)
load("@org_cloudabi_bazel_toolchains_cloudabi//:toolchains.bzl", "toolchains_cloudabi_dependencies")
toolchains_cloudabi_dependencies()
And add the following lines to .bazelrc
to use the toolchain as part
of builds. This file may be stored in the same directory as WORKSPACE
.
build --cpu=x86_64-unknown-cloudabi
build --crosstool_top=@org_cloudabi_bazel_toolchains_cloudabi//:toolchain
Commands like bazel build
and bazel test
will now cross compile
targets for CloudABI on x86-64.