17370845950

本文旨在解决在 Android API 33 (Tiramisu) 及更高版本中，Bundle.GetParcelable(string) 方法被标记为过时的问题。我们将深入探讨其背后的原因，并提供详细的 C# (Xamarin) 解决方案，指导开发者如何安全、高效地使用类型安全的 Bundle.GetParcelable(string, Class) 方法进行跨 Activity 的 Parcelable 数据传递，确保应用在未来 Android 版本中的兼容性和稳定性。

问题背景与原因

随着 Android 平台的发展，API 不断演进以提升安全性、性能和开发者体验。在 Android API 33 (Tiramisu) 版本中，Bundle 类中用于获取 Parcelable 对象的 GetParcelable(string key) 方法被标记为过时（@Deprecated）。此变更的核心目的是为了引入类型安全机制。

旧的 GetParcelable(string key) 方法在运行时返回一个泛型 Parcelable 对象，需要开发者手动进行类型转换（例如 as User），这在编译时无法保证类型正确性，存在潜在的 ClassCastException 风险。为了规避这种风险并提供更健壮的 API，Android 引入了新的类型安全方法：GetParcelable(string key, Class clazz)。这个新方法要求在调用时明确指定期望的类型 clazz，从而在编译时提供更好的类型检查，减少运行时错误。

在 Xamarin 开发环境中，当目标 Android API 版本设置为 33 或更高时，使用旧的 GetParcelable(string) 方法会导致编译警告或错误，提示该方法已过时。

旧的代码示例

以下是使用旧的过时方法进行 Parcelable 数据传递的典型代码模式：

发送数据：

// 假设 User 是一个实现了 IParcelable 接口的自定义类
User MyUser = new User("John Doe", "john@example.com", /* ... 其他属性 ... */);

Intent intent = new Intent(this, typeof(Menu));
Bundle bundlee = new Bundle();
// 将 User 对象放入 Bundle
bundlee.PutParcelable("MyUser", MyUser); 
intent.PutExtra("TheBundle", bundlee);
StartActivity(intent);

接收数据（过时写法）：

// 在目标 Activity 中获取 Bundle
Bundle bundlee = Intent.GetBundleExtra("TheBundle");

User MyUser = new User("", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "");
// 此行代码会触发过时警告/错误
MyUser = bundlee.GetParcelable("MyUser") as User; 

解决方案：使用类型安全的 GetParcelable(string, Class)

新的 GetParcelable(string key, Class clazz) 方法要求传入一个 Java.Lang.Class 对象来指定期望的类型。在 C# (Xamarin) 中，我们可以通过 Java.Lang.Class.FromType() 方法将 .NET 的 System.Type 转换为 Java.Lang.Class。

接收数据（新写法）：

// 在目标 Activity 中获取 Bundle
Bundle bundlee = Intent.GetBundleExtra("TheBundle");

// 确保 bundlee 不为 null
if (bundlee != null)
{
    // 使用新的类型安全方法获取 Parcelable 对象
    // 方法一：通过 typeof(User) 获取类型信息
    User MyUser = bundlee.GetParcelable("MyUser", Java.Lang.Class.FromType(typeof(User))) as User;

    // 或者，如果 MyUser 实例已经存在，也可以通过 MyUser.GetType() 获取类型信息
    // User MyUser = new User("", "", "", /* ... */); // 如果需要默认初始化
    // MyUser = bundlee.GetParcelable("MyUser", Java.Lang.Class.FromType(MyUser.GetType())) as User;

    if (MyUser != null)
    {
        // 成功获取到 User 对象，可以继续操作
        Console.WriteLine($"Received User: {MyUser.Name}, {MyUser.Email}");
    }
    else
    {
        Console.WriteLine("Failed to retrieve MyUser from Bundle or MyUser is null.");
    }
}
else
{
    Console.WriteLine("Bundle is null.");
}

完整的数据传递流程（新旧方法结合）：

// 假设 User 是一个实现了 IParcelable 接口的自定义类
public class User : Java.Lang.Object, IParcelable
{
    public string Name { get; set; }
    public string Email { get; set; }
    // ... 其他属性

    public User(string name, string email, /* ... */)
    {
        Name = name;
        Email = email;
        // ...
    }

    // 实现 IParcelable 接口所需的方法
    public int DescribeContents() => 0;

    public void WriteToParcel(Parcel dest, ParcelFlags flags)
    {
        dest.WriteString(Name);
        dest.WriteString(Email);
        // ... 写入其他属性
    }

    public static readonly GenericParcelableCreator Creator = new GenericParcelableCreator((parcel) => new User(parcel));

    protected User(Parcel parcel)
    {
        Name = parcel.ReadString();
        Email = parcel.ReadString();
        // ... 读取其他属性
    }
}

// 辅助类，用于实现 Parcelable.Creator
public class GenericParcelableCreator : Java.Lang.Object, IParcelableCreator where T : Java.Lang.Object, IParcelable
{
    private readonly Func _createFromParcel;

    public GenericParcelableCreator(Func createFromParcel)
    {
        _createFromParcel = createFromParcel;
    }

    public Java.Lang.Object CreateFromParcel(Parcel source)
    {
        return _createFromParcel(source);
    }

    public Java.Lang.Object[] NewArray(int size)
    {
        return new T[size];
    }
}

// Activity A (发送数据)
public class ActivityA : Activity
{
    protected override void OnCreate(Bundle savedInstanceState)
    {
        base.OnCreate(savedInstanceState);
        SetContentView(Resource.Layout.ActivityA); // 假设有布局

        Button sendButton = FindViewById(Resource.Id.sendButton); // 假设有按钮
        sendButton.Click += (sender, e) =>
        {
            User myUserToSend = new User("Alice Smith", "alice@example.com");

            Intent intent = new Intent(this, typeof(ActivityB));
            Bundle bundle = new Bundle();
            bundle.PutParcelable("MyUser", myUserToSend); // PutParcelable 仍然可用
            intent.PutExtra("TheBundle", bundle);
            StartActivity(intent);
        };
    }
}

// Activity B (接收数据)
public class ActivityB : Activity
{
    protected override void OnCreate(Bundle savedInstanceState)
    {
        base.OnCreate(savedInstanceState);
        SetContentView(Resource.Layout.ActivityB); // 假设有布局

        TextView receivedUserTextView = FindViewById(Resource.Id.receivedUserTextView); // 假设有文本视图

        Bundle bundle = Intent.GetBundleExtra("TheBundle");

        if (bundle != null)
        {
            // 关键：使用类型安全的 GetParcelable 方法
            User receivedUser = bundle.GetParcelable("MyUser", Java.Lang.Class.FromType(typeof(User))) as User;

            if (receivedUser != null)
            {
                receivedUserTextView.Text = $"Received User: Name={receivedUser.Name}, Email={receivedUser.Email}";
            }
            else
            {
                receivedUserTextView.Text = "Failed to receive user data.";
            }
        }
        else
        {
            receivedUserTextView.Text = "No bundle received.";
        }
    }
}

注意事项

1. IParcelable 实现： 确保您的自定义类正确实现了 IParcelable 接口。这包括 DescribeContents()、WriteToParcel() 方法以及一个静态的 IParcelableCreator 字段。在 Xamarin 中，通常会创建一个 GenericParcelableCreator 辅助类来简化 Creator 的实现。
2. Java.Lang.Class.FromType()： 这是将 C# 的 System.Type 转换为 Android Runtime 所需的 Java.Lang.Class 的关键。
3. 类加载器： 对于非 Android 平台提供的类（即您自定义的类），在某些情况下，可能需要在使用 GetParcelable 之前设置 Bundle 的类加载器。虽然在大多数直接通过 Intent 传递 Bundle 的情况下，系统会自动处理，但如果 Bundle 是从其他来源（如文件、网络）反序列化而来，或者您的自定义类位于非常规的程序集或命名空间中，则可能需要调用 bundle.SetClassLoader(this.ClassLoader) 来确保 Bundle 能够找到并加载您的自定义类。
4. 空值检查： 始终对从 Bundle 中获取的对象进行空值检查，因为键不存在或值为空都可能导致返回 null。
5. 兼容性： 新的 GetParcelable(string, Class) 方法从 Android API 33 开始可用。如果您的应用需要支持更早的 Android 版本，您可能需要考虑条件编译或提供兼容性实现（例如，使用旧方法并抑制过时警告，或者使用 BundleCompat 等兼容库）。然而，考虑到 Android 版本的普及率和未来的发展趋势，直接升级到新 API 是更推荐的做法。

总结

Bundle.GetParcelable(string) 方法的过时是 Android 平台向更类型安全、更健壮的 API 设计迈进的一部分。通过采纳 GetParcelable(string, Class) 方法，并结合 Xamarin 中 Java.Lang.Class.FromType() 的使用，开发者可以消除潜在的运行时类型转换错误，提升代码质量和应用稳定性。及时更新和适配这些新的 API 是确保应用在最新 Android 版本上平稳运行的关键。