Uniffi-rs 中处理标准库类型的自定义序列化

在 Uniffi-rs 0.29 版本中，开发者遇到了一个关于自定义类型序列化的兼容性问题。这个问题特别出现在尝试对标准库中的 std::net::Ipv4Addr 类型进行自定义序列化时。

问题背景

在 Uniffi-rs 0.27 版本中，开发者可以使用 uniffi::custom_type! 宏来为外部类型定义自定义的序列化和反序列化逻辑。例如，对于 Ipv4Addr 类型，开发者可能会这样实现：

uniffi::custom_type!(Ipv4Addr, String, {
    try_lift: |val| Ok(Ipv4Addr::from_str(&val)?),
    lower: |val| val.to_string()
});

然而，在升级到 0.29 版本后，这段代码会引发编译错误，提示类型参数必须用于某些本地类型，且只能为当前crate中定义的类型实现外部特性。

问题原因

这个变化源于 Rust 的孤儿规则(Orphan Rule)限制。Rust 不允许为外部类型(如标准库中的类型)直接实现外部特性，除非至少有一个相关类型是本地定义的。这是 Rust 语言设计上为了保证特性实现一致性的重要机制。

在 Uniffi-rs 0.29 版本中，框架内部加强了对这一规则的处理，因此之前可能通过编译的代码现在会被正确地拒绝。

解决方案

对于标准库或其他外部crate中的类型，Uniffi-rs 提供了专门的 remote_custom_type! 宏来处理这种情况。正确的做法应该是：

uniffi::remote_custom_type!(Ipv4Addr, String);

然后，开发者需要为这些类型手动实现 UniffiCustomTypeConverter 特性：

impl UniffiCustomTypeConverter for Ipv4Addr {
    type Builtin = String;

    fn into_custom(val: Self::Builtin) -> uniffi::Result<Self> {
        Ok(Ipv4Addr::from_str(&val)?)
    }

    fn from_custom(obj: Self) -> Self::Builtin {
        obj.to_string()
    }
}

最佳实践

1. 对于本地定义的类型，继续使用 custom_type! 宏
2. 对于标准库或外部crate中的类型，使用 remote_custom_type! 宏
3. 在升级 Uniffi-rs 版本时，检查所有自定义类型的实现是否符合新的规则
4. 考虑将常用的外部类型转换逻辑封装为公共模块，方便项目内复用

总结

Uniffi-rs 0.29 版本对类型系统的处理更加严格，这虽然带来了一些迁移成本，但提高了代码的安全性和正确性。开发者需要区分本地类型和外部类型的处理方式，使用适当的宏来实现跨语言边界的类型转换。这种改变符合 Rust 语言的安全哲学，能够帮助开发者编写出更加健壮的绑定代码。