Flutter Image Picker包在iOS Framework模式下无法正常工作

问题重现 #

Flutter模块使用image_picker包，在Android作为独立App/AAR模块、iOS作为独立App时均正常，但通过flutter build ios-framework生成Framework集成到iOS宿主App时，调用图片选择方法抛出以下异常：

[VERBOSE-2:dart_vm_initializer.cc(41)] Unhandled Exception: PlatformException(channel-error, Unable to establish connection on channel., null, null)
#0      ImagePickerApi.pickImage (package:image_picker_ios/src/messages.g.dart:126)
<asynchronous suspension>
#1      ImagePickerIOS.getImage (package:image_picker_ios/image_picker_ios.dart:168)
<asynchronous suspension>
#2      MindMapNativeHelper.pickImage (package:mind_map_module/platformHelpers/mindMapNativeHelper.dart:276)
<asynchronous suspension>

已完成相机、相册、麦克风的权限配置。

解决步骤 #

1. 手动注册image_picker iOS插件 #

在iOS宿主App的初始化代码（如AppDelegate.swift）中，完成Flutter引擎初始化后，手动注册image_picker插件：

import Flutter
import image_picker_ios

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // 初始化Flutter引擎
    let flutterEngine = FlutterEngine(name: "your_engine_name")
    flutterEngine.run()
    // 执行自动注册
    GeneratedPluginRegistrant.register(with: flutterEngine)
    // 手动注册image_picker插件
    ImagePickerPlugin.register(with: flutterEngine.registrar(forPlugin: "ImagePickerPlugin"))
    
    return true
}

2. 确认权限配置与版本兼容性 #

• 再次检查宿主App的Info.plist，确保权限描述完整：

  <key>NSPhotoLibraryUsageDescription</key>
  <string>需要访问相册选择图片</string>
  <key>NSCameraUsageDescription</key>
  <string>需要访问相机拍摄图片</string>
  <key>NSMicrophoneUsageDescription</key>
  <string>需要访问麦克风录制视频</string>
  

• 确保image_picker版本与当前Flutter版本兼容，建议使用对应Flutter版本的稳定版插件（如image_picker: ^0.8.11+4，可根据自身Flutter版本调整）

3. 确保Flutter引擎就绪后调用插件 #

避免在Flutter引擎未完成初始化时执行图片选择逻辑，可通过监听FlutterEngine的didRun回调，或在宿主App确认引擎完全就绪后，再触发Dart侧的图片选择方法。

原因分析 #

将Flutter模块打包成Framework时，自动插件注册机制（GeneratedPluginRegistrant）可能无法正确识别并注册image_picker的原生通信通道，导致Dart层与iOS原生代码无法建立连接，从而抛出channel-error异常。手动注册插件可强制建立通道，修复该问题。

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