El Gestor de Paquets Swift (Swift Package Manager o SPM) és una eina poderosa que facilita la gestió de dependències i la distribució de codi en projectes Swift. En aquesta secció, aprendrem com utilitzar el SPM per afegir dependències a un projecte, crear i distribuir paquets Swift, i gestionar les versions de les dependències.

1. Introducció al Gestor de Paquets Swift
2. Afegir Dependències a un Projecte
3. Crear un Paquet Swift
4. Distribuir un Paquet Swift
5. Gestió de Versions
6. Exercicis Pràctics

El Gestor de Paquets Swift és una eina integrada en Swift que permet:

• Gestionar dependències de tercers.
• Crear i distribuir paquets de codi.
• Automatitzar la construcció i les proves de projectes.

• Integració amb Swift: SPM està integrat directament amb el llenguatge Swift i Xcode.
• Declaratiu: Utilitza un fitxer Package.swift per definir les dependències i la configuració del paquet.
• Gestió de Versions: Permet especificar versions de dependències per assegurar la compatibilitat.

Per afegir dependències a un projecte Swift, segueix aquests passos:

1. Crear o Obrir un Projecte Swift: Si no tens un projecte, crea'n un nou amb Xcode o des de la línia de comandes.

2. Crear el Fitxer Package.swift: Aquest fitxer defineix les dependències del projecte. Exemple de fitxer Package.swift:

   // swift-tools-version:5.3
   import PackageDescription
   
   let package = Package(
       name: "MyProject",
       dependencies: [
           .package(url: "https://github.com/Alamofire/Alamofire.git", from: "5.4.0")
       ],
       targets: [
           .target(
               name: "MyProject",
               dependencies: ["Alamofire"]),
       ]
   )
   

3. Afegir el Fitxer Package.swift al Projecte: Si estàs utilitzant Xcode, pots afegir el fitxer Package.swift al teu projecte.

4. Construir el Projecte: Xcode o la línia de comandes descarregarà i integrarà les dependències.

Per crear un paquet Swift, segueix aquests passos:

1. Crear un Nou Directori: Crea un directori per al teu paquet.

   mkdir MySwiftPackage
   cd MySwiftPackage
   

2. Inicialitzar el Paquet: Utilitza la comanda swift package init per inicialitzar el paquet.

   swift package init --type library
   

3. Editar el Fitxer Package.swift: Defineix les dependències i la configuració del paquet.

   // swift-tools-version:5.3
   import PackageDescription
   
   let package = Package(
       name: "MySwiftPackage",
       products: [
           .library(
               name: "MySwiftPackage",
               targets: ["MySwiftPackage"]),
       ],
       dependencies: [
           // Afegir dependències aquí
       ],
       targets: [
           .target(
               name: "MySwiftPackage",
               dependencies: []),
           .testTarget(
               name: "MySwiftPackageTests",
               dependencies: ["MySwiftPackage"]),
       ]
   )
   

4. Afegir Codi: Afegeix el codi font al directori Sources/MySwiftPackage.

5. Construir i Provar el Paquet: Utilitza les comandes swift build i swift test per construir i provar el paquet.

Per distribuir un paquet Swift, segueix aquests passos:

1. Publicar el Codi: Puja el codi a un repositori públic, com GitHub.

2. Crear una Versió: Utilitza les eines del repositori (com GitHub) per crear una versió del paquet.

3. Afegir el Paquet com a Dependència: Altres projectes poden afegir el teu paquet com a dependència utilitzant l'URL del repositori i la versió.

La gestió de versions en SPM es basa en el versionat semàntic (SemVer). Això significa que les versions es defineixen en el format major.minor.patch.

• Major: Canvis incompatibles amb versions anteriors.
• Minor: Noves funcionalitats compatibles amb versions anteriors.
• Patch: Correccions d'errors i millores menors.

Aquest exemple especifica que qualsevol versió de Alamofire a partir de la 5.4.0 és acceptable, sempre que no hi hagi canvis incompatibles (és a dir, fins a la 5.x.x).

1. Crea un nou projecte Swift.
2. Afegeix la dependència Alamofire al projecte.
3. Utilitza Alamofire per fer una sol·licitud HTTP GET a https://jsonplaceholder.typicode.com/todos/1 i imprimeix la resposta.

Solució

1. Crea un nou paquet Swift.
2. Afegeix una funció que retorna una cadena de text.
3. Publica el paquet en un repositori públic.
4. Afegeix el paquet com a dependència en un altre projecte i utilitza la funció.

Solució

1. Crear el Paquet:

   mkdir MySwiftPackage
   cd MySwiftPackage
   swift package init --type library
   

2. Afegir la Funció:

   // Sources/MySwiftPackage/MySwiftPackage.swift
   public struct MySwiftPackage {
       public static func greet() -> String {
           return "Hello, Swift Package!"
       }
   }
   

3. Publicar el Paquet: Puja el codi a un repositori públic, com GitHub.

4. Afegir el Paquet com a Dependència:

   // swift-tools-version:5.3
   import PackageDescription
   
   let package = Package(
       name: "AnotherProject",
       dependencies: [
           .package(url: "https://github.com/username/MySwiftPackage.git", from: "1.0.0")
       ],
       targets: [
           .target(
               name: "AnotherProject",
               dependencies: ["MySwiftPackage"]),
       ]
   )
   

5. Utilitzar la Funció:

   import MySwiftPackage
   
   print(MySwiftPackage.greet())
   

El Gestor de Paquets Swift és una eina essencial per a la gestió de dependències i la distribució de codi en projectes Swift. Amb els coneixements adquirits en aquesta secció, ara pots afegir dependències, crear i distribuir paquets, i gestionar versions de manera eficient. Aquests conceptes són fonamentals per a qualsevol desenvolupador Swift que vulgui treballar en projectes moderns i col·laboratius.