การกำหนดเวอร์ชัน การแก้ข้อขัดแย้ง และปลั๊กอิน Swift

การกำหนดเวอร์ชันตามความหมายใน SPM

.package(url: "https://github.com/apple/swift-log", from: "1.5.0"),
.package(url: "https://github.com/vapor/vapor", exact: "4.83.0"),
.package(url: "https://github.com/pointfreeco/swift-composable-architecture",
  .upToNextMajor(from: "1.0.0"))

Package.resolved

// Package.resolved (auto-generated):
// Pins exact commit hash and version for every dependency
// Run "swift package update" to update pinned versions

การแก้ไขข้อขัดแย้งของเวอร์ชัน

// PackageA requires Logging 1.4.0
// PackageB requires Logging 1.5.0
// SPM resolves to 1.5.0 (satisfies both >= 1.x)
// Conflict: PackageA requires Logging 1.x, PackageB requires 2.x

การบังคับใช้เวอร์ชัน

// Force Logging 1.5.0 by declaring it directly:
.package(url: "https://github.com/apple/swift-log", exact: "1.5.0")

ปลั๊กอินเครื่องมือสร้าง

// In Package.swift:
.plugin(
  name: "SourceGenerator",
  capability: .buildTool()
)

การสร้างปลั๊กอินเครื่องมือสร้าง

import PackagePlugin

@main
struct SourceGenerator: BuildToolPlugin {
  func createBuildCommands(context: PluginContext, target: Target) async throws -> [Command] {
    let output = context.pluginWorkDirectory.appending("Generated.swift")
    return [.buildCommand(
      displayName: "Generating sources",
      executable: try context.tool(named: "gen-tool").path,
      arguments: ["--output", output],
      outputFiles: [output]
    )]
  }
}

ปลั๊กอินคำสั่ง

// In Package.swift:
.plugin(
  name: "FormatPlugin",
  capability: .command(intent: .sourceCodeFormatting())
)

การเรียกใช้ปลั๊กอินคำสั่ง

// CLI:
swift package plugin format-source-code
// Xcode: right-click target → "Format Source Code"

การใช้ SwiftLint เป็นปลั๊กอินสร้าง

.package(url: "https://github.com/realm/SwiftLint", from: "0.54.0"),
// In target:
.plugin(name: "SwiftLintBuildToolPlugin", package: "SwiftLint")

พื้นที่แยกของปลั๊กอิน

// Accessible from plugins:
// context.pluginWorkDirectory — writable work dir
// context.package.directory — read-only source
// target.sourceFiles — source file list

ตรวจสอบความเข้าใจ

ทบทวนบทเรียน