基于CocoaPods的Swift多配置库构建方案求助

1. 为库项目添加自定义Build Configuration #

打开你的Swift库Xcode项目：

• 点击项目文件 → 选中目标库 → 切换到Info标签页
• 在Configurations区域点击+号，复制Debug配置，分别命名为Debug-Dev和Debug-Staging，保留原有Release配置
• 创建对应xcconfig文件（建议放在Configs目录下）：
  • Debug-Dev.xcconfig

  #include "../Pods/Target Support Files/Pods-YourLibrary/Pods-YourLibrary.debug.xcconfig"
  API_BASE_URL = https://dev.yourdomain.com
  LOG_LEVEL = VERBOSE
  

  • Debug-Staging.xcconfig

  #include "../Pods/Target Support Files/Pods-YourLibrary/Pods-YourLibrary.debug.xcconfig"
  API_BASE_URL = https://staging.yourdomain.com
  LOG_LEVEL = INFO
  

  • Release.xcconfig

  #include "../Pods/Target Support Files/Pods-YourLibrary/Pods-YourLibrary.release.xcconfig"
  API_BASE_URL = https://api.yourdomain.com
  LOG_LEVEL = ERROR
  

• 将xcconfig文件关联到对应配置：在Info标签的Configurations列表中，为每个配置选择对应的xcconfig文件

2. 创建对应Scheme用于快速切换 #

• 点击Xcode顶部Scheme选择器 → Edit Scheme... → 点击+号创建新Scheme
• 分别创建YourLibrary-Dev、YourLibrary-Staging、YourLibrary-Release三个Scheme
• 每个Scheme的Run、Test等动作，选择对应Build Configuration（Dev选Debug-Dev，Staging选Debug-Staging，Release选Release）
• 勾选Shared选项，将Scheme文件提交到版本控制，方便其他开发者直接使用

3. 修改Podspec文件，让CocoaPods识别自定义配置 #

在YourLibrary.podspec中添加以下配置，确保集成时保留自定义变量：

Pod::Spec.new do |s|
  # ... 其他已有配置 ...
  
  # 声明继承环境变量
  s.xcconfig = {
    'API_BASE_URL' => '$(inherited)',
    'LOG_LEVEL' => '$(inherited)'
  }
  
  # 指定调试和发布配置
  s.debug_configurations = ['Debug-Dev', 'Debug-Staging']
  s.release_configurations = ['Release']
end

4. 添加post_install钩子，防止pod install覆盖配置 #

在库项目的Podfile中加入脚本，确保每次执行pod install后配置不丢失：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    next unless target.name == 'YourLibrary'
    
    # 检查并创建自定义配置
    ['Debug-Dev', 'Debug-Staging'].each do |config_name|
      unless installer.pods_project.build_configurations.any? { |c| c.name == config_name }
        new_config = installer.pods_project.build_configurations.new(name: config_name)
        xcconfig_file = installer.pods_project.files.find { |f| f.path == "Configs/#{config_name}.xcconfig" }
        new_config.base_configuration_reference = xcconfig_file
      end
    end
    
    # 为目标关联正确的xcconfig文件
    target.build_configurations.each do |config|
      xcconfig_file = installer.pods_project.files.find { |f| f.path == "Configs/#{config.name}.xcconfig" }
      if xcconfig_file
        config.base_configuration_reference = xcconfig_file
      end
    end
  end
end

5. 在Swift代码中读取环境变量 #

在库代码中通过Bundle读取配置变量，注意要先在库的Info.plist中添加对应键，值设为$(API_BASE_URL)和$(LOG_LEVEL)：

import Foundation

struct Environment {
  static let apiBaseURL: URL = {
    guard let urlString = Bundle.main.infoDictionary?["API_BASE_URL"] as? String,
          let url = URL(string: urlString) else {
      fatalError("API_BASE_URL配置错误")
    }
    return url
  }()
  
  static let logLevel: String = {
    Bundle.main.infoDictionary?["LOG_LEVEL"] as? String ?? "ERROR"
  }()
}

6. 提交文件到版本控制 #

将新增的xcconfig文件、Scheme文件（位于项目xcshareddata/xcschemes/目录）、修改后的Podspec和Podfile提交到Git，确保其他开发者拉取后可直接使用。

这样设置后，库开发者能通过切换Scheme快速切换环境，集成该Pod的应用只会获取Release配置版本，不会受调试配置影响。

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