Flutter iOS构建报错：__swift_FORCE_LOAD_$_swiftCompatibility56未定义

问题描述 #

构建Flutter iOS应用时出现以下错误：

ld: warning: Could not find or use auto-linked library 'swiftCompatibilityPacks'
ld: warning: Could not find or use auto-linked library 'swiftCompatibility56'
ld: warning: Could not find or use auto-linked library 'swiftObservation'
ld: warning: Could not find or use auto-linked framework 'Symbols'
Undefined symbols for architecture arm64:
  "__swift_FORCE_LOAD_$_swiftCompatibility56", referenced from:
      __swift_FORCE_LOAD_$_swiftCompatibility56_$_FirebaseAnalytics in FirebaseAnalytics(Analytics+StoreKit.o)
      __swift_FORCE_LOAD_$_swiftCompatibility56_$_FirebaseAnalytics in FirebaseAnalytics(Analytics+SwiftUI.o)
     (maybe you meant: __swift_FORCE_LOAD_$_swiftCompatibility56_$_FirebaseAnalytics)
ld: symbol(s) not found for architecture arm64

当前使用Xcode 14.2且无法更新，已尝试调整iOS构建版本、查找相关库但无效。

可行解决方案 #

1. 启用Swift支持并配置对应版本 #

如果项目原本无Swift代码，Xcode不会自动链接Swift标准库，需手动配置：

• 打开iOS目录下的Runner.xcworkspace，在Runner目录新建空Swift文件（如Dummy.swift）
• Xcode提示创建Objective-C桥接文件时，选择"Create Bridging Header"
• 选中Runner target进入Build Settings，搜索Always Embed Swift Standard Libraries，设置为YES
• 在Podfile的post_install块中添加Swift版本配置：

  post_install do |installer|
    installer.pods_project.targets.each do |target|
      flutter_additional_ios_build_settings(target)
      target.build_configurations.each do |config|
        config.build_settings['SWIFT_VERSION'] = '5.7' # 匹配Xcode14.2的Swift版本
      end
    end
  end
  

2. 调整Podfile部署目标并重装依赖 #

• 打开ios/Podfile，确保平台版本满足Firebase最低要求：

  platform :ios, '13.0'
  use_frameworks! # Firebase依赖Swift框架，必须开启
  

• 执行以下命令清理并重装依赖：

  pod deintegrate
  rm Podfile.lock
  pod install
  flutter clean
  flutter build ios
  

3. 锁定Firebase兼容版本 #

高版本Firebase可能依赖更高版本的Swift兼容库，Xcode14.2不支持，可锁定到适配版本：

• 在pubspec.yaml中指定兼容的Firebase依赖版本：

  firebase_core: ^2.15.0
  firebase_analytics: ^10.4.0
  

• 执行flutter pub get后，重新执行上述Pod清理安装步骤

4. 添加链接器标记跳过弱引用检查 #

• 选中Runner target进入Build Settings，搜索Other Linker Flags
• 添加参数：-Xlinker -no_weak_imports

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