Flutter项目CocoaPods未安装依赖框架致启动崩溃求助

问题描述 #

我有一个Swift项目和一个Flutter项目：

• 在Swift项目中导入某包含Pod依赖的框架时，所有依赖均能正确链接，运行正常。查看Pods/Target Support Files/Pods-**/Pods-**-framework文件，Debug和Release环境下都有完整的install_framework代码：

if [[ "$CONFIGURATION" == "Debug" ]]; then
  install_framework "${BUILT_PRODUCTS_DIR}/FirebaseCore/FirebaseCore.framework"
  install_framework "${BUILT_PRODUCTS_DIR}/FirebaseCoreInternal/FirebaseCoreInternal.framework"
  install_framework "${BUILT_PRODUCTS_DIR}/FirebaseInstallations/FirebaseInstallations.framework"
  install_framework "${BUILT_PRODUCTS_DIR}/GTMSessionFetcher/GTMSessionFetcher.framework"
  install_framework "${BUILT_PRODUCTS_DIR}/GoogleDataTransport/GoogleDataTransport.framework"
  install_framework "${BUILT_PRODUCTS_DIR}/GoogleToolboxForMac/GoogleToolboxForMac.framework"
  install_framework "${BUILT_PRODUCTS_DIR}/GoogleUtilities/GoogleUtilities.framework"
  install_framework "${BUILT_PRODUCTS_DIR}/PromisesObjC/FBLPromises.framework"
  install_framework "${BUILT_PRODUCTS_DIR}/Protobuf/Protobuf.framework"
  install_framework "${BUILT_PRODUCTS_DIR}/nanopb/nanopb.framework"
fi
if [[ "$CONFIGURATION" == "Release" ]]; then
  install_framework "${BUILT_PRODUCTS_DIR}/FirebaseCore/FirebaseCore.framework"
  install_framework "${BUILT_PRODUCTS_DIR}/FirebaseCoreInternal/FirebaseCoreInternal.framework"
  install_framework "${BUILT_PRODUCTS_DIR}/FirebaseInstallations/FirebaseInstallations.framework"
  install_framework "${BUILT_PRODUCTS_DIR}/GTMSessionFetcher/GTMSessionFetcher.framework"
  install_framework "${BUILT_PRODUCTS_DIR}/GoogleDataTransport/GoogleDataTransport.framework"
  install_framework "${BUILT_PRODUCTS_DIR}/GoogleToolboxForMac/GoogleToolboxForMac.framework"
  install_framework "${BUILT_PRODUCTS_DIR}/GoogleUtilities/GoogleUtilities.framework"
  install_framework "${BUILT_PRODUCTS_DIR}/PromisesObjC/FBLPromises.framework"
  install_framework "${BUILT_PRODUCTS_DIR}/Protobuf/Protobuf.framework"
  install_framework "${BUILT_PRODUCTS_DIR}/nanopb/nanopb.framework"
fi
if [ "${COCOAPODS_PARALLEL_CODE_SIGN}" == "true" ]; then
  wait
fi

• 但在Flutter项目的Runner.app中执行相同导入操作后，真机构建时，对应的Pods/Target Support Files/Pods-Runner/Pods-Runner-framework文件里没有任何install_framework代码：

if [[ "$CONFIGURATION" == "Debug" ]]; then
fi
if [[ "$CONFIGURATION" == "Profile" ]]; then
fi
if [[ "$CONFIGURATION" == "Release" ]]; then
fi
if [ "${COCOAPODS_PARALLEL_CODE_SIGN}" == "true" ]; then
  wait
fi

这导致应用启动时提示“SomeFramework not found”并崩溃。已尝试执行pod deintegrate后再pod install，但问题仍未解决。

解决方法 #

1. 修正Podfile配置 #

打开Flutter项目的ios/Podfile，确保框架被正确声明，且动态框架配置正确：

target 'Runner' do
  use_frameworks!
  use_modular_headers!

  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
  
  # 本地框架请指定正确路径，远程框架直接写名称+版本
  pod 'YourCertainFramework', :path => '../path/to/your/framework', :modular_headers => true
end

注意：如果框架依赖动态库，不要注释use_frameworks!。

2. 彻底清理缓存并重建 #

• 执行Flutter缓存清理：flutter clean
• 打开Xcode，执行Product > Clean Build Folder（快捷键Cmd+Shift+K）
• 删除ios/Pods文件夹、ios/Podfile.lock和ios/Runner.xcworkspace
• 重新执行pod install，打开Runner.xcworkspace重新构建

3. 检查Xcode Build Phases配置 #

进入Runner target的Build Phases：

• 在Link Binary With Libraries中确认框架及其所有依赖已添加
• 在Embed Frameworks中添加该框架，并勾选Code Sign On Copy选项

4. 验证框架的Podspec配置 #

如果是自定义框架，检查其.podspec文件：

• 确保s.dependency部分完整声明了所有依赖（如FirebaseCore等）
• 确认s.vendored_frameworks或s.source_files配置无遗漏

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