Flutter旧项目升级编译报错：MainActivity无法转换为FlutterEngine

报错MainActivity cannot be converted to FlutterEngine是因为Flutter版本升级后，插件注册的API发生了变更。旧版本里GeneratedPluginRegistrant.registerWith()接收Activity实例，新版本要求传入FlutterEngine对象，直接传this（MainActivity实例）就会出现类型不兼容的问题。

方案一：简化MainActivity（推荐） #

如果你的项目不需要自定义MainActivity逻辑，直接改成继承FlutterActivity即可，Flutter会自动处理插件注册：

1. 打开android/app/src/main/java/co/appbrewery/dicee/MainActivity.java
2. 替换成以下代码：

package co.appbrewery.dicee;

import io.flutter.embedding.android.FlutterActivity;

public class MainActivity extends FlutterActivity {
}

3. 保存后重新运行flutter run

方案二：保留自定义逻辑的适配 #

如果需要在MainActivity里添加自定义代码，就用新的API手动注册插件：

1. 修改MainActivity代码：

package co.appbrewery.dicee;

import io.flutter.embedding.android.FlutterActivity;
import io.flutter.embedding.engine.FlutterEngine;
import io.flutter.plugins.GeneratedPluginRegistrant;

public class MainActivity extends FlutterActivity {
  @Override
  public void configureFlutterEngine(FlutterEngine flutterEngine) {
    GeneratedPluginRegistrant.registerWith(flutterEngine);
    // 这里可以继续添加你的自定义逻辑
  }
}

可选：同步Gradle版本（避免后续问题） #

旧项目的Gradle版本可能和新版Flutter不兼容，建议同步升级：

• 打开android/build.gradle，把com.android.tools.build:gradle版本更新到和当前Flutter匹配的版本（比如Flutter 3.x对应Gradle 7.x及以上）
• 打开android/gradle/wrapper/gradle-wrapper.properties，更新distributionUrl到对应的Gradle版本

执行以下命令清理缓存并重新构建：

flutter clean
flutter pub get
flutter run

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