本文旨在解决Xamarin Android开发中，当API级别升级到33 (Tiramisu)及更高版本时，Bundle.GetParcelable(string)方法被弃用的问题。文章将深入探讨弃用原因，并提供使用类型安全的Bundle.GetParcelable(string, Class)新方法在C#中获取Parcelable对象的具体实现，通过代码示例和关键注意事项，帮助开发者平滑迁移并优化数据传递逻辑。
Bundle.GetParcelable弃用背景与原因
随着Android API的不断演进，为了提升代码的类型安全性和健壮性，Android 13 (API 33, Tiramisu) 开始对Bundle类中用于获取Parcelable对象的方法进行了更新。原有的Bundle.GetParcelable(string key)方法被标记为弃用（@deprecated），取而代之的是一个类型更安全的重载方法：Bundle.GetParcelable(string key, Class clazz)。
弃用旧方法的主要原因在于其缺乏类型推断，返回的是一个通用的Parcelable类型，需要开发者进行强制类型转换，这在运行时可能导致ClassCastException。新方法通过引入Class clazz参数，在编译时就能明确预期返回的类型，从而提高了代码的可靠性和可读性，减少了潜在的运行时错误。
旧版代码示例
在API 33之前，典型的Parcelable对象在Activity之间传递和接收的代码如下所示：
发送数据：
// 假设 User 是一个实现了 IParcelable 接口的自定义类User MyUser = new User("John", "Doe", /* ... 其他属性 ... */);Intent intent = new Intent(this, typeof(Menu));Bundle bundlee = new Bundle();bundlee.PutParcelable("MyUser", MyUser); // 将 User 对象放入 Bundleintent.PutExtra("TheBundle", bundlee);StartActivity(intent);
接收数据：
Bundle bundlee = Intent.GetBundleExtra("TheBundle");User MyUser = new User("", "", /* ... 默认值 ... */); // 初始化一个 User 对象// 旧的弃用方法：需要进行类型转换MyUser = bundlee.GetParcelable("MyUser") as User;
当项目目标框架升级到API 33或更高版本时，bundlee.GetParcelable(“MyUser”)这一行代码就会出现弃用警告。
新版GetParcelable方法解析
新的Bundle.GetParcelable方法签名如下（Java）：
@Nullablepublic T getParcelable(@Nullable String key, @NonNull Class clazz) { // ... implementation ...}
其中，clazz参数是关键，它要求传入一个java.lang.Class对象，明确指定期望获取的Parcelable对象的类型。这使得Android系统能够在内部进行更精确的类型检查。
对于Xamarin/C#开发者而言，挑战在于如何将C#中的System.Type对象转换为Java层所需的java.lang.Class对象。
Xamarin/C# 中的解决方案
在Xamarin Android中，Java.Lang.Class.FromType()方法提供了将C# System.Type转换为java.lang.Class的能力。这是解决Bundle.GetParcelable弃用问题的核心。
AI建筑知识问答
用人工智能ChatGPT帮你解答所有建筑问题
22 查看详情
因此，接收Parcelable对象的代码应修改为：
// 假设 bundlee 已经通过 Intent.GetBundleExtra("TheBundle") 获取Bundle bundlee = Intent.GetBundleExtra("TheBundle");// 确保 bundlee 不为 nullif (bundlee != null){ // 使用新的 GetParcelable 方法，传入 Java.Lang.Class.FromType(typeof(User)) // 这将 C# 的 User 类型转换为 Java 的 Class 对象 User MyUser = bundlee.GetParcelable("MyUser", Java.Lang.Class.FromType(typeof(User))) as User; // 检查 MyUser 是否成功获取并进行后续操作 if (MyUser != null) { // ... 使用 MyUser 对象 ... }}
或者，如果你已经有一个该类型的实例，也可以使用其运行时类型：
// 假设 MyUser 已经被初始化为一个 User 类型的实例User MyUser = new User("", "", /* ... 默认值 ... */);// 使用实例的运行时类型MyUser = bundlee.GetParcelable("MyUser", Java.Lang.Class.FromType(MyUser.GetType())) as User;
推荐使用typeof(User)形式，因为它在编译时就能确定类型，避免了潜在的运行时类型不匹配问题。
完整示例与注意事项
自定义 User 类（需实现 IParcelable 接口）：
using Android.OS;using Android.Runtime;using System;// 确保类标记为 [Parcelable] 并实现 IParcelable[Parcelable]public class User : Java.Lang.Object, IParcelable{ public string FirstName { get; set; } public string LastName { get; set; } // ... 其他属性 ... public User() { } // 无参构造函数，用于反序列化或默认初始化 // 构造函数，用于初始化属性 public User(string firstName, string lastName /* ... 其他参数 ... */) { FirstName = firstName; LastName = lastName; // ... 初始化其他属性 ... } // 实现 IParcelable.DescribeContents() public int DescribeContents() { return 0; } // 实现 IParcelable.WriteToParcel() - 将对象写入 Parcel public void WriteToParcel(Parcel dest, ParcelableWriteFlags flags) { dest.WriteString(FirstName); dest.WriteString(LastName); // ... 写入其他属性 ... } // 实现 IParcelable.Creator - 用于从 Parcel 创建对象 [ExportField("CREATOR")] public static UserCreator InitializeCreator() { return new UserCreator(); } public class UserCreator : Java.Lang.Object, IParcelableCreator { public Java.Lang.Object CreateFromParcel(Parcel source) { // 从 Parcel 中读取数据，顺序必须与 WriteToParcel 写入的顺序一致 string firstName = source.ReadString(); string lastName = source.ReadString(); // ... 读取其他属性 ... return new User(firstName, lastName /* ... 其他参数 ... */); } public Java.Lang.Object[] NewArray(int size) { return new User[size]; } }}
发送 Activity (例如 MainActivity.cs):
using Android.App;using Android.Content;using Android.OS;using Android.Widget;[Activity(Label = "MainActivity", MainLauncher = true)]public class MainActivity : Activity{ protected override void OnCreate(Bundle savedInstanceState) { base.OnCreate(savedInstanceState); SetContentView(Resource.Layout.activity_main); Button btnNavigate = FindViewById
接收 Activity (例如 MenuActivity.cs):
using Android.App;using Android.Content;using Android.OS;using Android.Widget;[Activity(Label = "MenuActivity")]public class MenuActivity : Activity{ protected override void OnCreate(Bundle savedInstanceState) { base.OnCreate(savedInstanceState); SetContentView(Resource.Layout.activity_menu); TextView tvUserInfo = FindViewById(Resource.Id.tvUserInfo); 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) { tvUserInfo.Text = $"User: {receivedUser.FirstName} {receivedUser.LastName}"; } else { tvUserInfo.Text = "Failed to retrieve user data."; } } else { tvUserInfo.Text = "No bundle received."; } }}
注意事项：
IParcelable 实现的正确性： 确保你的自定义类正确实现了IParcelable接口，包括DescribeContents、WriteToParcel以及静态的IParcelableCreator（通过[ExportField(“CREATOR”)]特性导出）。这是Parcelable机制正常工作的基石。setClassLoader()： Android文档中提到，如果Parcelable对象不是Android平台提供的类，可能需要先调用Bundle.SetClassLoader(ClassLoader)。然而，对于大多数自定义的Parcelable实现，Xamarin的运行时通常会自动处理类加载器的问题，因此在实践中，通常不需要显式调用此方法。但了解其存在有助于在遇到特殊类加载问题时进行排查。类型安全： 新的GetParcelable方法强制你在编译时指定类型，这有助于捕获潜在的类型不匹配错误，而不是等到运行时才暴露问题。兼容性： 如果你的应用需要同时支持API 33以下和API 33及以上版本，你可能需要根据Build.VERSION.SdkInt进行条件判断，使用不同的GetParcelable重载。然而，考虑到向前兼容性，直接升级到使用新方法是更推荐的做法，因为新方法在旧版本API上通常也能正常工作（尽管可能不会有弃用警告）。
总结
Bundle.GetParcelable(string)的弃用是Android API演进中提升类型安全性的一个体现。对于Xamarin开发者而言，通过利用Java.Lang.Class.FromType()方法，可以无缝地将C# System.Type映射到Java Class对象，从而适配新的Bundle.GetParcelable(string key, Class clazz)方法。及时更新代码以适应这些变化，不仅能消除弃用警告，更能提高应用的健壮性和可维护性，为未来的API升级打下良好基础。
以上就是Xamarin Android中Bundle.GetParcelable弃用问题的解决方案的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/256684.html
微信扫一扫 
支付宝扫一扫 
