Flutter含watchOS目标：Xcode可构建VSCode执行flutter run失败

Xcode能正常构建是因为它会处理整个项目的所有target及其依赖，而flutter run默认的构建流程中，没有正确将watchOS目标的Pod依赖纳入编译路径。你的Podfile中watchOS target是独立定义的，Flutter的podhelper工具默认只处理Runner相关target，导致watchOS的Pods模块无法被找到。

步骤1：调整Podfile结构，确保watchOS Target的依赖被正确处理 #

修改你的Podfile，将watchOS target的定义放在flutter_ios_podfile_setup之后，并且在post_install阶段为watchOS target应用Flutter的构建设置：

# Uncomment this line to define a global platform for your project
platform :ios, '12.0'

# CocoaPods analytics sends network stats synchronously affecting flutter build latency.
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

target 'Runner' do
  use_frameworks!
  use_modular_headers!
  
  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
  target 'RunnerTests' do
    inherit! :search_paths
  end
end

# 将watchOS target移到此处，确保flutter_podhelper初始化后处理
target 'Watch App' do
  platform :watchos, '3.0'
  use_frameworks!
  use_modular_headers!
  
  pod 'Alamofire', '~> 5.9.0'
  pod 'CryptoSwift', '~> 1.4.0'
  pod 'SwiftLint'
end

post_install do |installer|
  installer.pods_project.targets.each do |target|
    # 为所有target（包括watchOS）应用Flutter构建设置
    flutter_additional_ios_build_settings(target)
    
    # 确保watchOS相关target的部署版本配置正确
    if target.name.start_with?('Watch App') || target.name.start_with?('Alamofire') || target.name.start_with?('CryptoSwift')
      target.build_configurations.each do |config|
        config.build_settings['WATCHOS_DEPLOYMENT_TARGET'] = '3.0'
      end
    end
    
    # Start of the permission_handler configuration
    target.build_configurations.each do |config|
      
    end
    
  end
end

步骤2：清理并重新安装依赖 #

1. 执行以下命令清理现有构建文件：

flutter clean
cd ios
pod deintegrate
rm Podfile.lock
rm -rf .symlinks
rm -rf Flutter/Flutter.framework
rm -rf Flutter/Flutter.podspec

2. 重新初始化依赖：

flutter pub get
cd ios
pod install --repo-update

步骤3：验证VSCode构建 #

回到VSCode，执行flutter run，此时watchOS的Pod依赖应该能被正确识别。

• 调整Podfile中watchOS target的位置，是为了确保Flutter的podhelper完成初始化后再处理watchOS的依赖配置。
• 在post_install中遍历所有target并应用flutter_additional_ios_build_settings，能保证watchOS相关的Pods也获得正确的构建参数，避免模块找不到的问题。
• 清理步骤是为了彻底移除旧的依赖缓存，确保新的Pod配置生效。

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