Xamarin Android API 33+ 中 Bundle.GetParcelable 废弃问题的解决方案与类型安全迁移指南-java教程-PHP中文网

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

花韻仙語

发布： 2025-07-02 19:42:17

原创

585人浏览过

xamarin android api 33+ 中 bundle.getparcelable 废弃问题的解决方案与类型安全迁移指南

Android API 33 (Tiramisu) 起，Bundle.GetParcelable(string) 方法已被废弃，推荐使用类型安全的 GetParcelable(string, Class<T>)。本文旨在为 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<T> 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<T> 参数，明确指定期望返回的 Parcelable 对象的类型。

新的 GetParcelable(String key, Class<T> 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 对象：

AI建筑知识问答

用人工智能ChatGPT帮你解答所有建筑问题

查看详情

// 假设 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<T> 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 类型或其子类型，从而满足类型安全的要求。

注意事项与总结

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

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

以上就是Xamarin Android API 33+ 中 Bundle.GetParcelable 废弃问题的解决方案与类型安全迁移指南的详细内容，更多请关注php中文网其它相关文章！