SPM ビルド分析

パッケージ構造、プラグイン、または依存設定が Xcode のビルド遅延の原因になっていると思われる場合に、このスキルを使用します。

コアルール

• パッケージ分析は、依存関係を置き換えるマンデートではなく、まず証拠収集として扱う。
• パッケージグラフの問題とプロジェクト設定の問題を分離する。
• 明示的な承認がない限り、パッケージマニフェストや依存関係のソースを書き直さない。

検査対象

• Package.swift と Package.resolved
• ローカルパッケージと リモートパッケージ
• パッケージプラグインとビルドツールの使用
• バイナリターゲットのフットプリント
• 依存関係のレイヤリング、重複インポート、および潜在的な循環参照
• パッケージ関連の処理を示すビルドログまたはタイミングサマリー

推奨する前の確認

推奨事項にローカルパッケージを含める前に、それがプロジェクトの依存グラフに実際に含まれていることを確認します。Vendor/ ディレクトリに含まれるパッケージが、ターゲットにリンクされていない場合があります。

• project.pbxproj で、パッケージパスを参照する XCLocalSwiftPackageReference エントリをチェックします。
• XCSwiftPackageProductDependency エントリをチェックして、パッケージのプロダクトが少なくとも 1 つのターゲットにリンクされていることを確認します。
• ローカルパッケージがディスク上に存在するが、プロジェクトで参照されていない場合は、ビルド時間の推奨事項に含めないでください。

ブランチ追跡依存関係のバージョンピンを推奨する場合:

• ヘルパースクリプトを使用して、ブランチピンされたすべての依存関係を一度にスキャンします:

  python3 scripts/check_spm_pins.py --project App.xcodeproj
  

  このコマンドは各ブランチピンパッケージに対して git ls-remote --tags をチェックし、ピンに使用できるタグがあるパッケージを報告します。
• タグが存在しない場合は、決定論性のために特定のコミットリビジョンハッシュへのピンを推奨する代わりに使用します。
• アップストリームに単純にタグがないためにブランチピンされているパッケージと、タグがあるがブランチを意図的に追跡しているパッケージを区別します。

焦点領域

• パッケージグラフの形状と変更がどれだけダウンストリームの処理をトリガーするか
• ローカル開発と CI 中のプラグインオーバーヘッド
• クリーン環境で表示されるチェックアウトまたはフェッチコストの信号
• 重複モジュールビルドを強制する設定ドリフト
• 依存関係を共有しながら異なるマクロやオプションを使用するパッケージターゲットからのリスク
• 機能が互いに依存するのではなく共有下位レイヤーに依存する依存関係の方向違反
• モジュール間の循環依存関係 (共有コントラクトをプロトコルモジュールに抽出)
• 増分リビルドのスコープを広げる大規模モジュール (200+ ファイル)
• @_exported import を使用するアンブレラモジュールが隠れた依存チェーンを作成
• ビルド並列化をブロックするインターフェース/実装分離の欠落
• テストターゲットが、テスト対象のモジュールではなくアプリターゲットに依存している
• Swift マクロリビルドカスケード: Swift マクロの多用 (例: TCA、swift-syntax ベースのライブラリ) により、些細なソースコード変更がマクロ展開によってダウンストリームモジュールを無効化し、ほぼフルリビルドにカスケードする
• swift-syntax がプリビルトバイナリがない場合にユニバーサルビルド (すべてのアーキテクチャ) を行い、クリーンビルドオーバーヘッドを大きく追加する
• マルチプラットフォームビルド乗算: セカンダリプラットフォームターゲット (例: watchOS) を追加すると、共有 SPM パッケージが複数回ビルドされる可能性があり (例: iOS arm64、iOS x86_64、watchOS arm64)、SwiftCompile、SwiftEmitModule、および ScanDependencies タスクが増加する

モジュール型 SDK 移行の注意点

依存関係をモノリシックターゲットからモジュール型マルチターゲット SDK に移行する場合 (例えば、1 つのアンブレラライブラリを分離した Core、RUM、Logs、Trace モジュールに置き換える)、ビルド時間は自動的には短縮されません。モジュール型ターゲットは、各ターゲットが独立してコンパイル、スキャン、およびモジュール発行される必要があるため、SwiftCompile、SwiftEmitModule、および ScanDependencies タスク数を増加させます。ビルド時間のトレードオフは、プロジェクトの並列化ヘッドルームと、実際に必要なモジュール型ターゲット数に依存します。

モジュール型 SDK 移行を検討する場合:

• 移行前後の合計 SwiftCompile タスク数を比較します。
• ビルド速度の移行を推奨する前に、両方の設定をベンチマークします。
• 動機が API サーフェス削減 (使用するもののみをインポート) の場合、ビルド時間は横ばいまたは増加する可能性がありますが、インポートの衛生が改善されることに注意してください。
• プロジェクトが使用していないモノリシック SDK の大部分を現在コンパイルしており、モジュール型代替案がそれらの未使用部分を完全にスキップできる場合のみ、ビルド速度のモジュール型 SDK 移行を推奨してください。

明示的モジュール依存関係の視点

同じモジュールがタイミング出力に複数回表示される場合は、異なるパッケージまたはターゲットのオプションが追加のモジュールバリアントを強制しているかどうかを調査します。均一なオプションは、少量のソースコードを削減することより重要なことがよくあります。

レポート形式

各検出事項について、以下を含めます:

• 証拠
• 影響を受けるパッケージまたはプラグイン
• クリーンビルド対増分ビルドへの可能性のある影響
• 関連する場合は CI への影響
• 推定される影響
• 承認要件

主な問題がパッケージ関連でない場合は、対象スキルの SKILL.md を読み、同じプロジェクトコンテキストにそのワークフローを適用することで、xcode-project-analyzer または xcode-compilation-analyzer に引き継ぎます。

追加リソース

• 詳細な監査チェックリストは、references/spm-analysis-checks.md を参照してください
• 共有推奨フォーマットは、references/recommendation-format.md を参照してください
• ソース引用は、references/build-optimization-sources.md を参照してください