使用 Bindgen

bindgen 工具可從 C 標頭檔案自動產生繫結。

首先,請建立小型 C 程式庫:

__interoperability/bindgen/libbirthday.h:

typedef struct card { const char* name; int years; } card; void print_card(const card* card);

__interoperability/bindgen/libbirthday.c:

#include <stdio.h> #include "libbirthday.h" void print_card(const card* card) { printf("+--------------\n"); printf("| Happy Birthday %s!\n", card->name); printf("| Congratulations with the %i years!\n", card->years); printf("+--------------\n"); }

請將以下內容加入 Android.bp 檔案:

__interoperability/bindgen/Android.bp:

cc_library { name: "libbirthday", srcs: ["libbirthday.c"], }

為程式庫建立包裝函式標頭檔案 (在此範例中不一定需要):

__interoperability/bindgen/libbirthday_wrapper.h:

#include "libbirthday.h"

您現在可以自動產生繫結:

__interoperability/bindgen/Android.bp:

rust_bindgen { name: "libbirthday_bindgen", crate_name: "birthday_bindgen", wrapper_src: "libbirthday_wrapper.h", source_stem: "bindings", static_libs: ["libbirthday"], }

最後,我們可以在 Rust 程式中使用繫結:

__interoperability/bindgen/Android.bp:

rust_binary { name: "print_birthday_card", srcs: ["main.rs"], rustlibs: ["libbirthday_bindgen"], }

__interoperability/bindgen/main.rs:

//! Bindgen demo. use birthday_bindgen::{card, print_card}; fn main() { let name = std::ffi::CString::new("Peter").unwrap(); let card = card { name: name.as_ptr(), years: 42 }; // SAFETY: `print_card` is safe to call with a valid `card` pointer. unsafe { print_card(&card as *const card); } }

建構、推送及在裝置上執行二進位檔:

m print_birthday_card adb push "$ANDROID_PRODUCT_OUT/system/bin/print_birthday_card" /data/local/tmp adb shell /data/local/tmp/print_birthday_card

最後,我們可以執行自動產生的測試,確保繫結正常運作:

__interoperability/bindgen/Android.bp:

rust_test { name: "libbirthday_bindgen_test", srcs: [":libbirthday_bindgen"], crate_name: "libbirthday_bindgen_test", test_suites: ["general-tests"], auto_gen_config: true, clippy_lints: "none", // Generated file, skip linting lints: "none", }
atest libbirthday_bindgen_test