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。