Xamarin Android API 33+ 中 Bundle.GetParcelable 废弃问题的解决方案与类型安全迁移指南

android API 33 (Tiramisu) 起，Bundle.GetParcelable(String) 方法已被废弃，推荐使用类型安全的 GetParcelable(string, class)。本文旨在为 xamarin.Android 开发者提供详细的迁移指南，解决在活动间传递自定义 Parcelable 对象时遇到的废弃警告。我们将深入探讨新 API 的用法，特别是如何正确地为 C# 类提供 Java Class 对象，确保代码的兼容性和前瞻性，避免未来版本更新带来的兼容性问题。

理解 Bundle.GetParcelable 的废弃与类型安全

在 Android 开发中，Bundle 是一个常用的数据容器，用于在组件之间（如 Activity 之间）传递数据。传统上，我们使用 Bundle.GetParcelable(string key) 方法来检索存储的 Parcelable 对象。然而，从 Android API 33 (Tiramisu) 开始，此方法已被标记为废弃（@Deprecated），并建议使用新的、类型更安全的 GetParcelable(String key, Class clazz) 方法。

原有的 GetParcelable(string key) 方法签名如下（摘自 Android 源码）：

/* @deprecated Use the type-safer {@link #getParcelable(String, Class)} starting from Android *      {@link Build.VERSION_CODES#TIRAMISU}. */ @Deprecated @NULLable public <T extends Parcelable> T getParcelable(@Nullable String key) {   // Implementation here }

其主要问题在于它返回一个泛型的 T 类型，但没有在方法签名中强制指定 T 的具体类型，从而可能导致运行时类型转换错误。为了提高类型安全性并减少潜在的运行时异常，新的 API 引入了 Class 参数，明确指定期望返回的 Parcelable 对象的类型。

新的 GetParcelable(String key, Class clazz) 方法签名及注释：

/**  * Returns the value associated with the given key or {@code null} if:  * <ul>  *     <li>No mapping of the desired type exists for the given key.  *     <li>A {@code null} value is explicitly associated with the key.  *     <li>The object is not of type {@code clazz}.  * </ul>  *  * @param key a String, or {@code null}  * @param clazz The type of the object expected  * @return a Parcelable value, or {@code null}  */ @SuppressWarnings("unchecked") @Nullable public <T> T getParcelable(@Nullable String key, @NonNull Class<T> clazz) {     // Implementation here }

这个新方法要求调用者显式提供预期的类型信息，从而在编译时就能进行更严格的类型检查，避免了不必要的运行时错误。

Xamarin.Android 中 Parcelable 对象的传递与接收

在 Xamarin.Android 项目中，我们通常会定义一个 C# 类并使其实现 IParcelable 接口（或通过 [Parcelable] 属性自动生成相关代码），以便在 Bundle 中传递。

原始（已废弃）的代码示例：

假设我们有一个名为 User 的 C# 类，它实现了 IParcelable 接口，并且我们通过 Intent 和 Bundle 在活动之间传递 User 对象。

发送 User 对象：

// 假设 MyUser 是一个已填充数据的 User 实例 User MyUser = new User("...", "...", /* ...其他属性... */);  Intent intent = new Intent(this, typeof(Menu)); Bundle bundlee = new Bundle(); bundlee.PutParcelable("MyUser", MyUser); // 将 User 实例存入 Bundle intent.PutExtra("TheBundle", bundlee); StartActivity(intent);

请注意，PutParcelable 方法并未废弃，其使用方式保持不变。

接收 User 对象（旧的、已废弃的方式）：

// 在目标 Activity 中接收 Bundle Bundle bundlee = Intent.GetBundleExtra("TheBundle");  User MyUser = new User("", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", ""); // 初始化，但这行在实际使用中通常不是必需的，可以直接赋值 MyUser = bundlee.GetParcelable("MyUser") as User; // 废弃警告出现在这里

上述代码中的 bundlee.GetParcelable(“MyUser”) 会触发废弃警告，因为它使用的是不带 Class 参数的旧方法。

迁移至类型安全的 GetParcelable 方法

要解决 Bundle.GetParcelable 的废弃问题，我们需要使用新的 GetParcelable(String key, Class clazz) 方法。关键在于如何为 C# 类型提供对应的 Java Class 对象。在 Xamarin.Android 中，我们可以利用 Java.Lang.Class.FromType() 方法来完成这个转换。

Java.Lang.Class.FromType() 方法能够将一个 .NET System.Type 对象转换为对应的 Java java.lang.Class 对象，这正是 GetParcelable 新方法所需要的。

接收 User 对象（新的、推荐的方式）：

// 在目标 Activity 中接收 Bundle Bundle bundlee = Intent.GetBundleExtra("TheBundle");  if (bundlee != null) {     // 使用新的 GetParcelable 方法，通过 Java.Lang.Class.FromType 提供类型信息     // MyUser = bundlee.GetParcelable("MyUser", Java.Lang.Class.FromType(typeof(User))) as User;      // 或者，如果 MyUser 实例已经存在（如通过默认构造函数创建），也可以使用其类型     // User MyUser = new User(); // 假设 User 有一个无参构造函数     // MyUser = bundlee.GetParcelable("MyUser", Java.Lang.Class.FromType(MyUser.GetType())) as User;      // 更简洁和推荐的做法是直接获取并赋值     User MyUser = bundlee.GetParcelable("MyUser", Java.Lang.Class.FromType(typeof(User))) as User;      if (MyUser != null)     {         // 成功获取到 MyUser 对象，进行后续操作         Console.WriteLine($"User Name: {MyUser.Name}"); // 假设 User 类有 Name 属性     }     else     {         Console.WriteLine("Failed to retrieve MyUser object or it was null.");     } } else {     Console.WriteLine("Bundle is null."); }

在上述代码中，Java.Lang.Class.FromType(typeof(User)) 将 C# 的 User 类型转换为 Java 运行时所需的 Class 对象。这样，GetParcelable 方法就能确保返回的对象是 User 类型或其子类型，从而满足类型安全的要求。

注意事项与总结

1. 类型匹配： 确保 Java.Lang.Class.FromType() 中传入的类型与实际存储在 Bundle 中的 Parcelable 对象类型一致。
2. 空值检查： 无论使用新旧方法，从 Bundle 中取出的对象都可能为 null（例如，如果键不存在或存储的值就是 null），因此进行空值检查是良好的编程习惯。
3. as 运算符： 即使使用了类型安全的 GetParcelable 方法，返回的仍然是泛型 T，在 C# 中为了将其赋值给具体的 User 类型变量，使用 as User 进行类型转换依然是必要的，这有助于在转换失败时返回 null 而不是抛出异常。
4. ClassLoader： Android 官方文档提到，如果期望的值不是 Android 平台提供的类，可能需要先调用 Bundle.SetClassLoader(ClassLoader)。但在 Xamarin.Android 中，对于自定义的 Parcelable 类，Java.Lang.Class.FromType 通常会正确处理类加载器的问题，因此在大多数情况下无需手动设置。但如果遇到类找不到的异常，可以考虑检查或设置 ClassLoader。
5. 前瞻性： 尽早采纳新的 API 标准，可以避免未来 Android 版本更新可能带来的兼容性问题，并使代码更加健壮和易于维护。

通过上述迁移步骤，您的 Xamarin.Android 应用将能够兼容 Android API 33 及更高版本，并消除 Bundle.GetParcelable 相关的废弃警告，提升代码的质量和前瞻性。