Swift Package Registry
隨著相依性數量增加,解析它們所需的時間也會隨之增長。雖然像 CocoaPods 或 npm 等其他套件管理器採用集中式架構,但 Swift Package Manager 並非如此。因此,SwiftPM 需要透過深度複製每個儲存庫來解析相依性,這不僅耗時,而且比起集中式方法會佔用更多記憶體。為了解決這個問題,Tuist 提供了 Package Registry 的實作,讓你可以只下載你 真正需要 的提交記錄。Registry 中的套件基於 Swift Package Index;只要能在該處找到套件,該套件也可在 Tuist Registry 中使用。此外,這些套件透過邊緣儲存分散在全球各地,以在解析時將延遲降至最低。
使用方式#
有兩種設定 Registry 的方式:
選項 1:在建置期間自動設定(建議)#
如果你使用 Tuist 來產生專案,可以在 Tuist.swift 設定中將 registryEnabled 選項設為啟用,以開啟 Registry:
import ProjectDescription
let tuist = Tuist(
project: .tuist(
generationOptions: .options(
registryEnabled: true
)
)
)
使用此選項時,tuist generate 會自動在你的工作區中建立 Registry 設定檔。這讓你無需另外執行 tuist registry setup。
registryEnabled 也會為透過 Xcode 預設 Swift Package Manager 整合(而非 Tuist 基於 XcodeProj 的整合)來整合相依性的專案設定 Registry。它不會設定 Xcode 從 Registry 解析以原始碼控制 URL 宣告的套件。若要這麼做,請依照 解析原始碼控制套件 中的說明,在每台機器上執行一次 tuist registry setup。
選項 2:手動設定#
若要手動設定 Registry,請在專案目錄中執行以下指令:
tuist registry setup
此指令會產生一個啟用專案 Registry 的設定檔。請確保將此檔案提交至版本控制,讓你的團隊也能受惠於 Registry。
驗證(選用)#
驗證是 選用 的。若未進行驗證,你可以使用 Registry,但每個 IP 位址的速率限制為每分鐘 1,000 次請求。若要獲得每分鐘 20,000 次請求 的較高速率限制,你可以執行以下指令進行驗證:
tuist registry login
驗證需要擁有 Tuist 帳號與專案。
解析相依性#
若要從 Registry 而非原始碼控制解析相依性,請根據你的專案設定繼續閱讀:
- Xcode project
- Generated project with the Xcode package integration
- Generated project with the XcodeProj-based package integration
- Swift package
若要在 CI 上設定 Registry,請參閱此指南:持續整合。
套件 Registry 識別碼#
當你在 Package.swift 或 Project.swift 檔案中使用套件 Registry 識別碼時,需要將套件的 URL 轉換為 Registry 慣例格式。Registry 識別碼一律採用 {organization}.{repository} 的形式。例如,若要為 https://github.com/pointfreeco/swift-composable-architecture 套件使用 Registry,其套件 Registry 識別碼應為 pointfreeco.swift-composable-architecture。
識別碼不能包含超過一個點號。如果儲存庫名稱包含點號,則會替換為底線。例如,https://github.com/groue/GRDB.swift 套件的 Registry 識別碼將為 groue.GRDB_swift。