当前位置：首页 > news >正文

UniFFI-rs 过程宏使用指南：简化多语言绑定的终极方案

news 2026/4/21 7:43:08

UniFFI-rs 过程宏使用指南：简化多语言绑定的终极方案

【免费下载链接】uniffi-rsa multi-language bindings generator for rust项目地址: https://gitcode.com/gh_mirrors/un/uniffi-rs

UniFFI-rs 是一个强大的 Rust 多语言绑定生成器，它通过过程宏（Procedural Macros）提供了一种直观的方式来定义跨语言接口，无需手动编写繁琐的绑定代码。本文将详细介绍如何利用 UniFFI-rs 的过程宏功能，快速实现 Rust 代码与 Kotlin、Swift、Python 等多种语言的无缝集成。

UniFFI-rs 如何简化多语言绑定开发？

传统的跨语言开发往往需要手动编写大量 FFI 代码和绑定层，不仅容易出错，还会导致接口定义与实现代码的同步问题。UniFFI-rs 通过过程宏机制，允许开发者直接在 Rust 代码中定义接口，自动生成目标语言的绑定代码，从而大幅提升开发效率。

图：UniFFI-rs 的架构示意图，展示了从接口定义到生成多语言绑定的完整流程

快速上手：过程宏基础配置

使用 UniFFI-rs 过程宏前，需要在Cargo.toml中添加依赖：

[dependencies] uniffi = "0.25"

如果项目完全基于过程宏定义接口（不使用 UDL 文件），需在 Rust 代码入口处调用脚手架设置宏：

uniffi::setup_scaffolding!();

⚠️ 注意：不要同时使用setup_scaffolding!()和include_scaffolding!()，这会导致编译错误。

核心过程宏详解

1.`#[uniffi::export]`：暴露 Rust 函数与类型

#[uniffi::export]是最基础也最常用的过程宏，可用于标记需要暴露给其他语言的函数、实现块和 trait 定义。

函数导出示例：

#[uniffi::export] fn greet(name: String) -> String { format!("Hello, {}!", name) }

接口实现导出：

#[uniffi::export] impl Calculator { #[uniffi::constructor] fn new() -> Arc<Self> { Arc::new(Self::default()) } #[uniffi::method] fn add(&self, a: i32, b: i32) -> i32 { a + b } }

2. 类型导出宏：`#[derive(uniffi::Record)]`与`#[derive(uniffi::Enum)]`

UniFFI-rs 提供了多种派生宏，用于导出 Rust 结构体和枚举：

#[derive(uniffi::Record)]：导出数据结构（类似 Kotlin 数据类）
#[derive(uniffi::Enum)]：导出枚举类型
#[derive(uniffi::Error)]：导出错误类型

示例：

#[derive(uniffi::Record)] pub struct User { pub id: u64, pub name: String, pub email: Option<String>, } #[derive(uniffi::Enum)] pub enum UserStatus { Active, Inactive, Suspended { reason: String }, }

3. 接口与 trait 导出

对于需要在其他语言中实现的接口，可使用#[uniffi::export]标记 trait：

#[uniffi::export] pub trait Logger { fn log(&self, message: String, level: LogLevel); }

高级技巧：条件编译与平台特定代码

UniFFI-rs 支持使用 Rust 的条件编译特性，为不同平台生成特定绑定：

#[cfg(target_os = "android")] #[uniffi::export] impl PlatformUtils { fn get_android_api_level() -> i32 { // Android 平台特有实现 } } #[cfg(target_os = "ios")] #[uniffi::export] impl PlatformUtils { fn get_ios_version() -> String { // iOS 平台特有实现 } }

若需将绑定生成作为可选功能，可结合cfg_attr使用：

#[cfg_attr(feature = "uniffi", uniffi::export)] impl FeatureFlagService { #[cfg_attr(feature = "uniffi", uniffi::method)] fn is_enabled(&self, flag: &str) -> bool { // 实现代码 } }

UDL 与过程宏混合使用

UniFFI-rs 支持同时使用 UDL 文件和过程宏定义接口。此时需确保 crate 名称与 UDL 中的命名空间匹配：

// api.udl namespace my_crate { interface Database { void initialize(); }; }

// lib.rs struct Database { /* ... */ } // UDL 中定义的方法实现 impl Database { fn initialize(&self) { /* ... */ } } // 过程宏导出额外方法 #[uniffi::export] impl Database { fn query(&self, sql: String) -> Vec<Row> { /* ... */ } }