Flutter Rust Bridge 中 Android 上下文初始化问题解析

在 Flutter Rust Bridge 项目中，开发者经常会遇到 Android 上下文初始化失败的问题。这个问题表现为通过 ndk_context::android_context() 获取的上下文对象为空，导致后续依赖 Android 上下文的功能无法正常工作。

问题现象

当开发者按照文档配置 Android 上下文后，调用 ndk_context::android_context() 方法时，返回的 AndroidContext 结构体中 context_jobject 字段为 0x0，即空指针。这表明 Android 上下文虽然部分初始化成功（java_vm 字段有值），但关键的上下文对象并未正确传递。

问题根源

经过深入分析，这个问题主要由以下几个因素导致：

1. JNI 生命周期管理不当：Android 系统可能会回收 JNI 传递的临时对象引用
2. 初始化时机问题：在 Flutter 引擎完全初始化前尝试获取上下文
3. 引用类型错误：未将局部引用转换为全局引用

解决方案

正确的实现需要以下几个关键步骤：

1. 使用全局引用

必须将传入的 JObject 上下文对象转换为全局引用，防止被垃圾回收：

let global_ref = env.new_global_ref(&ctx).expect("创建全局引用失败");

2. 持久化存储引用

使用 OnceLock 或其他机制保持全局引用的生命周期：

static CTX: OnceLock<GlobalRef> = OnceLock::new();
CTX.get_or_init(|| global_ref);

3. 正确的初始化顺序

在 Flutter 端，确保在调用 super.configureFlutterEngine() 之前添加插件：

override fun configureFlutterEngine(
    @NonNull flutterEngine: FlutterEngine
) {
    flutterEngine.plugins.add(MyPlugin())
    super.configureFlutterEngine(flutterEngine)
}

完整实现示例

以下是经过验证的正确实现方式：

#[cfg(target_os = "android")]
mod init_android_context {
    use jni::{objects::{JClass, JObject, GlobalRef}, JNIEnv};
    use std::sync::OnceLock;
    use std::ffi::c_void;

    static CTX: OnceLock<GlobalRef> = OnceLock::new();

    #[no_mangle]
    pub extern "system" fn Java_com_example_MyPlugin_init_android(
        env: JNIEnv,
        _class: JClass,
        ctx: JObject,
    ) {
        let global_ref = env.new_global_ref(&ctx).expect("创建全局引用失败");
        let vm = env.get_java_vm().unwrap();
        let vm = vm.get_java_vm_pointer() as *mut c_void;
        unsafe {
            ndk_context::initialize_android_context(vm, global_ref.as_obj().as_raw() as _);
        }
        CTX.get_or_init(|| global_ref);
    }
}

注意事项

1. 线程安全：确保初始化操作在正确的线程执行
2. 错误处理：添加适当的错误处理逻辑，避免崩溃
3. 内存管理：注意全局引用的释放时机，避免内存泄漏
4. 日志记录：添加调试日志帮助诊断问题

通过以上方法，开发者可以确保 Android 上下文在 Flutter Rust Bridge 项目中正确初始化，为后续的跨平台功能开发奠定基础。