如何通过命令行给iOS Xcode项目批量添加SPM包？

方法1：用Ruby脚本结合xcodeproj gem修改项目文件 #

xcodeproj是官方维护的Ruby库，可直接操作Xcode的.xcodeproj项目文件，通过脚本批量定义SPM依赖，实现类似CocoaPods的批量集成工作流。

步骤：

• 安装xcodeproj：gem install xcodeproj
• 创建Ruby脚本（比如add_spm_deps.rb），代码示例：

require 'xcodeproj'

# 加载目标Xcode项目
project_path = './YourProject.xcodeproj'
project = Xcodeproj::Project.open(project_path)

# 定义要批量添加的SPM依赖列表，格式：[包名称, 仓库URL, 版本要求]
spm_dependencies = [
  ["Alamofire", "https://github.com/Alamofire/Alamofire.git", "~> 5.8"],
  ["SnapKit", "https://github.com/SnapKit/SnapKit.git", "~> 5.6"]
]

# 获取项目的SPM依赖管理器
package_manager = project.root_object.package_dependency_manager

spm_dependencies.each do |name, url, version|
  # 跳过已存在的依赖，避免重复添加
  existing_dep = package_manager.package_dependencies.find { |d| d.repository_url == url }
  next if existing_dep

  # 创建并添加新的SPM依赖
  new_dep = package_manager.new_package_dependency(
    name: name,
    repository_url: url,
    requirement: Xcodeproj::XCSwiftPackageDependencyRequirement.version(version)
  )
  package_manager.package_dependencies << new_dep
end

# 保存项目修改
project.save

• 运行脚本：ruby add_spm_deps.rb
• 打开Xcode，等待项目自动解析并拉取所有新增依赖。

方法2：本地SPM包中转批量引入 #

创建一个本地Swift Package作为“依赖容器”，把所有需要的SPM依赖定义在这个包的Package.swift里，再将这个本地包添加到iOS项目中，间接实现批量引入。

步骤：

1. 在项目目录下创建本地Swift Package：
   终端执行swift package init --type library，命名比如SPMDepsContainer
2. 修改本地包的Package.swift，添加所有目标依赖：

// swift-tools-version: 5.9
import PackageDescription

let package = Package(
    name: "SPMDepsContainer",
    platforms: [.iOS(.v15)], // 匹配你的iOS项目最低版本要求
    products: [
        .library(
            name: "SPMDepsContainer",
            targets: ["SPMDepsContainer"]),
    ],
    dependencies: [
        .package(url: "https://github.com/Alamofire/Alamofire.git", from: "5.8.0"),
        .package(url: "https://github.com/SnapKit/SnapKit.git", from: "5.6.0")
    ],
    targets: [
        .target(
            name: "SPMDepsContainer",
            dependencies: [
                .product(name: "Alamofire", package: "Alamofire"),
                .product(name: "SnapKit", package: "SnapKit")
            ]),
    ]
)

3. 在iOS项目中添加这个本地包：
   打开Xcode，选择File > Add Package Dependencies...，点击Add Local...，选择刚才创建的SPMDepsContainer文件夹。
4. 将需要的依赖产品（比如Alamofire、SnapKit）添加到iOS项目的对应target中。
   后续新增依赖时，只需修改本地包的Package.swift，再在Xcode中更新依赖即可。

方法3：手动修改Package.resolved文件（谨慎使用） #

Xcode会生成Package.resolved文件记录SPM依赖的解析状态，手动修改该文件后，Xcode会重新拉取依赖。此方法需熟悉文件格式，适合临时批量操作。

步骤：

1. 找到项目目录下的YourProject.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved文件
2. 在object.pins数组中添加依赖条目，示例：

{
  "object": {
    "pins": [
      {
        "identity": "alamofire",
        "kind": "remoteSourceControl",
        "location": "https://github.com/Alamofire/Alamofire.git",
        "state": {
          "version": "5.8.1"
        }
      },
      {
        "identity": "snapkit",
        "kind": "remoteSourceControl",
        "location": "https://github.com/SnapKit/SnapKit.git",
        "state": {
          "version": "5.6.0"
        }
      }
    ]
  },
  "version": 1
}

3. 保存文件后，关闭并重新打开Xcode，等待Xcode自动拉取新依赖，之后手动将这些依赖添加到对应target中。

内容的提问来源于stack exchange，提问作者A Man With Feet