Swift Package Registry
依存関係の数が増えるにつれて、それらの解決にかかる時間も増大します。CocoaPods や npm などの他のパッケージマネージャーは中央集権型ですが、Swift Package Manager はそうではありません。そのため、SwiftPM は各リポジトリを完全なクローン(deep clone)して依存関係を解決する必要があり、時間がかかり、中央集権型のアプローチよりも多くのメモリを消費します。この問題に対処するため、Tuist は Package Registry の実装を提供しており、実際に必要な コミットのみをダウンロードできます。レジストリ内のパッケージは Swift Package Index に基づいています。そこでパッケージが見つかる場合、そのパッケージは Tuist Registry でも利用可能です。さらに、パッケージはエッジストレージを使用して世界中に分散されており、解決時のレイテンシを最小限に抑えています。
使用方法#
レジストリを設定する方法は2つあります。
オプション1: 生成時の自動設定(推奨)#
Tuist を使用してプロジェクトを生成している場合は、Tuist.swift 構成で registryEnabled オプションを設定することでレジストリを有効にできます。
import ProjectDescription
let tuist = Tuist(
project: .tuist(
generationOptions: .options(
registryEnabled: true
)
)
)
このオプションを使用すると、tuist generate がワークスペース内にレジストリ構成ファイルを自動的に作成します。これにより、tuist registry setup を個別に実行する必要がなくなります。
registryEnabled はまた、Tuist の XcodeProj ベースの統合ではなく、Xcode のデフォルトの Swift Package Manager 統合を通じて依存関係を統合するプロジェクト向けにもレジストリを構成します。ただし、ソース管理 URL で宣言されたパッケージをレジストリから解決するように Xcode を構成するわけではありません。そのためには、ソース管理パッケージの解決 で説明されているように、各マシンで tuist registry setup を一度実行してください。
オプション2: 手動設定#
レジストリを手動で設定するには、プロジェクトのディレクトリで次のコマンドを実行します。
tuist registry setup
このコマンドは、プロジェクトでレジストリを有効にするレジストリ構成ファイルを生成します。チーム全体でレジストリの恩恵を受けられるよう、このファイルをコミットしてください。
認証(任意)#
認証は 任意 です。認証なしでも、IP アドレスあたり 毎分1,000リクエスト のレート制限付きでレジストリを利用できます。毎分20,000リクエスト というより高いレート制限を得るには、以下を実行して認証してください。
tuist registry login
認証には Tuist アカウントとプロジェクト が必要です。
依存関係の解決#
ソース管理ではなくレジストリから依存関係を解決するには、プロジェクトの設定に応じて以下のガイドを参照してください。
- Xcode project
- Generated project with the Xcode package integration
- Generated project with the XcodeProj-based package integration
- Swift package
CI 上でレジストリを設定するには、こちらのガイドに従ってください。継続的インテグレーション
パッケージレジストリ識別子#
Package.swift または Project.swift ファイルでパッケージレジストリ識別子を使用する場合、パッケージの URL をレジストリの規則に変換する必要があります。レジストリ識別子は常に {organization}.{repository} の形式です。例えば、https://github.com/pointfreeco/swift-composable-architecture パッケージのレジストリを使用する場合、パッケージレジストリ識別子は pointfreeco.swift-composable-architecture になります。
識別子にはドットを1つしか含めることができません。リポジトリ名にドットが含まれている場合は、アンダースコアに置き換えられます。例えば、https://github.com/groue/GRDB.swift パッケージのレジストリ識別子は groue.GRDB_swift になります。