如何自动为Xcode子项目创建自定义配置？

我刚好处理过不少这类多环境下的Xcode模块化拆分需求，分享几个能帮你自动化同步配置的方案，比手动一个个改高效太多：

1. 用xcconfig文件统一管理核心配置 #

这是最推荐的轻量方案，从根源上避免配置不一致：

• 先在主项目根目录创建共享的xcconfig文件，比如SharedConfig.xcconfig，把所有环境（Appstore、staging、production）的公共配置参数都放在这里，比如：

  DEVELOPMENT_TEAM = ABC123XYZ
  CODE_SIGN_STYLE = Automatic
  PRODUCT_BUNDLE_IDENTIFIER_BASE = com.yourcompany
  

  针对不同环境的差异参数，可以创建对应环境的xcconfig，比如AppstoreConfig.xcconfig：

  #include "SharedConfig.xcconfig"
  PRODUCT_BUNDLE_IDENTIFIER = $(PRODUCT_BUNDLE_IDENTIFIER_BASE).appstore
  

• 给主项目和所有子项目的对应配置项（比如Appstore）导入这些共享xcconfig文件。这样所有模块都会自动继承统一配置，你只需要维护一套xcconfig，不用再手动同步每个子项目的设置。
• 如果某个子项目有特殊配置需求，直接在它自己的xcconfig里覆盖共享参数即可，灵活性拉满。

2. 写脚本批量同步配置 #

如果已经有现成的子项目，不想重构xcconfig，可以用脚本批量修改：

• 用Shell或Python脚本，先通过xcodebuild命令读取主项目的配置信息，比如获取Appstore环境的团队ID：

  MAIN_APPSTORE_TEAM=$(xcodebuild -project MainProject.xcodeproj -scheme MainApp -configuration Appstore -showBuildSettings | grep DEVELOPMENT_TEAM | awk '{print $3}')
  

• 然后用专门的Xcode项目编辑工具（比如Ruby的xcodeproj gem）遍历所有子项目的.pbxproj文件，批量更新对应的配置项。比如用xcodeproj修改子项目的团队ID：

  require 'xcodeproj'
  project = Xcodeproj::Project.open('SubProject.xcodeproj')
  project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['DEVELOPMENT_TEAM'] = 'ABC123XYZ'
    end
  end
  project.save
  

• 可以把这个脚本加到项目的Pre-build Phase里，每次构建前自动执行，确保子项目配置和主项目完全一致。

3. 参考CocoaPods的配置同步逻辑 #

CocoaPods能自动让Pods项目和主项目配置对齐，核心逻辑可以借鉴：

• CocoaPods的核心思路是：解析主项目的所有Configuration列表，给Pods项目创建对应的Configuration，然后复制主项目的Build Settings参数，处理Target Dependencies的关联。
• 你可以直接用现成的工具简化这个流程，比如XcodeGen：用YAML文件定义整个Workspace的结构、所有Target和配置，然后xcodegen generate就能自动生成符合要求的主项目和子项目，所有配置都在YAML里统一管理，修改一次同步所有模块。
• 要是想自己实现，去看CocoaPods源码里的XCConfig和PodTarget相关模块，它的配置同步逻辑写得很完善。

几个注意点 #

• 不管用哪种方案，先备份项目再操作，避免配置被误改。
• 自定义的环境变量尽量放在共享xcconfig里，不要分散在各个Target的Build Settings中。
• 可以加个Git Hook（比如pre-commit），自动检查所有子项目的配置是否和主项目一致，防止有人手动修改子项目配置导致差异。

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