Flutter模块(.aar)集成原生Android遇MissingPluginException问题求助

核心原因 #

单独运行Flutter项目时，MainActivity会自动完成Flutter引擎初始化与MethodChannel注册，但将模块打包为AAR集成到原生宿主应用时，宿主侧的Activity往往没有正确触发引擎初始化逻辑，或是MethodChannel注册时机不对，导致Dart端无法找到对应的原生实现。

具体解决方案 #

1. 把MethodChannel注册逻辑绑定到FlutterEngine初始化流程 #

不要仅在MainActivity的onCreate中注册通道，需将注册逻辑抽离为独立方法，确保每次FlutterEngine创建时都能执行注册：

创建一个工具类统一管理通道注册：

import io.flutter.embedding.engine.FlutterEngine;
import io.flutter.plugin.common.MethodChannel;

public class FlutterChannelRegistrar {
    private static final String CHANNEL_ID = "heartbeat.fritz.ai/native";

    public static void registerCameraChannel(FlutterEngine flutterEngine) {
        new MethodChannel(flutterEngine.getDartExecutor().getBinaryMessenger(), CHANNEL_ID)
                .setMethodCallHandler((call, result) -> {
                    if ("takePhoto".equals(call.method)) {
                        // 这里实现原生拍照逻辑并返回结果
                        result.success("/storage/emulated/0/DCIM/photo.jpg");
                    } else {
                        result.notImplemented();
                    }
                });
    }
}

在宿主应用初始化FlutterEngine时调用该方法：

// 宿主侧初始化Flutter引擎
FlutterEngine flutterEngine = new FlutterEngine(context);
FlutterChannelRegistrar.registerCameraChannel(flutterEngine);
// 执行Dart入口
flutterEngine.getDartExecutor().executeDartEntrypoint(
        DartExecutor.DartEntrypoint.createDefault()
);
// 缓存引擎供后续页面使用
FlutterEngineCache.getInstance().put("camera_engine", flutterEngine);

2. 确保宿主应用依赖配置正确 #

检查宿主应用的build.gradle，确保引入的Flutter依赖版本与你的Flutter模块版本一致：

dependencies {
    // 引入打包好的Flutter AAR
    implementation files('libs/flutter_camera_module-release.aar')
    // 引入匹配版本的Flutter嵌入依赖
    implementation 'io.flutter:flutter_embedding_release:3.10.6' // 替换为你的Flutter对应版本
}

3. 启动Flutter页面时使用预初始化的缓存引擎 #

如果宿主通过FlutterActivity打开Flutter页面，需指定使用预初始化的缓存引擎，避免自动创建未注册通道的新引擎：

Intent flutterIntent = FlutterActivity.withCachedEngine("camera_engine").build(context);
startActivity(flutterIntent);

4. 严格校验Channel名称一致性 #

确认Flutter端与原生端的Channel名称完全匹配，包括大小写、特殊字符：
Flutter端代码：

static const MethodChannel _channel = MethodChannel('heartbeat.fritz.ai/native');

原生端的CHANNEL_ID必须与上述字符串完全一致，不能有拼写错误。

5. 清理缓存后重新构建 #

• 清理Flutter模块缓存：执行flutter clean，重新打包AAR：flutter build aar
• 清理宿主Android项目缓存：点击Android Studio的Build -> Clean Project，再重新构建项目。

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