Swift Package Manager (SPM) 套件管理教學

現代軟體開發很少從零造輪子。當我們需要使用第三方函式庫(例如:網路圖片載入、JSON 動畫、資料庫封裝)時,就需要依賴管理工具。Apple 官方提供的 Swift Package Manager (SPM) 是目前的最佳選擇。

如何加入套件 (Add Package)

  1. 在 Xcode 中,選擇最上層的專案檔案。
  2. 進入 Package Dependencies 分頁。
  3. 點擊 + 按鈕。
  4. 在搜尋欄貼上 Github 網址(例如:https://github.com/onevcat/Kingfisher)。
  5. 設定 Dependency Rule
    • Up to Next Major Version (推薦):例如 7.0.0,它會自動更新到 7.9.9,但不會升級到 8.0.0 (可能包含破壞性更新)。
    • Exact Version:鎖定特定版本。
  6. 點擊 Add Package 並選擇要加入的 Target。

使用套件

加入成功後,在程式碼中直接 import 即可。

import SwiftUI
import Kingfisher // 引入第三方套件

struct ContentView: View {
    var body: some View {
        KFImage(URL(string: "https://example.com/image.png"))
            .resizable()
            .scaledToFit()
    }
}

移除套件

同樣在 Package Dependencies 分頁,選中套件後按鍵盤 Delete 或點擊 - 按鈕即可移除。

相較於舊時代的 CocoaPods (需要維護 Podfile) 或 Carthage,SPM 與 Xcode 整合度最高,使用體驗最為流暢。