使用xcodebuild构建归档iOS App报错：source: unbound variable

问题详情 #

• 手动通过Xcode的Product菜单构建/归档App完全正常，但使用xcodebuild命令行构建时失败
• 使用的构建命令：

  xcodebuild archive -scheme Dropless -configuration Release -destination 'generic/platform=iOS' SKIP_INSTALL=NO BUILD_LIBRARIES_FOR_DISTRIBUTION=YES
  

• 报错内容：

  /ios/Pods/Target Support Files/Pods-Dropless/Pods-Dropless-frameworks.sh: line 42: source: unbound variable Command PhaseScriptExecution failed with a nonzero exit code
  

• 已排查：调整架构配置无效，手动构建正常可排除架构定义问题
• 架构配置截图：
• 环境信息：
  • Xcode版本：13.4.1
  • macOS版本：12.5.1 Monterey

解决思路 #

1. 修复Pods脚本的未绑定变量问题 #

报错指向frameworks.sh脚本的source命令遇到未绑定变量，大概率是脚本中启用了set -u（严格检查未定义变量）：

• 打开/ios/Pods/Target Support Files/Pods-Dropless/Pods-Dropless-frameworks.sh文件，定位到第42行附近
• 若存在set -u，可尝试注释该行；或者对引用的变量添加默认值（例如${VARIABLE_NAME:-}）

2. 临时关闭命令行的严格变量检查 #

Xcode手动构建的shell环境和命令行环境可能存在差异，若你的shell配置（如.bashrc/.zshrc）中设置了set -u，可在构建命令前临时关闭：

set +u && xcodebuild archive -scheme Dropless -configuration Release -destination 'generic/platform=iOS' SKIP_INSTALL=NO BUILD_LIBRARIES_FOR_DISTRIBUTION=YES

3. 更新CocoaPods版本 #

旧版CocoaPods生成的脚本可能存在兼容性问题，更新到最新稳定版后重新安装依赖：

sudo gem install cocoapods
pod install

4. 确认命令行工具与Xcode版本一致 #

检查当前命令行使用的Xcode路径：

xcode-select -p

若输出路径与你手动打开的Xcode不一致，执行以下命令切换：

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

内容的提问来源于stack exchange，提问作者Jake Giles-Phillips