如何通过脚本将Swift Package添加到Xcode工作区？

核心思路 #

Xcode工作区本质是XML配置文件，要么通过xcodebuild原生命令添加本地包（更稳妥），要么手动编辑工作区的XML文件，两种方式都能实现脚本化操作。

步骤1：创建Swift Package #

先用swift package init在指定目录生成包，示例代码：

# 自定义参数，按需修改
PACKAGE_NAME="MyLocalPackage"
WORKSPACE_PATH="./MyWorkspace.xcworkspace"
PACKAGE_DIR="./$(basename "$WORKSPACE_PATH" .xcworkspace)/Packages/$PACKAGE_NAME"
PACKAGE_TYPE="library" # 可选值：executable

# 创建包所在目录并初始化
mkdir -p "$(dirname "$PACKAGE_DIR")"
cd "$(dirname "$PACKAGE_DIR")"
swift package init --name "$PACKAGE_NAME" --type "$PACKAGE_TYPE"

步骤2：将包添加到工作区 #

方法1：使用xcodebuild原生命令（推荐，Xcode 12+支持） #

无需手动编辑XML，命令会自动处理工作区配置：

# 检查工作区是否存在
if [ ! -d "$WORKSPACE_PATH" ]; then
  echo "错误：目标工作区不存在"
  exit 1
fi

# 添加本地包到工作区
xcodebuild -workspace "$WORKSPACE_PATH" add-local-package "$PACKAGE_DIR"

方法2：手动编辑XML文件（兼容Xcode 12以下版本） #

直接修改工作区的contents.xcworkspacedata配置文件，插入包的引用：

# 构造包引用的XML节点
PACKAGE_REF="<FileRef location=\"group:$PACKAGE_DIR\"></FileRef>"
WORKSPACE_CONTENT="$WORKSPACE_PATH/contents.xcworkspacedata"

# 避免重复添加
if grep -q "$PACKAGE_NAME" "$WORKSPACE_CONTENT"; then
  echo "包已存在于工作区"
  exit 0
fi

# 插入节点（适配macOS的sed语法）
sed -i.bak "/<Workspace>/a\    $PACKAGE_REF" "$WORKSPACE_CONTENT"
rm "$WORKSPACE_CONTENT.bak" # 删除自动生成的备份文件

步骤3：验证添加结果 #

执行以下命令查看工作区中的所有项目/包，确认添加成功：

xcodebuild -workspace "$WORKSPACE_PATH" list

完整可复用脚本 #

#!/bin/bash

# 配置参数
PACKAGE_NAME="MyLocalPackage"
WORKSPACE_PATH="./MyWorkspace.xcworkspace"
PACKAGE_TYPE="library"
PACKAGE_DIR="./$(basename "$WORKSPACE_PATH" .xcworkspace)/Packages/$PACKAGE_NAME"

# 1. 创建Swift Package
echo "开始创建Swift Package: $PACKAGE_NAME"
mkdir -p "$(dirname "$PACKAGE_DIR")"
cd "$(dirname "$PACKAGE_DIR")"
swift package init --name "$PACKAGE_NAME" --type "$PACKAGE_TYPE"
if [ $? -ne 0 ]; then
  echo "创建包失败，请检查路径和参数"
  exit 1
fi

# 2. 添加到工作区
echo "将包添加到工作区: $WORKSPACE_PATH"
if [ ! -d "$WORKSPACE_PATH" ]; then
  echo "错误：指定的工作区不存在"
  exit 1
fi

# 使用xcodebuild添加（Xcode 12+）
xcodebuild -workspace "$WORKSPACE_PATH" add-local-package "$PACKAGE_DIR"
if [ $? -eq 0 ]; then
  echo "包已成功添加到工作区"
else
  echo "添加失败，请检查Xcode版本或路径"
  exit 1
fi

# 3. 验证
echo "工作区当前包含的内容："
xcodebuild -workspace "$WORKSPACE_PATH" list

注意事项 #

• 确保Xcode版本≥12，xcodebuild add-local-package命令才可用
• 手动编辑XML时，需保持缩进格式与原有内容一致，否则Xcode可能无法正常解析工作区
• 建议使用绝对路径配置参数，避免因当前工作目录变化导致路径错误

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