Comprehensive Rust 教程AIDL 基础类型到 Rust 的映射机制与 Binder 实战【免费下载链接】comprehensive-rustThis is the Rust course used by the Android team at Google. It provides you the material to quickly teach Rust.项目地址: https://gitcode.com/GitHub_Trending/co/comprehensive-rustAndroid 系统通过 AIDLAndroid Interface Definition Language定义跨进程接口而 Google 内部用于教授 Rust 的 Comprehensive Rust 课程 在 AIDL 章节 中系统讲解了 Binder for Rust 的类型翻译规则。本文以课程中 Primitive Types基础类型 一节为核心完整展开 AIDL 基础类型与 Rust 类型的一一映射关系并结合课程附带的生日服务Birthday Service完整示例与类型模块下的姊妹章节讲解集合类型、parcelable、Binder 对象与文件描述符的映射方式帮助你快速掌握用 Rust 编写 AIDL 接口、服务端与客户端时的类型使用规范。AIDL 基础类型到 Rust 的映射总览在 Binder for Rust 中AIDL 的基础类型大部分能自然地idiomatically映射为对应的 Rust 类型。课程的 primitives.md 给出了完整对照表AIDL 类型Rust 类型说明booleanbool布尔类型直接对应bytei8注意字节是有符号的charu16注意是u16而不是u32inti32与 Rust 惯例一致longi6464 位有符号整数floatf32单精度浮点doublef64双精度浮点StringString字符串直接对应容易踩坑的两个意外这张表中最值得注意的不是int - i32这样的常规映射而是两处与直觉相悖的地方byte是有符号的i8。Java 中的byte是无符号语义较弱范围为 -128..127的 8 位类型而 AIDL 将其映射为 Rust 的i8。在跨语言调用时如果 Java/Kotlin 端把byte当作 0..255 的无符号值使用Rust 端读到负数时可能出现逻辑错误需要自行按位转换。char映射为u16而非u32。这是 AIDL 与 Rust 对字符理解差异的直接体现AIDL 的char是 UTF-16 的代码单元code unit而非 Unicode 标量值scalar value。Rust 的原生char类型是 4 字节的 Unicode 标量值直接映射会导致语义不一致因此 Binder 选择用u16承载 AIDL 的char以精确对应 Java 端char的 UTF-16 语义。这些注意注释并非课程随意标注而是 Binder for Rust 生成代码时真实遵循的规则。以课程 生日服务示例 的接口定义 IBirthdayService.aidl 为证/** Generate a Happy Birthday message. */ String wishHappyBirthday(String name, int years);其在服务端实现 src/lib.rs 中对应的 Rust 方法签名为fn wishHappyBirthday(self, name: str, years: i32) - binder::ResultStringString - str、int - i32的对应关系与基础类型表完全吻合且方法第一个参数name作为in参数在 Rust 侧以str引用形式出现——这正是下一节要展开的方向参数规则。由方向Direction决定的基础类型参数形态AIDL 接口方法参数带有方向修饰符in、out、inout这直接影响它们在 Rust 侧的类型形态。虽然primitives.md只给出基础类型本身的映射但课程 Array Types数组类型 一节以数组为例给出了方向规则该规则对基础类型同样成立参数位置Rust 类型in参数T/[T]out/inout参数mut T/mut VecT返回值T/VecT也就是说基础类型表里展示的bool、i32、String等是数据本体的映射在实际接口签名中还会叠加方向形态in String name在 Rust 侧是str或String课程实现中即使用strout、inout参数需要可变引用mut T因为服务端要回写数据返回值则直接返回拥有所有权的T。以课程示例接口IBirthdayInfoProvider.aidl为例interface IBirthdayInfoProvider { String name(); int years(); }对应的 Rust 实现见 client.rs是impl IBirthdayInfoProvider for InfoProvider { fn name(self) - binder::ResultString { Ok(self.name.clone()) } fn years(self) - binder::Resulti32 { Ok(self.age as i32) } }无参数的方法自然不涉及方向修饰符返回值直接是String与i32与基础类型表一一对应。从基础类型到集合与自定义类型基础类型是 AIDL 类型系统的地基课程 Working With AIDL Types 概括了整层体系基础类型映射为地道的 Rust 类型切片、Vec与字符串等集合类型受支持AIDL 对象引用与文件句柄可在客户端与服务端之间传递。以下简要梳理与基础类型紧密相邻的几类扩展。数组与列表T[]、byte[]、ListT数组类型按其在函数签名中的位置翻译成不同的 Rust 类型arrays.md位置Rust 类型in参数[T]out/inout参数mut VecT返回值VecT此外课程补充了两点细节Android 13 及以上支持定长数组T[N]翻译为[T; N]且支持多维如int[3][4]在 Java 后端定长数组表示为数组类型parcelable 字段中的数组则始终翻译为VecT。Parcelable结构化的数据载体Parcelable 可直接在 Binder for Rust 中传输parcelables.md。课程的 BirthdayInfo.aidl 定义了parcelable BirthdayInfo { String name; int years; }接口通过wishWithInfo(in BirthdayInfo info)使用它客户端只需构造同名 Rust 结构体即可发送let info BirthdayInfo { name: Alice.into(), years: 123 }; service.wishWithInfo(info)?;可以看到parcelable 内部的String name、int years字段正是基础类型映射规则的直接应用——它们翻译成了 Rust 结构体的String与i32字段。Binder 对象具体接口与类型擦除的IBinderAIDL 对象既可作为具体 AIDL 类型发送也可作为类型擦除的IBinder发送objects.md。课程示例中客户端用BnBirthdayInfoProvider::new_binder构造实现了IBirthdayInfoProvider的 Rust 结构体然后分别以具体接口和SpIBinder即IBinder的强引用两种方式传给服务端见 client.rslet provider BnBirthdayInfoProvider::new_binder( InfoProvider { name: name.clone(), age: years as u8 }, BinderFeatures::default(), ); service.wishWithProvider(provider)?; service.wishWithErasedProvider(provider.as_binder())?;服务端在收到类型擦除的SpIBinder后可通过into_interface::dyn IBirthdayInfoProvider()将其还原为具体接口再调用见 src/lib.rs。文件描述符ParcelFileDescriptor文件可以通过ParcelFileDescriptor类型在 Binder 客户端与服务端之间传递file-descriptor.md。客户端用ParcelFileDescriptor::new(file)包装一个File后发送服务端则通过as_ref().try_clone()克隆OwnedFd并转回File读取内容见 src/lib.rs 的wishFromFile实现。课程指出ParcelFileDescriptor包装了一个OwnedFd因此既能由File或任何包装OwnedFd的类型创建也能在对端用来创建新的File句柄其他类型的文件描述符如 TCP、UDP、UNIX socket同样可以被包装发送。在真实工程中验证映射生日服务完整链路基础类型的映射最终落在可编译、可运行的真实代码中。课程的 Birthday Service 示例展示了从 AIDL 定义到 Rust 服务端、客户端的完整闭环可用于验证上述所有类型规则。接口定义IBirthdayService.aidl含基础类型、parcelable、Binder 对象、文件描述符四类方法服务端实现src/server.rs注册服务、加入线程池与 src/lib.rsIBirthdayServicetrait 的具体实现客户端调用src/client.rsbinder::get_interface::dyn IBirthdayService(SERVICE_IDENTIFIER)获取远程接口后依次调用各方法构建配置Android.bprust_library生成libbirthdayservicerust_binary分别产出birthday_server与birthday_client均依赖 AIDL 自动生成的 Rust cratecom.example.birthdayservice-rust。值得注意的是服务端与客户端依赖的com_example_birthdayservicecrate 正是由aidl_interface构建规则根据.aidl文件自动生成的其中所有接口方法签名都已按本文所述的基础类型映射与方向规则翻译成 Rust 形态——你只需要按照映射表编写实现与调用代码类型安全由生成代码保证。小结掌握 AIDL 基础类型映射是使用 Binder for Rust 的第一步。核心要点可浓缩为绝大多数类型直接了当boolean-bool、int-i32、long-i64、float-f32、double-f64、String-String两个特殊规则必须牢记byte是有符号的i8char是u16UTF-16 代码单元而非u32类型映射之上还要叠加参数方向形态in参数多为引用如str、[T]out/inout参数是mut返回值为拥有所有权的值集合数组、Vec、parcelable、Binder 对象与ParcelFileDescriptor共同构成完整的 AIDL 类型体系基础类型是理解这一切的地基。在编写或审查 Rust 版 AIDL 接口时不妨对照课程的 基础类型表 与生日服务示例逐项核验可以大幅减少跨进程类型不匹配带来的隐性 bug。【免费下载链接】comprehensive-rustThis is the Rust course used by the Android team at Google. It provides you the material to quickly teach Rust.项目地址: https://gitcode.com/GitHub_Trending/co/comprehensive-rust创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
