使用xcodebuild命令行时，如何触发Xcode项目中的Run Script构建阶段？

先排查核心原因 #

先搞清楚脚本没跑起来的根因，常见的几个点：

• 脚本的执行时机不对：比如你把Run Script放在了Build阶段之后，但xcodebuild test的构建流程可能没走到那一步。检查项目里Run Script的位置，要确保它在「Compile Sources」之后、「Link Binary With Libraries」之前，或者是测试目标依赖的目标的构建阶段里。
• 脚本加了环境判断：比如脚本里写了[ "$CONFIGURATION" = "Debug" ]这种条件，但CI用的是Release配置；或者有只针对Xcode GUI的判断（比如检查IDEBuildOperationMaxNumberOfConcurrentCompileTasks变量），导致命令行下直接跳过。
• 测试目标没依赖带脚本的目标：如果Run Script在主App或框架目标里，但测试目标没把这个目标设为依赖，xcodebuild test可能只会构建测试目标本身，直接跳过带脚本的部分。

让xcodebuild执行项目内Run Script的具体方案 #

1. 明确指定目标和配置 #

确保xcodebuild命令明确指向包含Run Script的目标和正确的配置，比如项目式的写法：

xcodebuild test -project YourProject.xcodeproj -target YourMainTarget -scheme YourTestScheme -configuration Debug -destination 'platform=iOS Simulator,name=iPhone 15'

如果是workspace：

xcodebuild test -workspace YourWorkspace.xcworkspace -scheme YourScheme -configuration Debug -destination 'platform=iOS Simulator,name=iPhone 15'

核心是让xcodebuild先构建带Run Script的目标，再跑测试。

2. 先单独构建带脚本的目标 #

如果测试目标和主目标是分离的，可以先单独构建主目标（触发脚本），再跑测试：

# 先构建主目标，触发Run Script
xcodebuild build -project YourProject.xcodeproj -target YourMainTarget -configuration Debug -destination 'platform=iOS Simulator,name=iPhone 15'
# 再运行测试，跳过主目标的测试（如果有的话）
xcodebuild test -project YourProject.xcodeproj -scheme YourTestScheme -configuration Debug -destination 'platform=iOS Simulator,name=iPhone 15' -skip-testing:YourMainTarget

3. 取消"仅在安装时运行"选项 #

如果你的Run Script勾选了「Run script only when installing」，那只有执行xcodebuild install时才会跑脚本，xcodebuild test不会触发。把这个勾选去掉，确保脚本每次构建都执行。

4. CI命令里手动调用脚本 #

要是上面的方法都不好使，直接在xcodebuild test之前手动执行脚本文件：

# 先跑你的脚本
./path/to/your/script.sh
# 再执行测试
xcodebuild test ...

这样不管Xcode构建流程有没有触发脚本，都能保证它在测试前执行。

Swift Package的特殊处理 #

如果你的模块是Swift Package，注意SPM的构建阶段和Xcode项目的Run Script是分开的。可以把脚本逻辑写到Package.swift的构建阶段里：

let package = Package(
    name: "YourPackage",
    products: [
        .library(name: "YourPackage", targets: ["YourPackage"]),
    ],
    targets: [
        .target(
            name: "YourPackage",
            resources: [.process("Resources")],
            buildPhases: [
                .scriptCommand(
                    name: "Update Bundle",
                    script: """
                        # 这里放你的脚本逻辑
                        cp -R Sources/YourPackage/Resources/* .build/debug/YourPackage.bundle/
                        """
                )
            ]
        ),
        .testTarget(
            name: "YourPackageTests",
            dependencies: ["YourPackage"]
        ),
    ]
)

这样不管是Xcode GUI、xcodebuild test还是swift test，都会执行这个构建脚本。

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