Comprehensive Rust 实战使用 AIDLParcelFileDescriptor在 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-rust导读本文聚焦 Google Android 团队 Rust 课程comprehensive-rust中 AIDL 类型处理的关键一环——通过ParcelFileDescriptor在 Binder 客户端与服务端之间安全传递文件句柄。你将掌握在 AIDL 接口中声明文件参数、在 Rust 服务端把收到的文件描述符还原为可读的File、在客户端从普通文件构造ParcelFileDescriptor并发送以及理解其底层OwnedFd包装模型与可扩展场景。文中所有示例均来自仓库内完整可运行的 birthday_service 样例可对照源码逐行验证。一、为什么需要传递文件描述符在 Android 的 Binder 架构中客户端与服务端运行在各自进程内。某些业务场景下客户端希望把本地文件的内容交给服务端处理但又不想逐字节拷贝数据——例如把一份配置文件、一张图片或一段日志传给系统服务解析。AIDL 为此提供了ParcelFileDescriptor类型它不是把文件内容序列化进 Binder 事务而是在进程间传递文件描述符本身。接收方拿到的是指向同一底层文件或管道、套接字的有效句柄可以直接进行读写。这正是 src/android/aidl/types/file-descriptor.md 所讲解的核心能力也是本课程 AIDL 类型体系见 src/android/aidl/types.md中文件句柄可以在客户端与服务端之间发送的具体实现。二、在 AIDL 接口中声明文件参数完整示例位于 birthday_service 目录其 AIDL 接口定义在 IBirthdayService.aidl 中package com.example.birthdayservice; import com.example.birthdayservice.IBirthdayInfoProvider; import com.example.birthdayservice.BirthdayInfo; /** Birthday service interface. */ interface IBirthdayService { /** Generate a Happy Birthday message. */ String wishHappyBirthday(String name, int years); /** The same thing, but with a parcelable. */ String wishWithInfo(in BirthdayInfo info); /** The same thing, but using a binder object. */ String wishWithProvider(IBirthdayInfoProvider provider); /** The same thing, but using IBinder. */ String wishWithErasedProvider(IBinder provider); /** The same thing, but loads info from a file. */ String wishFromFile(in ParcelFileDescriptor infoFile); }注意最后一行方法参数类型为ParcelFileDescriptor并显式使用方向修饰符in。与课程中其他 AIDL 类型的翻译规则一致基础类型参见 primitives.md、数组类型参见 arrays.mdParcelFileDescriptor会被 AIDL 编译器翻译为 Rust 侧的binder::ParcelFileDescriptor类型在生成的 trait 方法签名中以引用形式出现。AIDL 接口由 Android 构建系统的aidl_interface模块编译Rust 后端需要显式开启见 aidl/Android.bpaidl_interface { name: com.example.birthdayservice, srcs: [com/example/birthdayservice/*.aidl], unstable: true, backend: { rust: { // Rust is not enabled by default enabled: true, }, }, }从源码结构看类型映射生成代码位于 cratecom_example_birthdayservice的aidl::com::example::birthdayservice模块下。服务端实现文件 src/lib.rs 的导入语句可以印证这一映射关系use com_example_birthdayservice::binder::{self, ParcelFileDescriptor, SpIBinder, Strong};ParcelFileDescriptor直接从bindercrate 中导入说明它由 binder-rust 运行时提供而非每个 AIDL 模块单独生成。三、服务端把描述符还原为文件并读取服务端对wishFromFile的实现完整展示了ParcelFileDescriptor→File的转换过程见 src/lib.rsfn wishFromFile( self, info_file: ParcelFileDescriptor, ) - binder::ResultString { // Convert the file descriptor to a File. ParcelFileDescriptor wraps // an OwnedFd, which can be cloned and then used to create a File // object. let mut info_file info_file .as_ref() .try_clone() .map(File::from) .expect(Invalid file handle); let mut contents String::new(); info_file.read_to_string(mut contents).unwrap(); let mut lines contents.lines(); let name lines.next().unwrap(); let years: i32 lines.next().unwrap().parse().unwrap(); Ok(format!(Happy Birthday {name}, congratulations with the {years} years!)) }这里的要点ParcelFileDescriptor包装一个OwnedFd标准库中的自有文件描述符类型因此它可以由任意同样包装OwnedFd的类型转换而来也可以反向转换出新的File句柄。as_ref().try_clone()先取底层OwnedFd的克隆再用File::from将其包装为标准库File。克隆而非直接消费是因为收到的参数是共享引用ParcelFileDescriptor且克隆后原始描述符仍可用于后续操作。拿到File之后就可以像操作本地文件一样使用std::io::Read读取内容。本例按行解析出名字与年龄拼装出生日祝福字符串。impl IBirthdayService for BirthdayService所在的这个 impl 块需要先实现binder::Interfacetrait同文件中impl binder::Interface for BirthdayService {}这是所有 Binder 服务实现类的共同要求。四、客户端从文件构造描述符并发送客户端侧的关键操作是用普通File创建ParcelFileDescriptor再发出见 src/client.rs// Open a file and put the birthday info in it. let mut file File::create(/data/local/tmp/birthday.info).unwrap(); writeln!(file, {name})?; writeln!(file, {years})?; // Create a ParcelFileDescriptor from the file and send it. let file ParcelFileDescriptor::new(file); service.wishFromFile(file)?;调用链分析客户端先通过binder::get_interface::dyn IBirthdayService(birthdayservice)获取服务端代理binder::ProcessState::start_thread_pool()之后得到service。在本地文件系统创建/data/local/tmp/birthday.info写入两行文本第一行是名字第二行是年龄。调用ParcelFileDescriptor::new(file)——File内部持有OwnedFd被整体包装进ParcelFileDescriptor此刻文件内容并未被序列化。把file传给service.wishFromFile(...)AIDL 绑定层负责把文件描述符写入 Binder 事务并传递到服务端进程。服务端在独立进程中收到描述符后读取同一文件的内容并返回祝福消息。服务端注册供对照服务进程如何暴露这个接口见 src/server.rslet birthday_service BirthdayService; let birthday_service_binder BnBirthdayService::new_binder( birthday_service, binder::BinderFeatures::default(), ); binder::add_service(SERVICE_IDENTIFIER, birthday_service_binder.as_binder()) .expect(Failed to register service); binder::ProcessState::join_thread_pool();服务端用生成的BnBirthdayService::new_binder包装实现对象注册到系统服务管理器随后进入线程池等待请求。客户端与服务端通过统一的SERVICE_IDENTIFIER birthdayservice字符串建立连接。五、底层模型与扩展场景ParcelFileDescriptor的运作模型可以概括为句柄转移内容共享包装关系ParcelFileDescriptor包装一个OwnedFd。因此它可以由File或任何包装OwnedFd的类型构造而来接收方拿到后又能用它创建出一个新的File句柄双方操作的是同一个内核对象。零拷贝语义传递的是文件描述符而非文件内容大文件场景下避免了跨进程拷贝的开销不过需要注意的是发送方与接收方共享的是同一文件偏移等内核状态使用时应考虑并发读写的影响。不止普通文件ParcelFileDescriptor并不限于磁盘文件。同样可以包装并发送其他类型的文件描述符例如 TCP、UDP 与 UNIX 域套接字。这意味着服务端可以接收客户端传来的已建立连接如 socket 对端直接在该连接上进行读写——这是构建连接转移式 IPC 设计的常用手法。从仓库实现看该样例与同课程的 parcelable 示例wishWithInfo(in BirthdayInfo info)和 binder 对象传递示例wishWithProvider(IBirthdayInfoProvider provider)共同组成了 AIDL 传递三类引用式数据的完整教学parcelable结构化值、binder 对象接口引用、文件描述符内核句柄对应 types.md 中文件句柄与 parcelables 得到完整支持的表述。六、实操检查清单要在自己的 AIDL 服务中复用这套模式可按以下步骤核对AIDL 侧在接口方法中声明in ParcelFileDescriptor xxx参数并在aidl_interface模块的backend.rust中设置enabled: true。服务端在 trait 实现方法中接收ParcelFileDescriptor通过as_ref().try_clone().map(File::from)转成File再按业务需求读取必要时用Result/expect处理无效句柄。客户端用File::open/File::create等拿到文件再ParcelFileDescriptor::new(file)包装后随方法调用发出。运行前提客户端与服务端需运行在同一设备或模拟器上服务端先注册客户端再通过服务名连接示例中文件路径/data/local/tmp/birthday.info属于可写目录可替换为实际业务路径。总结ParcelFileDescriptor是 AIDL 跨进程传递文件句柄的标准通道comprehensive-rust 课程通过 birthday_service 样例完整演示了声明 → 发送 → 还原 → 读取的全链路。其底层围绕OwnedFd的包装与克隆模型让文件、套接字等描述符类资源可以轻量地在 Binder 两端流转是编写 Android 系统服务与工具类应用时非常实用的 IPC 能力。【免费下载链接】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），仅供参考