能否在Swift Package的BuildToolPlugin中执行npm ci与npm build命令？

可以通过Swift Package的BuildToolPlugin执行npm ci和npm build命令，让Swift Package自行管理WebPack项目的构建流程，完全替代原项目中的自定义构建阶段。

具体实现步骤 #

1. 自定义BuildToolPlugin #

创建继承自BuildToolPlugin的插件类，在createBuildCommands方法中定义npm相关构建命令：

import PackagePlugin

@main
struct WebPackBuildPlugin: BuildToolPlugin {
    func createBuildCommands(context: PluginContext, target: Target) async throws -> [Command] {
        guard let target = target as? SourceModuleTarget else { return [] }
        
        // 定位WebPack项目根目录（根据你的实际目录结构调整）
        let webProjectDir = target.directory.appending(subpath: "WebContent")
        
        // 执行npm ci安装依赖
        let npmCiCmd = Command.prebuildCommand(
            displayName: "Install WebPack Dependencies",
            executable: try context.tool(named: "npm").path,
            arguments: ["ci"],
            workingDirectory: webProjectDir
        )
        
        // 执行npm build构建WebPack项目
        let npmBuildCmd = Command.prebuildCommand(
            displayName: "Build WebPack Project",
            executable: try context.tool(named: "npm").path,
            arguments: ["run", "build"],
            workingDirectory: webProjectDir
        )
        
        // 将WebPack构建产物复制到Package的资源目录
        let outputDir = context.pluginWorkDirectory.appending(subpath: "WebBuildOutput")
        let copyCmd = Command.prebuildCommand(
            displayName: "Copy WebPack Output",
            executable: try context.tool(named: "cp").path,
            arguments: ["-R", webProjectDir.appending(subpath: "dist").string, outputDir.string]
        )
        
        // 按顺序执行命令：先安装依赖，再构建，最后复制产物
        return [npmCiCmd, npmBuildCmd, copyCmd]
    }
}

2. 配置Package.swift #

在Package配置中声明插件，并让目标模块依赖该插件，同时标记构建产物为资源：

let package = Package(
    name: "YourPackage",
    products: [
        .library(name: "YourPackage", targets: ["YourPackage"]),
    ],
    targets: [
        .target(
            name: "YourPackage",
            resources: [.process("WebBuildOutput")],
            plugins: [.plugin(name: "WebPackBuildPlugin")]
        ),
        .plugin(
            name: "WebPackBuildPlugin",
            capability: .buildTool()
        ),
    ]
)

3. 关键注意事项 #

• 确保开发环境已安装npm，插件会自动查找系统中的npm可执行文件。
• 根据你的WebPack项目实际输出目录（示例中为dist）调整路径参数。
• 若需要指定Node版本或自定义环境变量，可通过Command的environment参数传递。
• Swift 5.9及以上版本支持通过Command.Order更精确地控制命令执行顺序。

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