Starting March 27, 2025, we recommend using android-latest-release instead of aosp-main to build and contribute to AOSP. For more information, see Changes to AOSP.

Hello Rust example

The following is an example of constructing a Rust binary that depends on a Rust library.

Rust modules are currently confined to specific directories defined in build/soong/rust/config/allowed_list.go. The following helloWorld module uses the external/rust directory to avoid modifying this list.

From the AOSP source root

mkdir-pexternal/rust/hello_rust/src/
mkdir-pexternal/rust/libsimple_printer/src/

Create external/rust/hello_rust/src/hello_rust.rs with the following contents:

usesimple_printer;
fnmain(){
simple_printer::print_hello_rust();
}

Create external/rust/libsimple_printer/src/lib.rs file with the following contents:

pubfnprint_hello_rust(){
println!("Hello Rust!");
}

Create an external/rust/hello_rust/Android.bp file with the following contents:

rust_binary{
name:"hello_rust",
// srcs must contain a single source file, the entry point source.
srcs:["src/hello_rust.rs"],
// rustlibs are Rust library dependencies. The type, rlib (static) or dylib
// (dynamic), are chosen automatically based on module type and target
// to avoid linkage issues.
rustlibs:["libsimple_printer"],
// define any additional compilation flags
flags:[
"-C debug-assertions=yes",
],
// cc libraries can be linked in to rust binaries and libraries through the
// shared_libs and static_libs properties. These are not needed for this
// simple example, so they are not included.
}

Create an external/rust/libsimple_printer/Android.bp file with the following contents:

// rust_library provides dylib and rlib variants.
rust_library{
//name or stem properties must be of the form lib<crate_name><any_suffix>
name:"libsimple_printer",
//crate_name must match the name used in source (e.g. extern crate <name>)
crate_name:"simple_printer",
//srcs must contain a single source file, the entry point source
srcs:["src/lib.rs"],
}

Finally, build your hello_rust module:

sourcebuild/envsetup.sh
lunchaosp_arm64-eng
mhello_rust

Hello Rust example Stay organized with collections Save and categorize content based on your preferences.

Hello Rust example