<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>examples/bzlmod/cross_compile/README.md - fork/rules_rust @ patching</title>
<meta name="description" content="examples/bzlmod/cross_compile/README.md in fork/rules_rust at patching.">
<meta property="og:title" content="examples/bzlmod/cross_compile/README.md - fork/rules_rust @ patching">
<meta property="og:description" content="examples/bzlmod/cross_compile/README.md in fork/rules_rust at patching.">
<meta property="og:type" content="website">
<meta property="og:site_name" content="git.julia.blue">
<link rel="stylesheet" href="/css/style.css?v=62">
<script type="module" src="/js/main.js?v=62"></script>
</head>
<body>
<main data-ref="patching" data-tip="285c36a623da1fba565098c0a65746ca7a2f7ebf">
<noscript>
  <div class="callout">
    <p>
      hey! this is a static git repo viewer. commit diffs, file history,
      older commits and other revisions won't load without javascript.
    </p>
    <p>
      you are still able to view source files on branch/tag tips,
      but the experience is degraded.
    </p>
  </div>
</noscript>
<header class="repo"><div>
<h1>fork/rules_rust</h1>
</div>
<pre class="clone">git clone https://git.julia.blue/fork/rules_rust</pre>
</header>
<p class="snapshot-commit"><span class="commit-author">Marvin Hansen</span><span class="commit-message" data-commit="c177ccc1a75b11badd984c01e51e61c840c572d8">Bazelmod documentation and code examples. (#2713)</span><span class="snapshot-sha sha" data-commit="c177ccc1a75b11badd984c01e51e61c840c572d8">c177ccc1</span><time datetime="2024-07-12T20:31:00+08:00" title="2024-07-12 20:31:00 +0800">2024-07-12</time></p>
<header class="topbar"><details class="switcher"><summary>patching</summary><div class="menu"><strong>branches</strong><a href="/fork/rules_rust/ref/cleanup/">cleanup</a><a href="/fork/rules_rust/ref/gh-pages/">gh-pages</a><a href="/fork/rules_rust/ref/main/">main</a><a class="current" href="/fork/rules_rust/ref/patching/">patching</a><a href="/fork/rules_rust/ref/rust-analyzer/">rust-analyzer</a><strong>tags</strong><a href="/fork/rules_rust/ref/0.10.0/">0.10.0</a><a href="/fork/rules_rust/ref/0.11.0/">0.11.0</a><a href="/fork/rules_rust/ref/0.5.0/">0.5.0</a><a href="/fork/rules_rust/ref/0.6.0/">0.6.0</a><a href="/fork/rules_rust/ref/0.7.0/">0.7.0</a><a href="/fork/rules_rust/ref/0.8.0/">0.8.0</a><a href="/fork/rules_rust/ref/0.8.1/">0.8.1</a><a href="/fork/rules_rust/ref/0.9.0/">0.9.0</a><a class="all" href="/fork/rules_rust/refs">all refs →</a></div></details><nav class="crumbs"><a href="/fork/rules_rust/">rules_rust</a> / <a href="/fork/rules_rust/ref/patching/tree/examples/">examples</a> / <a href="/fork/rules_rust/ref/patching/tree/examples/bzlmod/">bzlmod</a> / <a href="/fork/rules_rust/ref/patching/tree/examples/bzlmod/cross_compile/">cross_compile</a> / <span class="cur">README.md</span></nav>
<span class="view-stats"><span>9.7 KiB</span><span>288 lines</span></span><span class="actions"><a class="raw" href="/fork/rules_rust/raw/44058603717047fd8b3f2bd58a6916da2e31de62/examples/bzlmod/cross_compile/README.md">raw</a></span></header>
<div class="markdown-view"><input type="radio" name="markdown-view" id="markdown-rendered" checked><label for="markdown-rendered">rendered</label><input type="radio" name="markdown-view" id="markdown-code"><label for="markdown-code">code</label><section class="readme rendered"><h1>Cross Compilation</h1>
<p>For cross compilation, you have to specify a custom platform to let Bazel know that you are compiling for a different platform than the default host platform.</p>
<p>The example code is setup to cross compile from the following hosts to the the following targets:</p>
<ul>
<li>{linux, x86_64} -&gt; {linux, aarch64}</li>
<li>{darwin, x86_64} -&gt; {linux, x86_64}</li>
<li>{darwin, x86_64} -&gt; {linux, aarch64}</li>
<li>{darwin, aarch64 (Apple Silicon)} -&gt; {linux, x86_64}</li>
<li>{darwin, aarch64 (Apple Silicon)} -&gt; {linux, aarch64}</li>
</ul>
<p>You cross-compile by calling the target.</p>
<p><code>bazel build //:hello_world_x86_64</code></p>
<p>or</p>
<p><code>bazel build //:hello_world_aarch64</code></p>
<p>You can also build all targets at once:</p>
<p><code>bazel build //...</code></p>
<p>And you can run all test with:</p>
<p><code>bazel test //...</code></p>
<h2>Setup</h2>
<p>The setup requires three steps, first declare dependencies and toolchains in your MODULE.bazel, second configure LLVM and Rust for cross compilation, and third the configuration of the cross compilation platforms so you can use it binary targets.</p>
<h3>Dependencies Configuration</h3>
<p>You add the required rules for cross compilation to your MODULE.bazel as shown below.</p>
<pre class="language-starlark"><a-c># Rules for cross compilation</a-c>
<a-c># https://github.com/bazelbuild/platforms/releases</a-c>
<a-v>bazel_dep</a-v><a-p>(</a-p><a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;platforms&quot;</a-s><a-p>,</a-p> <a-v>version</a-v> <a-o>=</a-o> <a-s>&quot;0.0.10&quot;</a-s><a-p>)</a-p>
<a-c># https://github.com/bazel-contrib/toolchains_llvm</a-c>
<a-v>bazel_dep</a-v><a-p>(</a-p><a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;toolchains_llvm&quot;</a-s><a-p>,</a-p> <a-v>version</a-v> <a-o>=</a-o> <a-s>&quot;1.0.0&quot;</a-s><a-p>)</a-p></pre>
<h2>LLVM Configuration</h2>
<p>Next, you have to configure the LLVM toolchain because rules_rust still needs a cpp toolchain for cross compilation and
you have to add the specific platform triplets to the Rust toolchain. Suppose you want to compile a Rust binary that
supports linux on both, X86 and ARM. In that case, you have to setup three LLVM toolchains:</p>
<ol>
<li>LLVM for the host</li>
<li>LLVM for X86</li>
<li>LLVM for ARM (aarch64)</li>
</ol>
<p>For the host LLVM, you just specify a LLVM version and then register the toolchain as usual. The target LLVM toolchains,
however, have dependencies on system libraries for the target platform. Therefore, it is required to download a so-
called sysroot that contains a root file system with all those system libraries for the specific target platform.
To do so, please add the following to your MODULE.bazel</p>
<pre class="language-starlark"><a-c># https://github.com/bazelbuild/bazel/blob/master/tools/build_defs/repo/http.bzl</a-c>
<a-v>http_archive</a-v> <a-o>=</a-o> <a-v>use_repo_rule</a-v><a-p>(</a-p><a-s>&quot;@bazel_tools//:http.bzl&quot;</a-s><a-p>,</a-p> <a-s>&quot;http_archive&quot;</a-s><a-p>)</a-p>

<a-c># Both, cross compilation and MUSL still need a C/C++ toolchain with sysroot.</a-c>
<a-v>_BUILD_FILE_CONTENT</a-v> <a-o>=</a-o> <a-s>&quot;&quot;&quot;
filegroup(
  name = &quot;{name}&quot;,
  srcs = glob([&quot;*/**&quot;]),
  visibility = [&quot;//visibility:public&quot;],
)
&quot;&quot;&quot;</a-s>

<a-c># Download sysroot</a-c>
<a-c># https://commondatastorage.googleapis.com/chrome-linux-sysroot/</a-c>
<a-v>http_archive</a-v><a-p>(</a-p>
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;org_chromium_sysroot_linux_x64&quot;</a-s><a-p>,</a-p>
    <a-v>build_file_content</a-v> <a-o>=</a-o> <a-v>_BUILD_FILE_CONTENT</a-v><a-p>.</a-p><a-v>format</a-v><a-p>(</a-p><a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;sysroot&quot;</a-s><a-p>),</a-p>
    <a-v>sha256</a-v> <a-o>=</a-o> <a-s>&quot;f6b758d880a6df264e2581788741623320d548508f07ffc2ae6a29d0c13d647d&quot;</a-s><a-p>,</a-p>
    <a-v>urls</a-v> <a-o>=</a-o> <a-p>[</a-p><a-s>&quot;https://commondatastorage.googleapis.com/chrome-linux-sysroot/toolchain/2e7ada854015a4cc60fc812112d261af44213ed0/debian_bullseye_amd64_sysroot.tar.xz&quot;</a-s><a-p>],</a-p>
<a-p>)</a-p>

<a-v>http_archive</a-v><a-p>(</a-p>
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;org_chromium_sysroot_linux_aarch64&quot;</a-s><a-p>,</a-p>
    <a-v>build_file_content</a-v> <a-o>=</a-o> <a-v>_BUILD_FILE_CONTENT</a-v><a-p>.</a-p><a-v>format</a-v><a-p>(</a-p><a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;sysroot&quot;</a-s><a-p>),</a-p>
    <a-v>sha256</a-v> <a-o>=</a-o> <a-s>&quot;902d1a40a5fd8c3764a36c8d377af5945a92e3d264c6252855bda4d7ef81d3df&quot;</a-s><a-p>,</a-p>
    <a-v>urls</a-v> <a-o>=</a-o> <a-p>[</a-p><a-s>&quot;https://commondatastorage.googleapis.com/chrome-linux-sysroot/toolchain/41a6c8dec4c4304d6509e30cbaf9218dffb4438e/debian_bullseye_arm64_sysroot.tar.xz&quot;</a-s><a-p>],</a-p>
<a-p>)</a-p></pre>
<p>Here, we declare to new http downloads that retrieve the sysroot for linux_x64 (Intel/AMD) and linux_aarch64 (ARM/Apple Silicon). Note, these are only
sysroots, that means you have to configure LLVM next to use these files. As mentioned earlier, three LLVM toolchains
needs to be configured and to do that, please add the following to your MODULE.bazel</p>
<pre class="language-starlark"><a-v>LLVM_VERSIONS</a-v> <a-o>=</a-o> <a-p>{</a-p>
    <a-s>&quot;&quot;</a-s><a-p>:</a-p> <a-s>&quot;16.0.0&quot;</a-s><a-p>,</a-p>
<a-p>}</a-p>

<a-c># Host LLVM toolchain.</a-c>
<a-v>llvm</a-v><a-p>.</a-p><a-v>toolchain</a-v><a-p>(</a-p>
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;llvm_toolchain&quot;</a-s><a-p>,</a-p>
    <a-v>llvm_versions</a-v> <a-o>=</a-o> <a-v>LLVM_VERSIONS</a-v><a-p>,</a-p>
<a-p>)</a-p>
<a-v>use_repo</a-v><a-p>(</a-p><a-v>llvm</a-v><a-p>,</a-p> <a-s>&quot;llvm_toolchain&quot;</a-s><a-p>,</a-p> <a-s>&quot;llvm_toolchain_llvm&quot;</a-s><a-p>)</a-p>

<a-c># X86 LLVM Toolchain with sysroot.</a-c>
<a-c># https://github.com/bazel-contrib/toolchains_llvm/blob/master/tests/WORKSPACE.bzlmod</a-c>
<a-v>llvm</a-v><a-p>.</a-p><a-v>toolchain</a-v><a-p>(</a-p>
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;llvm_toolchain_x86_with_sysroot&quot;</a-s><a-p>,</a-p>
    <a-v>llvm_versions</a-v> <a-o>=</a-o> <a-v>LLVM_VERSIONS</a-v><a-p>,</a-p>
<a-p>)</a-p>
<a-v>llvm</a-v><a-p>.</a-p><a-v>sysroot</a-v><a-p>(</a-p>
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;llvm_toolchain_x86_with_sysroot&quot;</a-s><a-p>,</a-p>
    <a-v>label</a-v> <a-o>=</a-o> <a-s>&quot;@org_chromium_sysroot_linux_x64//:sysroot&quot;</a-s><a-p>,</a-p>
    <a-v>targets</a-v> <a-o>=</a-o> <a-p>[</a-p><a-s>&quot;linux-x86_64&quot;</a-s><a-p>],</a-p>
<a-p>)</a-p>
<a-v>use_repo</a-v><a-p>(</a-p><a-v>llvm</a-v><a-p>,</a-p> <a-s>&quot;llvm_toolchain_x86_with_sysroot&quot;</a-s><a-p>)</a-p>

<a-c>#</a-c>
<a-c># ARM (aarch64) LLVM Toolchain with sysroot.</a-c>
<a-c># https://github.com/bazelbuild/rules_rust/blob/main/examples/bzlmod/cross_compile/WORKSPACE.bzlmod</a-c>
<a-v>llvm</a-v><a-p>.</a-p><a-v>toolchain</a-v><a-p>(</a-p>
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;llvm_toolchain_aarch64_with_sysroot&quot;</a-s><a-p>,</a-p>
    <a-v>llvm_versions</a-v> <a-o>=</a-o> <a-v>LLVM_VERSIONS</a-v><a-p>,</a-p>
<a-p>)</a-p>
<a-v>llvm</a-v><a-p>.</a-p><a-v>sysroot</a-v><a-p>(</a-p>
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;llvm_toolchain_aarch64_with_sysroot&quot;</a-s><a-p>,</a-p>
    <a-v>label</a-v> <a-o>=</a-o> <a-s>&quot;@org_chromium_sysroot_linux_aarch64//:sysroot&quot;</a-s><a-p>,</a-p>
    <a-v>targets</a-v> <a-o>=</a-o> <a-p>[</a-p><a-s>&quot;linux-aarch64&quot;</a-s><a-p>],</a-p>
<a-p>)</a-p>
<a-v>use_repo</a-v><a-p>(</a-p><a-v>llvm</a-v><a-p>,</a-p> <a-s>&quot;llvm_toolchain_aarch64_with_sysroot&quot;</a-s><a-p>)</a-p>

<a-c># Register all LLVM toolchains</a-c>
<a-v>register_toolchains</a-v><a-p>(</a-p><a-s>&quot;@llvm_toolchain//:all&quot;</a-s><a-p>)</a-p></pre>
<p>For simplicity, all toolchains are pinned to version LLVM 16 because it is one of the few releases that supports the
host (apple-darwin / Ubuntu), and the two targets. For a
complete <a href="https://github.com/bazel-contrib/toolchains_llvm/blob/master/toolchain/internal/llvm_distributions.bzl">list off all LLVM releases and supported platforms, see this list.</a>
It is possible to pin different targets to different LLVM
versions; <a href="https://github.com/bazel-contrib/toolchains_llvm/tree/master?tab=readme-ov-file#per-host-architecture-llvm-version">see the documentation for details</a>.</p>
<p>If you face difficulties with building LLVM on older linux distros or your CI,
please take a look at the <a href="/fork/rules_rust/ref/patching/blob/examples/bzlmod/cross_compile/LLVM_Troubleshooting.md">LLVM Troubleshooting guide</a> for known issues.</p>
<p><strong>Rust Toolchain Configuration</strong></p>
<p>The Rust toolchain only need to know the additional platform triplets to download the matching toolchains. To do so, add
or or modify your MODULE.bazel with the following entry:</p>
<pre class="language-starlark"><a-c># Rust toolchain</a-c>
<a-v>RUST_EDITION</a-v> <a-o>=</a-o> <a-s>&quot;2021&quot;</a-s>
<a-v>RUST_VERSION</a-v> <a-o>=</a-o> <a-s>&quot;1.79.0&quot;</a-s>

<a-v>rust</a-v> <a-o>=</a-o> <a-v>use_extension</a-v><a-p>(</a-p><a-s>&quot;@rules_rust//rust:extensions.bzl&quot;</a-s><a-p>,</a-p> <a-s>&quot;rust&quot;</a-s><a-p>)</a-p>
<a-v>rust</a-v><a-p>.</a-p><a-v>toolchain</a-v><a-p>(</a-p>
    <a-v>edition</a-v> <a-o>=</a-o> <a-v>RUST_EDITION</a-v><a-p>,</a-p>
    <a-v>versions</a-v> <a-o>=</a-o> <a-p>[</a-p><a-v>RUST_VERSION</a-v><a-p>],</a-p>
    <a-v>extra_target_triples</a-v> <a-o>=</a-o> <a-p>[</a-p>
        <a-s>&quot;aarch64-unknown-linux-gnu&quot;</a-s><a-p>,</a-p>
        <a-s>&quot;x86_64-unknown-linux-gnu&quot;</a-s><a-p>,</a-p>
    <a-p>],</a-p>
<a-p>)</a-p>
<a-v>use_repo</a-v><a-p>(</a-p><a-v>rust</a-v><a-p>,</a-p> <a-s>&quot;rust_toolchains&quot;</a-s><a-p>)</a-p>
<a-v>register_toolchains</a-v><a-p>(</a-p><a-s>&quot;@rust_toolchains//:all&quot;</a-s><a-p>)</a-p></pre>
<p>You find the exact platform triplets in
the <a href="https://doc.rust-lang.org/nightly/rustc/platform-support.html">Rust platform support documentation</a>.
Next, you have to configure the target platform.</p>
<p><strong>Platform Configuration</strong></p>
<p>Once the dependencies are loaded, create an empty BUILD file to define the cross compilation toolchain targets.
As mentioned earlier, it is best practice to put all custom rules, toolchains, and platform into one folder.
Suppose you have the empty BUILD file in the following path:</p>
<p><code>build/platforms/BUILD.bazel</code></p>
<p>Then you add the following content to the BUILD file:</p>
<pre class="language-starlark"><a-v>package</a-v><a-p>(</a-p><a-v>default_visibility</a-v> <a-o>=</a-o> <a-p>[</a-p><a-s>&quot;//visibility:public&quot;</a-s><a-p>])</a-p>

<a-v>platform</a-v><a-p>(</a-p>
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;linux-aarch64&quot;</a-s><a-p>,</a-p>
    <a-v>constraint_values</a-v> <a-o>=</a-o> <a-p>[</a-p>
        <a-s>&quot;@platforms//os:linux&quot;</a-s><a-p>,</a-p>
        <a-s>&quot;@platforms//cpu:aarch64&quot;</a-s><a-p>,</a-p>
    <a-p>],</a-p>
<a-p>)</a-p>

<a-v>platform</a-v><a-p>(</a-p>
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;linux-x86_64&quot;</a-s><a-p>,</a-p>
    <a-v>constraint_values</a-v> <a-o>=</a-o> <a-p>[</a-p>
        <a-s>&quot;@platforms//os:linux&quot;</a-s><a-p>,</a-p>
        <a-s>&quot;@platforms//cpu:x86_64&quot;</a-s><a-p>,</a-p>
    <a-p>],</a-p>
<a-p>)</a-p></pre>
<p>The default visibility at the top of the file means that all targets in this BUILD file will be public by default, which
is sensible because cross-compilation targets are usually used across the entire project.</p>
<p>It is important to recognize that the platform rules use the constraint values to map those constraints to the target
triplets of the Rust toolchain. If you somehow see errors that says some crate couldn't be found with triple xyz, then
one of two things happened.</p>
<p>Either you forgot to add a triple to the Rust toolchain. Unfortunately, the error message
doesn't always tell you the correct triple that is missing. However, in that case you have to double check if for each
specified platform a corresponding Rust extra_target_triples has been added. If one is missing, add it and the error
goes away.</p>
<p>A second source of error is if the platform declaration contains a typo, for example,
cpu:arch64 instead of cpu:aarch64. You have to be meticulous in the platform declaration to make everything work
smoothly.</p>
<p>With the platform configuration out of the way, you are free to configure your binary targets for the specified
platforms.</p>
<h2>Usage</h2>
<p>Suppose you have a simple hello world that is defined in a single main.rs file. Conventionally, you declare a minimum
binary target as shown below.</p>
<pre class="language-starlark"><a-k>load</a-k><a-p>(</a-p><a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s><a-p>,</a-p><a-k> </a-k><a-s>&quot;rust_binary&quot;</a-s><a-p>)</a-p>

<a-v>rust_binary</a-v><a-p>(</a-p>
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;hello_world_host&quot;</a-s><a-p>,</a-p>
    <a-v>srcs</a-v> <a-o>=</a-o> <a-p>[</a-p><a-s>&quot;src/main.rs&quot;</a-s><a-p>],</a-p>
    <a-v>deps</a-v> <a-o>=</a-o> <a-p>[],</a-p>
<a-p>)</a-p></pre>
<p>Bazel compiles this target to the same platform as the host. To cross-compile the same source file to a different
platform, you simply add one of the platforms previously declared, as shown below.</p>
<pre class="language-starlark"><a-k>load</a-k><a-p>(</a-p><a-s>&quot;@rules_rust//rust:defs.bzl&quot;</a-s><a-p>,</a-p><a-k> </a-k><a-s>&quot;rust_binary&quot;</a-s><a-p>)</a-p>

<a-v>rust_binary</a-v><a-p>(</a-p>
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;hello_world_x86_64&quot;</a-s><a-p>,</a-p>
    <a-v>srcs</a-v> <a-o>=</a-o> <a-p>[</a-p><a-s>&quot;src/main.rs&quot;</a-s><a-p>],</a-p>
    <a-v>platform</a-v> <a-o>=</a-o> <a-s>&quot;//build/platforms:linux-x86_64&quot;</a-s><a-p>,</a-p>
    <a-v>deps</a-v> <a-o>=</a-o> <a-p>[],</a-p>
<a-p>)</a-p>

<a-v>rust_binary</a-v><a-p>(</a-p>
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;hello_world_aarch64&quot;</a-s><a-p>,</a-p>
    <a-v>srcs</a-v> <a-o>=</a-o> <a-p>[</a-p><a-s>&quot;src/main.rs&quot;</a-s><a-p>],</a-p>
    <a-v>platform</a-v> <a-o>=</a-o> <a-s>&quot;//build/platforms:linux-aarch64&quot;</a-s><a-p>,</a-p>
    <a-v>deps</a-v> <a-o>=</a-o> <a-p>[],</a-p>
<a-p>)</a-p></pre>
<p>You then cross-compile by calling the target.</p>
<p><code>bazel build //:hello_world_x86_64</code></p>
<p>or</p>
<p><code>bazel build //:hello_world_aarch64</code></p>
<p>You may have to make the target public when see an access error.</p>
<p>However, when you build for multiple targets, it is sensible to group all of them in a filegroup.</p>
<pre class="language-starlark"><a-v>filegroup</a-v><a-p>(</a-p>
    <a-v>name</a-v> <a-o>=</a-o> <a-s>&quot;all&quot;</a-s><a-p>,</a-p>
    <a-v>srcs</a-v> <a-o>=</a-o> <a-p>[</a-p>
        <a-s>&quot;:hello_world_host&quot;</a-s><a-p>,</a-p>
        <a-s>&quot;:hello_world_x86_64&quot;</a-s><a-p>,</a-p>
        <a-s>&quot;:hello_world_aarch64&quot;</a-s><a-p>,</a-p>
    <a-p>],</a-p>
    <a-v>visibility</a-v> <a-o>=</a-o> <a-p>[</a-p><a-s>&quot;//visibility:public&quot;</a-s><a-p>],</a-p>
<a-p>)</a-p></pre>
<p>Then you build for all platforms by calling the filegroup target:</p>
<p><code>bazel build //:all</code></p>
</section><div class="code-panel"><pre class="code src language-markdown"><span class="code-line"><a class="ln" id="L1" href="#L1">1</a><span class="code-text"><a-p>#</a-p> <a-tt>Cross Compilation</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2" href="#L2">2</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3" href="#L3">3</a><span class="code-text">For cross compilation, you have to specify a custom platform to let Bazel know that you are compiling for a different platform than the default host platform.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4" href="#L4">4</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L5" href="#L5">5</a><span class="code-text">The example code is setup to cross compile from the following hosts to the the following targets:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L6" href="#L6">6</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L7" href="#L7">7</a><span class="code-text"><a-p>* </a-p>{linux, x86_64} -&gt; {linux, aarch64}</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L8" href="#L8">8</a><span class="code-text"><a-p>* </a-p>{darwin, x86_64} -&gt; {linux, x86_64}</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L9" href="#L9">9</a><span class="code-text"><a-p>* </a-p>{darwin, x86_64} -&gt; {linux, aarch64}</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L10" href="#L10">10</a><span class="code-text"><a-p>* </a-p>{darwin, aarch64 (Apple Silicon)} -&gt; {linux, x86_64}</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L11" href="#L11">11</a><span class="code-text"><a-p>* </a-p>{darwin, aarch64 (Apple Silicon)} -&gt; {linux, aarch64}</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L12" href="#L12">12</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L13" href="#L13">13</a><span class="code-text"><a-p>You cross-compile by calling the target.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L14" href="#L14">14</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L15" href="#L15">15</a><span class="code-text"><a-p>`bazel build //:hello_world_x86_64`</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L16" href="#L16">16</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L17" href="#L17">17</a><span class="code-text"><a-p>or</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L18" href="#L18">18</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L19" href="#L19">19</a><span class="code-text"><a-p>`bazel build //:hello_world_aarch64`</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L20" href="#L20">20</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L21" href="#L21">21</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L22" href="#L22">22</a><span class="code-text"><a-p>You can also build all targets at once:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L23" href="#L23">23</a><span class="code-text"><a-p> </a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L24" href="#L24">24</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L25" href="#L25">25</a><span class="code-text"><a-p>`bazel build //...`</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L26" href="#L26">26</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L27" href="#L27">27</a><span class="code-text"><a-p>And you can run all test with:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L28" href="#L28">28</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L29" href="#L29">29</a><span class="code-text"><a-p>`bazel test //...`</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L30" href="#L30">30</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L31" href="#L31">31</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L32" href="#L32">32</a><span class="code-text"><a-p>## </a-p><a-tt>Setup</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L33" href="#L33">33</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L34" href="#L34">34</a><span class="code-text"><a-p>The setup requires three steps, first declare dependencies and toolchains in your MODULE.bazel, second configure LLVM and Rust for cross compilation, and third the configuration of the cross compilation platforms so you can use it binary targets.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L35" href="#L35">35</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L36" href="#L36">36</a><span class="code-text"><a-p>### </a-p><a-tt>Dependencies Configuration</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L37" href="#L37">37</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L38" href="#L38">38</a><span class="code-text"><a-p>You add the required rules for cross compilation to your MODULE.bazel as shown below.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L39" href="#L39">39</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L40" href="#L40">40</a><span class="code-text"><a-p>```</a-p><a-tl>Starlark</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L41" href="#L41">41</a><span class="code-text"><a-p># Rules for cross compilation</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L42" href="#L42">42</a><span class="code-text"><a-p># https://github.com/bazelbuild/platforms/releases</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L43" href="#L43">43</a><span class="code-text"><a-p>bazel_dep(name = &quot;platforms&quot;, version = &quot;0.0.10&quot;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L44" href="#L44">44</a><span class="code-text"><a-p># https://github.com/bazel-contrib/toolchains_llvm</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L45" href="#L45">45</a><span class="code-text"><a-p>bazel_dep(name = &quot;toolchains_llvm&quot;, version = &quot;1.0.0&quot;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L46" href="#L46">46</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L47" href="#L47">47</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L48" href="#L48">48</a><span class="code-text"><a-p>## </a-p><a-tt>LLVM Configuration</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L49" href="#L49">49</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L50" href="#L50">50</a><span class="code-text"><a-p>Next, you have to configure the LLVM toolchain because rules_rust still needs a cpp toolchain for cross compilation and</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L51" href="#L51">51</a><span class="code-text"><a-p>you have to add the specific platform triplets to the Rust toolchain. Suppose you want to compile a Rust binary that</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L52" href="#L52">52</a><span class="code-text"><a-p>supports linux on both, X86 and ARM. In that case, you have to setup three LLVM toolchains:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L53" href="#L53">53</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L54" href="#L54">54</a><span class="code-text"><a-p>1) LLVM for the host</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L55" href="#L55">55</a><span class="code-text"><a-p>2) LLVM for X86</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L56" href="#L56">56</a><span class="code-text"><a-p>3) LLVM for ARM (aarch64)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L57" href="#L57">57</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L58" href="#L58">58</a><span class="code-text"><a-p>For the host LLVM, you just specify a LLVM version and then register the toolchain as usual. The target LLVM toolchains,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L59" href="#L59">59</a><span class="code-text"><a-p>however, have dependencies on system libraries for the target platform. Therefore, it is required to download a so-</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L60" href="#L60">60</a><span class="code-text"><a-p>called sysroot that contains a root file system with all those system libraries for the specific target platform.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L61" href="#L61">61</a><span class="code-text"><a-p>To do so, please add the following to your MODULE.bazel</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L62" href="#L62">62</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L63" href="#L63">63</a><span class="code-text"><a-p>```</a-p><a-tl>Starlark</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L64" href="#L64">64</a><span class="code-text"><a-p># https://github.com/bazelbuild/bazel/blob/master/tools/build_defs/repo/http.bzl</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L65" href="#L65">65</a><span class="code-text"><a-p>http_archive = use_repo_rule(&quot;@bazel_tools//:http.bzl&quot;, &quot;http_archive&quot;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L66" href="#L66">66</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L67" href="#L67">67</a><span class="code-text"><a-p># Both, cross compilation and MUSL still need a C/C++ toolchain with sysroot.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L68" href="#L68">68</a><span class="code-text"><a-p>_BUILD_FILE_CONTENT = &quot;&quot;&quot;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L69" href="#L69">69</a><span class="code-text"><a-p>filegroup(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L70" href="#L70">70</a><span class="code-text"><a-p>  name = &quot;{name}&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L71" href="#L71">71</a><span class="code-text"><a-p>  srcs = glob([&quot;*/**&quot;]),</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L72" href="#L72">72</a><span class="code-text"><a-p>  visibility = [&quot;//visibility:public&quot;],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L73" href="#L73">73</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L74" href="#L74">74</a><span class="code-text"><a-p>&quot;&quot;&quot;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L75" href="#L75">75</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L76" href="#L76">76</a><span class="code-text"><a-p># Download sysroot</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L77" href="#L77">77</a><span class="code-text"><a-p># https://commondatastorage.googleapis.com/chrome-linux-sysroot/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L78" href="#L78">78</a><span class="code-text"><a-p>http_archive(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L79" href="#L79">79</a><span class="code-text"><a-p>    name = &quot;org_chromium_sysroot_linux_x64&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L80" href="#L80">80</a><span class="code-text"><a-p>    build_file_content = _BUILD_FILE_CONTENT.format(name = &quot;sysroot&quot;),</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L81" href="#L81">81</a><span class="code-text"><a-p>    sha256 = &quot;f6b758d880a6df264e2581788741623320d548508f07ffc2ae6a29d0c13d647d&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L82" href="#L82">82</a><span class="code-text"><a-p>    urls = [&quot;https://commondatastorage.googleapis.com/chrome-linux-sysroot/toolchain/2e7ada854015a4cc60fc812112d261af44213ed0/debian_bullseye_amd64_sysroot.tar.xz&quot;],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L83" href="#L83">83</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L84" href="#L84">84</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L85" href="#L85">85</a><span class="code-text"><a-p>http_archive(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L86" href="#L86">86</a><span class="code-text"><a-p>    name = &quot;org_chromium_sysroot_linux_aarch64&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L87" href="#L87">87</a><span class="code-text"><a-p>    build_file_content = _BUILD_FILE_CONTENT.format(name = &quot;sysroot&quot;),</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L88" href="#L88">88</a><span class="code-text"><a-p>    sha256 = &quot;902d1a40a5fd8c3764a36c8d377af5945a92e3d264c6252855bda4d7ef81d3df&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L89" href="#L89">89</a><span class="code-text"><a-p>    urls = [&quot;https://commondatastorage.googleapis.com/chrome-linux-sysroot/toolchain/41a6c8dec4c4304d6509e30cbaf9218dffb4438e/debian_bullseye_arm64_sysroot.tar.xz&quot;],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L90" href="#L90">90</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L91" href="#L91">91</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L92" href="#L92">92</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L93" href="#L93">93</a><span class="code-text"><a-p>Here, we declare to new http downloads that retrieve the sysroot for linux_x64 (Intel/AMD) and linux_aarch64 (ARM/Apple Silicon). Note, these are only</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L94" href="#L94">94</a><span class="code-text"><a-p>sysroots, that means you have to configure LLVM next to use these files. As mentioned earlier, three LLVM toolchains</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L95" href="#L95">95</a><span class="code-text"><a-p>needs to be configured and to do that, please add the following to your MODULE.bazel</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L96" href="#L96">96</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L97" href="#L97">97</a><span class="code-text"><a-p>```</a-p><a-tl>Starlark</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L98" href="#L98">98</a><span class="code-text"><a-p>LLVM_VERSIONS = {</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L99" href="#L99">99</a><span class="code-text"><a-p>    &quot;&quot;: &quot;16.0.0&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L100" href="#L100">100</a><span class="code-text"><a-p>}</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L101" href="#L101">101</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L102" href="#L102">102</a><span class="code-text"><a-p># Host LLVM toolchain.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L103" href="#L103">103</a><span class="code-text"><a-p>llvm.toolchain(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L104" href="#L104">104</a><span class="code-text"><a-p>    name = &quot;llvm_toolchain&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L105" href="#L105">105</a><span class="code-text"><a-p>    llvm_versions = LLVM_VERSIONS,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L106" href="#L106">106</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L107" href="#L107">107</a><span class="code-text"><a-p>use_repo(llvm, &quot;llvm_toolchain&quot;, &quot;llvm_toolchain_llvm&quot;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L108" href="#L108">108</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L109" href="#L109">109</a><span class="code-text"><a-p># X86 LLVM Toolchain with sysroot.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L110" href="#L110">110</a><span class="code-text"><a-p># https://github.com/bazel-contrib/toolchains_llvm/blob/master/tests/WORKSPACE.bzlmod</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L111" href="#L111">111</a><span class="code-text"><a-p>llvm.toolchain(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L112" href="#L112">112</a><span class="code-text"><a-p>    name = &quot;llvm_toolchain_x86_with_sysroot&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L113" href="#L113">113</a><span class="code-text"><a-p>    llvm_versions = LLVM_VERSIONS,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L114" href="#L114">114</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L115" href="#L115">115</a><span class="code-text"><a-p>llvm.sysroot(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L116" href="#L116">116</a><span class="code-text"><a-p>    name = &quot;llvm_toolchain_x86_with_sysroot&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L117" href="#L117">117</a><span class="code-text"><a-p>    label = &quot;@org_chromium_sysroot_linux_x64//:sysroot&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L118" href="#L118">118</a><span class="code-text"><a-p>    targets = [&quot;linux-x86_64&quot;],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L119" href="#L119">119</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L120" href="#L120">120</a><span class="code-text"><a-p>use_repo(llvm, &quot;llvm_toolchain_x86_with_sysroot&quot;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L121" href="#L121">121</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L122" href="#L122">122</a><span class="code-text"><a-p>#</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L123" href="#L123">123</a><span class="code-text"><a-p># ARM (aarch64) LLVM Toolchain with sysroot.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L124" href="#L124">124</a><span class="code-text"><a-p># https://github.com/bazelbuild/rules_rust/blob/main/examples/bzlmod/cross_compile/WORKSPACE.bzlmod</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L125" href="#L125">125</a><span class="code-text"><a-p>llvm.toolchain(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L126" href="#L126">126</a><span class="code-text"><a-p>    name = &quot;llvm_toolchain_aarch64_with_sysroot&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L127" href="#L127">127</a><span class="code-text"><a-p>    llvm_versions = LLVM_VERSIONS,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L128" href="#L128">128</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L129" href="#L129">129</a><span class="code-text"><a-p>llvm.sysroot(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L130" href="#L130">130</a><span class="code-text"><a-p>    name = &quot;llvm_toolchain_aarch64_with_sysroot&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L131" href="#L131">131</a><span class="code-text"><a-p>    label = &quot;@org_chromium_sysroot_linux_aarch64//:sysroot&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L132" href="#L132">132</a><span class="code-text"><a-p>    targets = [&quot;linux-aarch64&quot;],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L133" href="#L133">133</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L134" href="#L134">134</a><span class="code-text"><a-p>use_repo(llvm, &quot;llvm_toolchain_aarch64_with_sysroot&quot;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L135" href="#L135">135</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L136" href="#L136">136</a><span class="code-text"><a-p># Register all LLVM toolchains</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L137" href="#L137">137</a><span class="code-text"><a-p>register_toolchains(&quot;@llvm_toolchain//:all&quot;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L138" href="#L138">138</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L139" href="#L139">139</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L140" href="#L140">140</a><span class="code-text"><a-p>For simplicity, all toolchains are pinned to version LLVM 16 because it is one of the few releases that supports the</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L141" href="#L141">141</a><span class="code-text"><a-p>host (apple-darwin / Ubuntu), and the two targets. For a</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L142" href="#L142">142</a><span class="code-text"><a-p>complete [list off all LLVM releases and supported platforms, see this list.](https://github.com/bazel-contrib/toolchains_llvm/blob/master/toolchain/internal/llvm_distributions.bzl)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L143" href="#L143">143</a><span class="code-text"><a-p>It is possible to pin different targets to different LLVM</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L144" href="#L144">144</a><span class="code-text"><a-p>versions; [see the documentation for details](https://github.com/bazel-contrib/toolchains_llvm/tree/master?tab=readme-ov-file#per-host-architecture-llvm-version).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L145" href="#L145">145</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L146" href="#L146">146</a><span class="code-text"><a-p>If you face difficulties with building LLVM on older linux distros or your CI, </a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L147" href="#L147">147</a><span class="code-text"><a-p>please take a look at the [LLVM Troubleshooting guide](LLVM_Troubleshooting.md) for known issues.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L148" href="#L148">148</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L149" href="#L149">149</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L150" href="#L150">150</a><span class="code-text"><a-p>**Rust Toolchain Configuration**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L151" href="#L151">151</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L152" href="#L152">152</a><span class="code-text"><a-p>The Rust toolchain only need to know the additional platform triplets to download the matching toolchains. To do so, add</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L153" href="#L153">153</a><span class="code-text"><a-p>or or modify your MODULE.bazel with the following entry:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L154" href="#L154">154</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L155" href="#L155">155</a><span class="code-text"><a-p>```</a-p><a-tl>Starlark</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L156" href="#L156">156</a><span class="code-text"><a-p># Rust toolchain</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L157" href="#L157">157</a><span class="code-text"><a-p>RUST_EDITION = &quot;2021&quot;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L158" href="#L158">158</a><span class="code-text"><a-p>RUST_VERSION = &quot;1.79.0&quot;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L159" href="#L159">159</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L160" href="#L160">160</a><span class="code-text"><a-p>rust = use_extension(&quot;@rules_rust//rust:extensions.bzl&quot;, &quot;rust&quot;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L161" href="#L161">161</a><span class="code-text"><a-p>rust.toolchain(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L162" href="#L162">162</a><span class="code-text"><a-p>    edition = RUST_EDITION,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L163" href="#L163">163</a><span class="code-text"><a-p>    versions = [RUST_VERSION],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L164" href="#L164">164</a><span class="code-text"><a-p>    extra_target_triples = [</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L165" href="#L165">165</a><span class="code-text"><a-p>        &quot;aarch64-unknown-linux-gnu&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L166" href="#L166">166</a><span class="code-text"><a-p>        &quot;x86_64-unknown-linux-gnu&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L167" href="#L167">167</a><span class="code-text"><a-p>    ],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L168" href="#L168">168</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L169" href="#L169">169</a><span class="code-text"><a-p>use_repo(rust, &quot;rust_toolchains&quot;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L170" href="#L170">170</a><span class="code-text"><a-p>register_toolchains(&quot;@rust_toolchains//:all&quot;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L171" href="#L171">171</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L172" href="#L172">172</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L173" href="#L173">173</a><span class="code-text"><a-p>You find the exact platform triplets in</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L174" href="#L174">174</a><span class="code-text"><a-p>the [Rust platform support documentation](https://doc.rust-lang.org/nightly/rustc/platform-support.html).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L175" href="#L175">175</a><span class="code-text"><a-p>Next, you have to configure the target platform.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L176" href="#L176">176</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L177" href="#L177">177</a><span class="code-text"><a-p>**Platform Configuration**</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L178" href="#L178">178</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L179" href="#L179">179</a><span class="code-text"><a-p>Once the dependencies are loaded, create an empty BUILD file to define the cross compilation toolchain targets.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L180" href="#L180">180</a><span class="code-text"><a-p>As mentioned earlier, it is best practice to put all custom rules, toolchains, and platform into one folder.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L181" href="#L181">181</a><span class="code-text"><a-p>Suppose you have the empty BUILD file in the following path:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L182" href="#L182">182</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L183" href="#L183">183</a><span class="code-text"><a-p>`build/platforms/BUILD.bazel`</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L184" href="#L184">184</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L185" href="#L185">185</a><span class="code-text"><a-p>Then you add the following content to the BUILD file:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L186" href="#L186">186</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L187" href="#L187">187</a><span class="code-text"><a-p>```</a-p><a-tl>Starlark</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L188" href="#L188">188</a><span class="code-text"><a-p>package(default_visibility = [&quot;//visibility:public&quot;])</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L189" href="#L189">189</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L190" href="#L190">190</a><span class="code-text"><a-p>platform(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L191" href="#L191">191</a><span class="code-text"><a-p>    name = &quot;linux-aarch64&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L192" href="#L192">192</a><span class="code-text"><a-p>    constraint_values = [</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L193" href="#L193">193</a><span class="code-text"><a-p>        &quot;@platforms//os:linux&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L194" href="#L194">194</a><span class="code-text"><a-p>        &quot;@platforms//cpu:aarch64&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L195" href="#L195">195</a><span class="code-text"><a-p>    ],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L196" href="#L196">196</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L197" href="#L197">197</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L198" href="#L198">198</a><span class="code-text"><a-p>platform(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L199" href="#L199">199</a><span class="code-text"><a-p>    name = &quot;linux-x86_64&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L200" href="#L200">200</a><span class="code-text"><a-p>    constraint_values = [</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L201" href="#L201">201</a><span class="code-text"><a-p>        &quot;@platforms//os:linux&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L202" href="#L202">202</a><span class="code-text"><a-p>        &quot;@platforms//cpu:x86_64&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L203" href="#L203">203</a><span class="code-text"><a-p>    ],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L204" href="#L204">204</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L205" href="#L205">205</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L206" href="#L206">206</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L207" href="#L207">207</a><span class="code-text"><a-p>The default visibility at the top of the file means that all targets in this BUILD file will be public by default, which</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L208" href="#L208">208</a><span class="code-text"><a-p>is sensible because cross-compilation targets are usually used across the entire project.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L209" href="#L209">209</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L210" href="#L210">210</a><span class="code-text"><a-p>It is important to recognize that the platform rules use the constraint values to map those constraints to the target</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L211" href="#L211">211</a><span class="code-text"><a-p>triplets of the Rust toolchain. If you somehow see errors that says some crate couldn&#39;t be found with triple xyz, then</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L212" href="#L212">212</a><span class="code-text"><a-p>one of two things happened.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L213" href="#L213">213</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L214" href="#L214">214</a><span class="code-text"><a-p>Either you forgot to add a triple to the Rust toolchain. Unfortunately, the error message</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L215" href="#L215">215</a><span class="code-text"><a-p>doesn&#39;t always tell you the correct triple that is missing. However, in that case you have to double check if for each</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L216" href="#L216">216</a><span class="code-text"><a-p>specified platform a corresponding Rust extra_target_triples has been added. If one is missing, add it and the error</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L217" href="#L217">217</a><span class="code-text"><a-p>goes away.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L218" href="#L218">218</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L219" href="#L219">219</a><span class="code-text"><a-p>A second source of error is if the platform declaration contains a typo, for example,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L220" href="#L220">220</a><span class="code-text"><a-p>cpu:arch64 instead of cpu:aarch64. You have to be meticulous in the platform declaration to make everything work</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L221" href="#L221">221</a><span class="code-text"><a-p>smoothly.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L222" href="#L222">222</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L223" href="#L223">223</a><span class="code-text"><a-p>With the platform configuration out of the way, you are free to configure your binary targets for the specified</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L224" href="#L224">224</a><span class="code-text"><a-p>platforms.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L225" href="#L225">225</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L226" href="#L226">226</a><span class="code-text"><a-p>## </a-p><a-tt>Usage</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L227" href="#L227">227</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L228" href="#L228">228</a><span class="code-text"><a-p>Suppose you have a simple hello world that is defined in a single main.rs file. Conventionally, you declare a minimum</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L229" href="#L229">229</a><span class="code-text"><a-p>binary target as shown below.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L230" href="#L230">230</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L231" href="#L231">231</a><span class="code-text"><a-p>```</a-p><a-tl>Starlark</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L232" href="#L232">232</a><span class="code-text"><a-p>load(&quot;@rules_rust//rust:defs.bzl&quot;, &quot;rust_binary&quot;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L233" href="#L233">233</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L234" href="#L234">234</a><span class="code-text"><a-p>rust_binary(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L235" href="#L235">235</a><span class="code-text"><a-p>    name = &quot;hello_world_host&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L236" href="#L236">236</a><span class="code-text"><a-p>    srcs = [&quot;src/main.rs&quot;],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L237" href="#L237">237</a><span class="code-text"><a-p>    deps = [],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L238" href="#L238">238</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L239" href="#L239">239</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L240" href="#L240">240</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L241" href="#L241">241</a><span class="code-text"><a-p>Bazel compiles this target to the same platform as the host. To cross-compile the same source file to a different</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L242" href="#L242">242</a><span class="code-text"><a-p>platform, you simply add one of the platforms previously declared, as shown below.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L243" href="#L243">243</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L244" href="#L244">244</a><span class="code-text"><a-p>```</a-p><a-tl>Starlark</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L245" href="#L245">245</a><span class="code-text"><a-p>load(&quot;@rules_rust//rust:defs.bzl&quot;, &quot;rust_binary&quot;)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L246" href="#L246">246</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L247" href="#L247">247</a><span class="code-text"><a-p>rust_binary(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L248" href="#L248">248</a><span class="code-text"><a-p>    name = &quot;hello_world_x86_64&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L249" href="#L249">249</a><span class="code-text"><a-p>    srcs = [&quot;src/main.rs&quot;],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L250" href="#L250">250</a><span class="code-text"><a-p>    platform = &quot;//build/platforms:linux-x86_64&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L251" href="#L251">251</a><span class="code-text"><a-p>    deps = [],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L252" href="#L252">252</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L253" href="#L253">253</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L254" href="#L254">254</a><span class="code-text"><a-p>rust_binary(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L255" href="#L255">255</a><span class="code-text"><a-p>    name = &quot;hello_world_aarch64&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L256" href="#L256">256</a><span class="code-text"><a-p>    srcs = [&quot;src/main.rs&quot;],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L257" href="#L257">257</a><span class="code-text"><a-p>    platform = &quot;//build/platforms:linux-aarch64&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L258" href="#L258">258</a><span class="code-text"><a-p>    deps = [],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L259" href="#L259">259</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L260" href="#L260">260</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L261" href="#L261">261</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L262" href="#L262">262</a><span class="code-text"><a-p>You then cross-compile by calling the target.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L263" href="#L263">263</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L264" href="#L264">264</a><span class="code-text"><a-p>`bazel build //:hello_world_x86_64`</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L265" href="#L265">265</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L266" href="#L266">266</a><span class="code-text"><a-p>or</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L267" href="#L267">267</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L268" href="#L268">268</a><span class="code-text"><a-p>`bazel build //:hello_world_aarch64`</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L269" href="#L269">269</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L270" href="#L270">270</a><span class="code-text"><a-p>You may have to make the target public when see an access error.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L271" href="#L271">271</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L272" href="#L272">272</a><span class="code-text"><a-p>However, when you build for multiple targets, it is sensible to group all of them in a filegroup.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L273" href="#L273">273</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L274" href="#L274">274</a><span class="code-text"><a-p>```</a-p><a-tl>Starlark</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L275" href="#L275">275</a><span class="code-text"><a-p>filegroup(</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L276" href="#L276">276</a><span class="code-text"><a-p>    name = &quot;all&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L277" href="#L277">277</a><span class="code-text"><a-p>    srcs = [</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L278" href="#L278">278</a><span class="code-text"><a-p>        &quot;:hello_world_host&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L279" href="#L279">279</a><span class="code-text"><a-p>        &quot;:hello_world_x86_64&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L280" href="#L280">280</a><span class="code-text"><a-p>        &quot;:hello_world_aarch64&quot;,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L281" href="#L281">281</a><span class="code-text"><a-p>    ],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L282" href="#L282">282</a><span class="code-text"><a-p>    visibility = [&quot;//visibility:public&quot;],</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L283" href="#L283">283</a><span class="code-text"><a-p>)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L284" href="#L284">284</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L285" href="#L285">285</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L286" href="#L286">286</a><span class="code-text">Then you build for all platforms by calling the filegroup target:</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L287" href="#L287">287</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L288" href="#L288">288</a><span class="code-text">`bazel build //:all`</span></span></pre></div></div>
</main>
</body>
</html>
