7.1 与 C 互操作 on 编程那些事儿

7.1.1 简单的 C 库

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/android/interoperability/with-c/c-library.html

7.1.1 简单的 C 库

先创建一个小的 C 库：

interoperability/bindgen/libbirthday.h：

1
2
3
4
5
6


typedef struct card {
 const char* name;
 int years;
} card;

void print_card(const card* card);

interoperability/bindgen/libbirthday.c：

1
2
3
4
5
6
7
8
9


#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 文件中：

7.1.2 Bindgen

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/android/interoperability/with-c/bindgen.html

7.1.2 Bindgen

bindgen 工具可以从 C 头文件自动生成绑定。

为该库创建一个包装头文件（本例中并非严格必需）：

interoperability/bindgen/libbirthday_wrapper.h：

1

#include "libbirthday.h"

interoperability/bindgen/Android.bp：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


rust_bindgen {
 name: "libbirthday_bindgen",
 crate_name: "birthday_bindgen",
 wrapper_src: "libbirthday_wrapper.h",
 source_stem: "bindings",
 static_libs: ["libbirthday"],
}
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", // 生成的文件，跳过 lint
 lints: "none",
}

最后，可以在 Rust 程序中使用这些绑定：

7.1.3 运行二进制

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/android/interoperability/with-c/run-our-binary.html

7.1.3 运行二进制

在设备上构建、推送并运行该二进制：

1
2
3


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

最后，可以运行自动生成的测试以确保绑定可用：

7.1.4 简单的 Rust 库

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/android/interoperability/with-c/rust-library.html

7.1.4 简单的 Rust 库

把 Rust 函数与类型导出到 C 很容易。下面是一个简单的 Rust 库：

interoperability/rust/libanalyze/analyze.rs

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


// Copyright 2025 Google LLC
// SPDX-License-Identifier: Apache-2.0
//! Rust FFI 演示。
#![deny(improper_ctypes_definitions)]

use std::os::raw::c_int;

/// 分析这些数字。
// SAFETY: 不存在其他同名的全局函数。
#[unsafe(no_mangle)]
pub extern "C" fn analyze_numbers(x: c_int, y: c_int) {
 if x < y {
 println!("x ({x}) is smallest!");
 } else {
 println!("y ({y}) is probably larger than x ({x})");
 }
}

interoperability/rust/libanalyze/Android.bp

7.1.5 从 C 调用 Rust

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/android/interoperability/with-c/rust.html

7.1.5 从 C 调用 Rust

现在可以从 C 二进制调用它了：

interoperability/rust/libanalyze/analyze.h

1
2
3
4
5
6


#ifndef ANALYZE_H
#define ANALYZE_H

void analyze_numbers(int x, int y);

#endif

interoperability/rust/analyze/main.c

1
2
3
4
5
6
7


#include "analyze.h"

int main() {
 analyze_numbers(10, 20);
 analyze_numbers(123, 123);
 return 0;
}

interoperability/rust/analyze/Android.bp