Flutter使用open_filex插件报错‘dartPluginClass does not exist’（仅针对iOS/Android平台）

嘿，我之前开发Flutter项目时也碰到过open_filex插件的类似报错，结合你给出的环境信息，先帮你梳理下问题背景：

你的项目环境 #

• Flutter: 3.29.2
• Dart SDK: 3.7.2
• 开发平台：macOS (Apple Silicon)
• 目标平台：仅iOS和Android

项目依赖配置 #

你的pubspec.yaml依赖如下：

dependencies:
  open_filex: ^4.4.0
  intl: ^0.19.0

报错场景 #

在iOS模拟器运行项目时，出现与Package open_filex:linux references相关的dartPluginClass does not exist错误。

接下来给你几个亲测有效的解决思路：

思路1：过滤非目标平台的插件引用 #

因为你只需要针对iOS和Android开发，而open_filex默认包含了Linux、Windows等其他平台的插件代码，Flutter在打包时可能会误加载这些无关代码导致冲突。你可以在pubspec.yaml里添加平台过滤配置，禁用不需要的平台插件：

dependencies:
  open_filex: ^4.4.0
  intl: ^0.19.0

flutter:
  plugins:
    - plugin:
        platforms:
          linux:
            enabled: false
          windows:
            enabled: false
          macos:
            enabled: false # 如果你不需要macOS平台支持的话

思路2：清理缓存并重新构建 #

有时候Flutter或CocoaPods的缓存会残留旧的插件信息，导致构建异常。执行以下命令彻底清理后重新构建：

flutter clean
flutter pub get
cd ios && pod install && cd .. # 针对iOS平台重新安装依赖
flutter run

思路3：降级open_filex到稳定版本 #

部分新版本插件可能存在平台兼容问题，你可以尝试降级到更稳定的版本（比如4.3.0），看看是否能解决报错：
修改pubspec.yaml中的依赖版本：

dependencies:
  open_filex: ^4.3.0
  intl: ^0.19.0

然后执行flutter pub get重新获取依赖，再尝试运行项目。

思路4：手动调整iOS端Podfile配置 #

如果以上方法都无效，可以手动修改iOS项目的Podfile，排除非iOS平台的插件目标：
在Podfile的post_install钩子中添加以下代码：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    # 移除非iOS平台的open_filex插件目标
    if target.name == 'open_filex_linux' || target.name == 'open_filex_windows' || target.name == 'open_filex_macos'
      target.remove_from_project
    end
  end
end

修改完成后，执行cd ios && pod install && cd ..更新依赖，再重新运行项目。

备注：内容来源于stack exchange，提问作者Philip Khoy