Swift & Xcode：构建应用时如何将指定文件复制到应用根目录

你提到的「应用根目录」对应Xcode构建产物中.app包的根路径（而非默认存放资源的Contents/Resources目录），可通过以下两种方案实现：

方案1：Xcode项目配置（适用带.xcodeproj的开发场景） #

• 打开Xcode项目，选中左侧顶层项目文件，在TARGETS列表中选中你的应用目标
• 切换到Build Phases标签页
• 点击左上角+号，选择New Run Script Phase
• 在脚本输入框内填入以下内容，替换其中的源文件路径为你的实际文件路径：

# 源文件路径：替换为你本地application.json的实际路径
SOURCE_FILE="${SRCROOT}/你的项目目录/application.json"
# 目标路径为.app包的根目录
TARGET_PATH="${BUILT_PRODUCTS_DIR}/${FULL_PRODUCT_NAME}/"

cp -f "${SOURCE_FILE}" "${TARGET_PATH}"

• 可选：在「Input Files」栏添加源文件路径，「Output Files」栏添加目标文件路径，可避免无变更时重复执行脚本
• 构建完成后右键.app选择「显示包内容」，即可在根目录看到目标文件

方案2：纯Swift Package配置（适用完全用Package.swift管理的可执行目标） #

你需要通过自定义构建插件实现文件复制，步骤如下：

1. 在Package.swift中添加构建插件声明：

// swift-tools-version: 5.8
import PackageDescription

let package = Package(
    name: "你的项目名",
    targets: [
        .executableTarget(
            name: "你的可执行目标名",
            path: "Sources/你的目标名"
        )
    ]
)

// 注册自定义构建插件
package.plugins.append(
    .plugin(
        name: "CopyFileToAppRoot",
        capability: .buildTool()
    )
)

2. 在项目根目录下创建Plugins/CopyFileToAppRoot目录，新建CopyFileToAppRoot.swift插件实现文件：

import PackagePlugin
import Foundation

@main
struct CopyFileToAppRoot: BuildToolPlugin {
    func createBuildCommands(context: PluginContext, target: Target) async throws -> [Command] {
        guard let executableTarget = target as? ExecutableTarget else { return [] }
        // 源文件路径：替换为你的application.json实际路径
        let sourceFile = executableTarget.directory.appending("application.json")
        // 目标路径：构建产物根目录
        let outputFile = context.productsDirectory.appending(sourceFile.lastComponent)
        
        return [
            .prebuildCommand(
                displayName: "Copy application.json to app root",
                executable: try context.tool(named: "cp").path,
                arguments: ["-f", sourceFile.string, outputFile.string],
                outputFiles: [outputFile]
            )
        ]
    }
}

注意：iOS应用的.app根目录不允许存放自定义非标准文件，上架App Store会被审核拒绝，iOS场景建议优先将资源放在bundle内使用。

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