跳至內容

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:

swift
import ProjectDescription
let tuist = Tuist(
project: .tuist(
generationOptions: .options(
registryEnabled: true
)
)
)

使用此選項時,tuist generate 會自動在你的工作區中建立 Registry 設定檔。這讓你無需另外執行 tuist registry setup。

Tip

registryEnabled 也會為透過 Xcode 預設 Swift Package Manager 整合(而非 Tuist 基於 XcodeProj 的整合)來整合相依性的專案設定 Registry。它不會設定 Xcode 從 Registry 解析以原始碼控制 URL 宣告的套件。若要這麼做,請依照 解析原始碼控制套件 中的說明,在每台機器上執行一次 tuist registry setup。

選項 2:手動設定#

若要手動設定 Registry,請在專案目錄中執行以下指令:

bash
tuist registry setup

此指令會產生一個啟用專案 Registry 的設定檔。請確保將此檔案提交至版本控制,讓你的團隊也能受惠於 Registry。

驗證(選用)#

驗證是 選用 的。若未進行驗證,你可以使用 Registry,但每個 IP 位址的速率限制為每分鐘 1,000 次請求。若要獲得每分鐘 20,000 次請求 的較高速率限制,你可以執行以下指令進行驗證:

bash
tuist registry login
Note

驗證需要擁有 Tuist 帳號與專案。

解析相依性#

若要從 Registry 而非原始碼控制解析相依性,請根據你的專案設定繼續閱讀:

若要在 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。

Note

識別碼不能包含超過一個點號。如果儲存庫名稱包含點號,則會替換為底線。例如,https://github.com/groue/GRDB.swift 套件的 Registry 識別碼將為 groue.GRDB_swift。