דוגמה ל-Hello Rust

הדוגמה הבאה מראה איך ליצור קובץ בינארי של Rust שתלוי בספריית Rust.

מודולי Rust מוגבלים כרגע לספריות ספציפיות שמוגדרות ב-build/soong/rust/config/allowed_list.go. מודול helloWorld הבא משתמש בספרייה external/rust כדי להימנע משינוי הרשימה הזו.

מתיקיית הבסיס של המקור ב-AOSP

mkdir -p external/rust/hello_rust/src/
mkdir -p external/rust/libsimple_printer/src/

יוצרים את הקובץ external/rust/hello_rust/src/hello_rust.rs עם התוכן הבא:

use simple_printer;
fn main() {
 simple_printer::print_hello_rust();
}

יוצרים קובץ external/rust/libsimple_printer/src/lib.rs עם התוכן הבא:

pub fn print_hello_rust() {
  println!("Hello Rust!");
}

יוצרים קובץ external/rust/hello_rust/Android.bp עם התוכן הבא:

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.
}

יוצרים קובץ external/rust/libsimple_printer/Android.bp עם התוכן הבא:

// 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"],
}

לבסוף, בונים את מודול hello_rust:

source build/envsetup.sh
lunch aosp_arm64-eng
m hello_rust