Flutter项目中WatchOS目标继承iOS设置导致Xcode归档及App Store验证失败的解决方案咨询

我明白你遇到的这个问题有多头疼——明明在Xcode里给watchOS目标配置了正确的属性，结果打包后还是被iOS Runner的设置覆盖，导致App Store验证卡壳。下面我会结合Flutter+Xcode的构建逻辑，给你几个不需要手动修改Info.plist的解决方案，从根源上解决设置继承问题：

1. 检查并修复Flutter Podfile的全局配置覆盖 #

很多时候，Flutter项目的Podfile中自定义的post_install脚本会不小心把iOS的构建设置应用到所有目标，包括watchOS。你需要确保脚本只针对iOS的Runner目标：

打开项目根目录的Podfile，找到post_install代码块，添加目标过滤逻辑：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    # 仅处理iOS平台的Runner目标，跳过所有watchOS相关目标
    next unless target.name == 'Runner' && target.platform_name == :ios
    
    # 保留你原有的iOS专属配置代码，比如：
    flutter_additional_ios_build_settings(target)
    # 其他自定义iOS设置...
  end
end

如果你的Podfile中有全局修改构建设置的代码（比如修改IPHONEOS_DEPLOYMENT_TARGET），一定要给这些代码加上平台判断，避免影响watchOS目标。

2. 在Xcode中强制覆盖watchOS目标的构建设置 #

打开Xcode，选中WatchTarget目标，切换到Build Settings标签（勾选All和Levels选项，显示所有设置），逐一检查并修复以下关键设置：

• PLATFORM_NAME：确保该值为watchos，如果显示为继承自项目的iOS设置，点击设置项选择Override，手动设置为watchos。
• UIDeviceFamily：watchOS目标的正确值是4，找到该设置后选择Override，输入4，覆盖iOS的1,2设置。
• WATCHOS_DEPLOYMENT_TARGET：确认该值为10.0，不要和iOS的IPHONEOS_DEPLOYMENT_TARGET混淆，确保没有被项目级设置覆盖。
• LSRequiresIPhoneOS：这是iOS专属键，watchOS目标不应包含。搜索INFOPLIST_KEY_LSRequiresIPhoneOS，如果该设置存在且是继承来的，点击选择Delete取消继承；如果需要主动移除，设置值为NO（不过watchOS目标本就不需要这个键，取消继承即可）。
• INFOPLIST_FILE：再次确认该路径指向WatchTarget自己的Info.plist（比如WatchTarget/Info.plist），且没有被项目级设置覆盖。

3. 清理Flutter与Xcode的构建缓存 #

缓存是导致旧设置残留的常见原因，彻底清理后再重新构建：

1. 在终端执行Flutter清理命令：

   flutter clean
   

2. 删除Xcode的Derived Data：
   打开Xcode → File → Project/Workspace Settings → 点击Derived Data路径旁的箭头，打开文件夹后删除所有内容。
3. 重新生成iOS项目文件（可选）：

   flutter pub get
   flutter build ios --config-only
   

4. 验证WatchTarget与Runner的依赖关系 #

确保watchOS目标的依赖链没有被错误配置：

• 选中Runner目标的Build Phases → Embed Watch Content，确认仅包含WatchTarget.app，没有多余的引用。
• 选中WatchTarget目标的Build Phases → Dependencies，确认仅依赖WatchTarget Extension，没有错误依赖iOS的Runner目标。
• 检查WatchTarget Extension的Build Settings，确保其PLATFORM_NAME为watchos，部署目标与WatchTarget一致（10.0）。

5. 升级Flutter到最新稳定版 #

部分旧版本的Flutter（比如3.10.x之前的版本）存在watchOS构建设置继承的已知bug，升级到最新稳定版可以自动修复这类问题：

flutter upgrade

验证修复效果 #

完成以上步骤后，重新在Xcode中归档项目，然后：

1. 右键归档文件 → Show in Finder
2. 找到WatchTarget.app → 右键Show Package Contents
3. 打开Info.plist，检查关键属性：
   • UIDeviceFamily = 4
   • MinimumOSVersion = 10.0
   • 不存在LSRequiresIPhoneOS键
   • DTPlatformName = watchos

如果这些属性都符合预期，再上传归档到App Store Connect，验证错误应该就会消失了。

内容来源于stack exchange