Swift Academy · Lezione

Versionamento, risoluzione dei conflitti e Swift Plugin

Gestire gli intervalli di versione, risolvere i conflitti tra dipendenze e usare plugin per gli strumenti di build.

Lezione 4 di 412 passaggi

Versionamento, risoluzione dei conflitti e Swift Plugin è una lezione Swift Academy gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Swift Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Swift Academy include 4 lezioni in totale.

Versionamento semantico in SPM

SPM utilizza il versionamento semantico: MAJOR.MINOR.PATCH. Dichiari i requisiti con from:, exact: o .upToNextMajor.

.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 blocca le versioni esatte di tutte le dipendenze. Lo includa nei commit delle app; lo ometta per le librerie.

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

Risoluzione dei conflitti di versione

Quando due pacchetti richiedono versioni diverse della stessa dipendenza, SPM cerca di trovare una versione compatibile. I conflitti che non possono essere risolti causano un errore di build.

// 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

Imposizione di una versione

Aggiunga direttamente la dipendenza in conflitto al Package.swift della sua app per sovrascrivere la versione che SPM sceglierebbe altrimenti.

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

Plugin degli strumenti di build

I plugin degli strumenti di build vengono eseguiti durante la build per generare codice sorgente, elaborare risorse o eseguire automaticamente i linter.

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

Implementazione di un plugin degli strumenti di build

Un plugin degli strumenti di build è conforme a BuildToolPlugin e restituisce elementi BuildCommand o PrebuildCommand.

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]
    )]
  }
}

Plugin di comando

I plugin di comando vengono eseguiti su richiesta da Xcode o dalla CLI e sono utili per formattare il codice, eseguire il linting o generare la documentazione.

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

Esecuzione di un plugin di comando

Esegua i plugin di comando dal terminale o dal menu contestuale del clic con il tasto destro in Xcode.

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

Utilizzo di SwiftLint come plugin di build

SwiftLint viene distribuito come plugin SPM che viene eseguito automaticamente a ogni build.

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

Sandbox dei plugin

Per motivi di sicurezza, i plugin vengono eseguiti in una sandbox con accesso limitato al file system. Possono scrivere solo nella directory di lavoro a loro assegnata.

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

Verifica rapida

Qual è lo scopo di Package.resolved in un pacchetto Swift?

Rispondi nella lezione interattiva

Riepilogo della lezione

Utilizzi gli intervalli di versioni semantiche in Package.swift. Includa Package.resolved nei commit delle app per ottenere build riproducibili. Risolva i conflitti di versione dichiarando direttamente la dipendenza. I plugin degli strumenti di build vengono eseguiti automaticamente durante la build (linter, generatori di codice). I plugin di comando vengono eseguiti su richiesta. I plugin sono isolati in una sandbox per motivi di sicurezza.

Gratis per iniziare

Impara Swift con un tutor IA — gratis

Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.

Corsi: 122
Lezioni: 409

Inizia a imparare gratis Visualizza il corso completo

Domande Frequenti

La lezione «Versionamento, risoluzione dei conflitti e Swift Plugin» è gratuita?

Sì — il testo completo di «Versionamento, risoluzione dei conflitti e Swift Plugin» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Swift Academy, passa a CoddyKit PRO. Il corso Swift Academy include 4 lezioni in totale.

Cosa imparerò in «Versionamento, risoluzione dei conflitti e Swift Plugin»?

Gestire gli intervalli di versione, risolvere i conflitti tra dipendenze e usare plugin per gli strumenti di build. Eserciti Swift Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Swift Academy?

Non è richiesta alcuna esperienza precedente. Swift Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.

Quanto tempo richiede la lezione «Versionamento, risoluzione dei conflitti e Swift Plugin»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Swift Academy?

Sì. Ogni lezione Swift Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

Package.swift: target, prodotti e dipendenze
Package locali e moduli funzionali
Target binari e XCFramework
Versionamento, risoluzione dei conflitti e Swift Plugin

← Torna a Swift Academy