从Xamarin.Android迁移至.NET MAUI Android的生命周期及库兼容问题

一、报错针对性解决 #

1. CS0115：方法无法重写问题 #

这类报错源于.NET MAUI Android（基于AndroidX）的Activity方法签名、推荐用法与旧Xamarin.Android存在差异：

• OnSaveInstanceState：确保Activity继承AndroidX.AppCompat.App.AppCompatActivity，重写时匹配基类签名，示例：

  protected override void OnSaveInstanceState(Bundle outState)
  {
      base.OnSaveInstanceState(outState);
      // 你的业务逻辑
  }
  

• OnActivityResult：旧的重写方式已被废弃，改用RegisterForActivityResult机制处理页面返回结果，这是AndroidX的标准替代方案，取代原有的StartActivityForResult+OnActivityResult组合。
• OnOptionsItemSelected：确认引用AndroidX.Menu命名空间，方法签名改为public override bool OnOptionsItemSelected(IMenuItem item)，并调用基类实现。

2. CS0103：FindViewById、StartActivity不存在问题 #

.NET MAUI Android中，原生API调用需绑定当前Activity上下文：

• FindViewById：通过Activity实例调用，示例：

  txtUsername = this.FindViewById<EditText>(Resources.GetIdentifier("txtUsername", "id", PackageName));
  

  更推荐直接引用资源ID：this.FindViewById<EditText>(Resource.Id.txtUsername)（需确保资源文件已正确迁移）。
• StartActivity：优先通过当前Activity实例调用，若使用全局Context需添加启动标记：

  // 当前Activity上下文调用
  this.StartActivity(homeIntent);
  // 全局Context调用需添加标记
  homeIntent.AddFlags(ActivityFlags.NewTask);
  Android.App.Application.Context.StartActivity(homeIntent);
  

3. CS0120：Intent.HasExtra需要对象引用问题 #

HasExtra是Intent实例方法，必须通过当前Activity的Intent对象调用，示例：

clearpwd = this.Intent.HasExtra("clearpwd");

二、.NET MAUI Android专属资料获取 #

• 微软官方.NET MAUI文档的Android平台特定板块，聚焦MAUI中Android原生开发的适配细节，包括生命周期、原生组件调用等内容。
• .NET MAUI API差异文档，对比Xamarin.Android与.NET MAUI Android的API变更，重点关注Activity、Context相关的方法调整。
• 微软官方提供的.NET MAUI Android示例项目，可参考纯Android原生代码在MAUI项目中的实现范式。
• AndroidX官方文档，由于.NET MAUI Android完全基于AndroidX，原生AndroidX的开发规范、API用法可直接复用，纯MAUI Android项目的底层逻辑与原生AndroidX项目一致。

内容的提问来源于stack exchange，提问作者angleUr