iOS构建失败：SDWebImage出现ARC语义问题求助

问题描述 #

Flutter项目在Android运行正常，iOS构建失败，SDWebImage出现ARC语义问题，报错：

/ios/Pods/SDWebImage/SDWebImage/Core/SDImageCoderHelper.m:31:40: No visible @interface for 'UIImage' declares the selector 'imageByPreparingForDisplay'
/ios/Pods/SDWebImage/SDWebImage/Core/SDImageCoderHelper.m:48:40: No visible @interface for 'UIImage' declares the selector 'imageByPreparingThumbnailOfSize:'

已尝试常规清理操作（删除DerivedData、Pods、.lock文件，重新执行flutter clean/pub get、pod install等），调整iOS部署目标为13.0-14.5，更换Xcode12/13，修改Pod目标访问权限均无效。使用Flutter 3.0.4，Podfile内容如下：

platform :ios, '14.4'
use_modular_headers!

ENV['COCOAPODS_DISABLE_STATS'] = 'true'

project 'Runner', {
  'Debug' => :debug,
  'Profile' => :release,
  'Release' => :release,
}

def flutter_root
  generated_xcode_build_settings_path = File.expand_path(File.join('..', 'Flutter', 'Generated.xcconfig'), __FILE__)
  unless File.exist?(generated_xcode_build_settings_path)
    raise "#{generated_xcode_build_settings_path} must exist. If you're running pod install manually, make sure flutter pub get is executed first"
  end

  File.foreach(generated_xcode_build_settings_path) do |line|
    matches = line.match(/FLUTTER_ROOT\=(.*)/)
    return matches[1].strip if matches
  end
  raise "FLUTTER_ROOT not found in #{generated_xcode_build_settings_path}. Try deleting Generated.xcconfig, then run flutter pub get"
end

require File.expand_path(File.join('packages', 'flutter_tools', 'bin', 'podhelper'), flutter_root)

flutter_ios_podfile_setup

pod 'GeoFire', :git => 'https://github.com/heinzan/geofire-objc'

pod 'Firebase', :modular_headers => true
pod 'FirebaseCore', :modular_headers => true
pod 'GoogleUtilities', :modular_headers => true
$RNFirebaseAsStaticFramework = true


target 'Runner' do
  use_frameworks!
  #use_modular_headers!

  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
end

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
          config.build_settings['ARCHS[sdk=iphonesimulator*]'] =  `uname -m`
          
          config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '14.4'

    end
    flutter_additional_ios_build_settings(target)
  end
 end


target 'OneSignalNotificationServiceExtension' do
  # Comment the next line if you don't want to use dynamic frameworks
  use_frameworks!
  pod 'OneSignalXCFramework', '>= 3.0.0', '< 4.0'
end

问题原因 #

1. SDWebImage版本不兼容：报错的两个UIImage方法是iOS 13.0+新增API，若引入的SDWebImage版本过高（如6.x+），可能对iOS版本要求或头文件处理有变化，导致编译时无法识别API。
2. 模块化头文件设置冲突：Podfile全局开启use_modular_headers!但Runner目标注释了该设置，导致SDWebImage的头文件未正确暴露给项目。
3. Xcode项目部署目标未同步：虽然post_install中强制设置了部署目标，但部分Pods目标的设置可能未生效。

解决方案 #

方案1：锁定SDWebImage兼容版本 #

在Podfile的target 'Runner'块中添加SDWebImage版本锁定，指定兼容iOS13+的稳定版本：

target 'Runner' do
  use_frameworks!
  use_modular_headers! # 取消注释这一行

  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
  # 添加以下行锁定版本
  pod 'SDWebImage', '~> 5.12.5'
end

方案2：统一模块化头文件设置 #

取消Runner目标中use_modular_headers!的注释，确保全局和目标级的模块化头设置一致，避免头文件暴露问题。

方案3：验证并强制同步部署目标 #

1. 打开Xcode，进入Runner项目的Build Settings，确认iOS Deployment Target设置为14.4。
2. 在post_install脚本中，针对SDWebImage单独强制设置部署目标：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
          config.build_settings['ARCHS[sdk=iphonesimulator*]'] =  `uname -m`
          config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '14.4'
    end
    # 单独处理SDWebImage
    if target.name == 'SDWebImage'
      target.build_configurations.each do |config|
        config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '14.4'
      end
    end
    flutter_additional_ios_build_settings(target)
  end
 end

方案4：重新执行完整清理安装流程 #

按以下顺序执行命令，确保彻底清理旧依赖：

flutter clean
rm -rf ios/Pods ios/Podfile.lock ios/Runner.xcworkspace
flutter pub get
cd ios
pod deintegrate
pod repo update
pod install --repo-update
cd ..
open ios/Runner.xcworkspace

验证 #

执行上述操作后，在Xcode中选择对应模拟器或真机，执行Command+B重新构建，确认报错消失。

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