Flutter项目用外部IDE构建iOS模拟器包报错找不到RelevantSDK模块

API 探路者

2026-10-5

问题根因

报错核心是引入的RelevantSDK.xcframework缺失当前模拟器构建所需的架构切片：

你的XCFramework仅包含真机arm64、Intel模拟器x86_64两种切片，没有Apple Silicon设备所需的arm64模拟器切片
IntelliJ/Android Studio构建模拟器时默认会同时编译arm64+x86_64两种模拟器架构，匹配不到对应切片就会触发依赖找不到的报错
Xcode默认开启ONLY_ACTIVE_ARCH配置，只会编译当前运行设备匹配的单架构，所以不会触发报错

修复方案

临时快速适配方案（无需更新SDK）

在Flutter项目的ios/Podfile文件中，找到post_install代码块，添加模拟器架构排除配置：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    # 新增以下配置：Debug模式下模拟器构建排除arm64架构
    target.build_configurations.each do |config|
      if config.name == 'Debug'
        config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64'
      end
    end
  end
end

该配置会让模拟器构建仅生成x86_64架构包，Apple Silicon设备可通过Rosetta转译正常运行调试，不影响真机构建的架构支持。

插件podspec配置校验

检查你的自定义插件的.podspec文件，确保XCFramework依赖和架构配置正确：

# 确认正确引入了 vendored xcframework
s.vendored_frameworks = '路径/到/你的/RelevantSDK.xcframework'

# 确认架构配置正确
s.pod_target_xcconfig = {
  'ONLY_ACTIVE_ARCH' => 'NO',
  'VALID_ARCHS' => 'arm64 x86_64 arm64e',
  'EXCLUDED_ARCHS[sdk=iphonesimulator*]' => ''
}