Google Git
Sign in
android / toolchain / android_rust

Bug: 135760423

Clone this repo:

Branches

  1. 831aeb0 Merge "Add --strip-only option to boltifyer.py" into main by Chris Wailes · 6 hours ago main master
  2. 9ed94eb Correct the arguments to the stage5-merge build target by Chris Wailes · 16 hours ago
  3. 9d51663 Merge "Enable zstd when building LLVM" into main by Chris Wailes · 16 hours ago
  4. c49c0a5 Enable zstd when building LLVM by Chris Wailes · 24 hours ago
  5. 26821c8 Generate BOLT profiles relative to the binary for pipeline Stage 5 by Chris Wailes · 2 days ago

Android Rust Toolchain

This repository contains the code and data necessary to build and test a Rust toolchain for the Android Open Source Project. Detailed information on several topics can be found in our documents/ directory:

Supported Architectures and Targets

The Android Rust toolchain can generate code for the following architectures:

  • aarch64
  • arm
  • RISCV
  • x86
  • x86_64

In addition, prebuilt standard libraries are available for the following target triples:

  • aarch64-linux-android
  • aarch64-unknown-none
  • aarch64-unknown-uefi
  • armv7-linux-androideabi
  • armv7a-none-eabi
  • i686-linux-android
  • i686-unknown-linux-gnu
  • i686-unknown-linux-musl
  • i686-unknown-uefi
  • riscv32i-unknown-none-elf
  • riscv32imc-unknown-none-elf
  • x86_64-linux-android
  • x86_64-pc-windows-gnu
  • x86_64-unknown-linux-gnu
  • x86_64-unknown-linux-musl
  • x86_64-unknown-uefi

Reproducing Android Toolchains

Starting with Rust 1.56.1 it is possible to reproduce Android‘s Rust toolchain prebuilts. To do this you will start with the prebuilt’s manifest, which is located in the prebuilts/rust/linux-x86/<version> directory. Starting with Rust 1.61.0 the manifest is also available in the toolchain/android_rust/artifacts/<version> directory.

To begin reproducing a given build navigate to a new directory and run the following command:

$ repo init -m /path/to/manifest.xml -b rust-toolchain && repo sync -c -j16

To reproduce toolchains before Rust version 1.61.0 run the following command:

$ ./toolchain/android_rust/tools/build.py --lto thin --llvm-linkage shared

To reproduce toolchains version 1.61.0 and above use the build commands listed in the toolchain/android_rust/artifacts/<version>/rust_build_command.<target>.<build id>.sh files. Be sure to replace the paths to the PGO profiles from the saved commands with paths to the profiles in the artifacts directory.

Contact

This project is developed and maintained by the android-rust-toolchain@ team and the best way to contact us is the team email alias.