在Bash环境下用Flutter构建IPA文件因integration_test包报错

问题描述 #

我在Bash环境下使用Flutter构建iOS IPA文件时，触发以下链接器错误：

building for 'iOS', but linking in dylib (/Library/Developer/CommandLineTools/SDKs/MacOSX14.0.sdk/usr/lib/libobjc.A.tbd) built for 'macOS macCatalyst zippered(macOS/Catalyst)'

启用--verbose后得到的调试日志如下：

Ld /Users/tcbdevbuild/Library/Developer/Xcode/DerivedData/Techswop-hcgdxzbupbdesybvyqnrorjdyarb/Build/Intermediates.noindex/ArchiveIntermediates/Runner/IntermediateBuildFilesPath/UninstalledProducts/iphoneos/integration_test.framework/integration_test normal (in target 'integration_test' from project 'Pods')
                cd /Users/tcbdevbuild/Documents/trade-in-mobile-app/ios/Pods
                /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang -Xlinker -reproducible -target arm64-apple-ios15.5 -dynamiclib -isysroot /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS17.0.sdk -Os -L/Users/tcbdevbuild/Library/Developer/Xcode/DerivedData/Techswop-hcgdxzbupbdesybvyqnrorjdyarb/Build/Intermediates.noindex/ArchiveIntermediates/Runner/IntermediateBuildFilesPath/EagerLinkingTBDs/Release-iphoneos -L/Users/tcbdevbuild/Library/Developer/Xcode/DerivedData/Techswop-hcgdxzbupbdesybvyqnrorjdyarb/Build/Intermediates.noindex/ArchiveIntermediates/Runner/BuildProductsPath/Release-iphoneos/integration_test -F/Users/tcbdevbuild/Library/Developer/Xcode/DerivedData/Techswop-hcgdxzbupbdesybvyqnrorjdyarb/Build/Intermediates.noindex/ArchiveIntermediates/Runner/IntermediateBuildFilesPath/EagerLinkingTBDs/Release-iphoneos -F/Users/tcbdevbuild/Library/Developer/Xcode/DerivedData/Techswop-hcgdxzbupbdesybvyqnrorjdyarb/Build/Intermediates.noindex/ArchiveIntermediates/Runner/BuildProductsPath/Release-iphoneos/integration_test -F/Users/tcbdevbuild/Documents/flutter/bin/cache/artifacts/engine/ios-release/Flutter.xcframework/ios-arm64 -filelist /Users/tcbdevbuild/Library/Developer/Xcode/DerivedData/Techswop-hcgdxzbupbdesybvyqnrorjdyarb/Build/Intermediates.noindex/ArchiveIntermediates/Runner/IntermediateBuildFilesPath/Pods.build/Release-iphoneos/integration_test.build/Objects-normal/arm64/integration_test.LinkFileList -install_name @rpath/integration_test.framework/integration_test -Xlinker -rpath -Xlinker @executable_path/Frameworks -Xlinker -rpath -Xlinker @loader_path/Frameworks -dead_strip -Xlinker -object_path_lto -Xlinker /Users/tcbdevbuild/Library/Developer/Xcode/DerivedData/Techswop-hcgdxzbupbdesybvyqnrorjdyarb/Build/Intermediates.noindex/ArchiveIntermediates/Runner/IntermediateBuildFilesPath/Pods.build/Release-iphoneos/integration_test.build/Objects-normal/arm64/integration_test_lto.o -fobjc-arc -fobjc-link-runtime -framework UIKit -framework Flutter -framework Foundation -framework UIKit -compatibility_version 1 -current_version 1 -Xlinker -dependency_info -Xlinker /Users/tcbdevbuild/Library/Developer/Xcode/DerivedData/Techswop-hcgdxzbupbdesybvyqnrorjdyarb/Build/Intermediates.noindex/ArchiveIntermediates/Runner/IntermediateBuildFilesPath/Pods.build/Release-iphoneos/integration_test.build/Objects-normal/arm64/integration_test_dependency_info.dat -o /Users/tcbdevbuild/Library/Developer/Xcode/DerivedData/Techswop-hcgdxzbupbdesybvyqnrorjdyarb/Build/Intermediates.noindex/ArchiveIntermediates/Runner/IntermediateBuildFilesPath/UninstalledProducts/iphoneos/integration_test.framework/integration_test
            ld: building for 'iOS', but linking in dylib (/Library/Developer/CommandLineTools/SDKs/MacOSX14.0.sdk/usr/lib/libobjc.A.tbd) built for 'macOS macCatalyst zippered(macOS/Catalyst)'
            clang: error: linker command failed with exit code 1 (use -v to see invocation)

已知zsh环境下无此问题，且zsh与Bash的PATH环境变量完全一致，但GitLab Runner仅支持Bash，需找到适配的修复方案。

修复方案 #

• 强制指定Xcode SDK与工具链路径：在Bash构建脚本开头添加以下命令，确保编译时优先使用Xcode自带的SDK和工具链，而非CommandLineTools：

  export SDKROOT=/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS17.0.sdk
  export PATH="/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin:$PATH"
  

  注意替换命令中的iOS SDK版本号为你项目实际使用的版本。

• 清理干扰性环境变量：Bash可能加载了CPATH或LIBRARY_PATH等影响链接的变量，构建前清空它们：

  unset CPATH
  unset LIBRARY_PATH
  

• 切换Xcode开发工具链：在构建命令前执行xcode-select，强制指向Xcode的开发者目录：

  sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
  

• 调整Podfile配置：在iOS项目的Podfile中添加post_install钩子，为integration_test target指定正确的iOS平台配置：

  post_install do |installer|
    installer.pods_project.targets.each do |target|
      if target.name == 'integration_test'
        target.build_configurations.each do |config|
          config.build_settings['SDKROOT'] = 'iphoneos17.0'
          config.build_settings['PLATFORM_NAME'] = 'iphoneos'
        end
      end
    end
  end
  

  修改后执行pod install，再重新构建。

• 清理构建缓存：清理Flutter、CocoaPods和Xcode的编译缓存，避免旧残留影响构建：

  flutter clean
  rm -rf ios/Pods ios/Podfile.lock ios/Runner.xcworkspace
  pod install
  rm -rf ~/Library/Developer/Xcode/DerivedData
  

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