パッケージマネージャの条件付きプラグイン

Target.PluginUsage に、新しい PluginUsageCondition 型を使ったオプショナルな condition パラメータを追加します。この条件で、プラグインを適用するホストプラットフォーム・ターゲットプラットフォーム・有効なトレイトをそれぞれ独立に制約できます。

.executableTarget(
    name: "MyTool",
    plugins: [
        .plugin(
            name: "SwiftLintBuildToolPlugin",
            package: "SwiftLintPlugins",
            condition: .when(hostPlatforms: [.macOS])
        ),
    ]
)

これで、先ほどの SwiftLint の例のように「macOS でのみプラグインを適用する」ことをマニフェスト上で宣言的に表現できます。

ホストとターゲットを別軸で指定する

プラグインには「ホスト上で動作し、ターゲット向けの出力を生成する」という二面性があります。SE-0387 の定義では、ホストはコードをビルドするマシン、ターゲットはコードが動作するマシンを指します。そのため条件も両者を別々のパラメータで指定します。

• hostPlatforms: はプラグインが動作するホストを制約します（例: macOS 専用バイナリに依存するプラグイン）。
• targetPlatforms: はプラグインの出力が有効なターゲットを制約します（例: Apple プラットフォームでしかコンパイルできない Metal シェーダのコード生成器）。

.plugin(
    name: "MetalShaderGenerator",
    package: "MetalShaderGenerator",
    condition: .when(targetPlatforms: [.macOS, .iOS, .tvOS, .visionOS])
)

トレイトで指定する

SE-0450 のトレイトを使って、プラグインをトレイトで条件付けることもできます。

.plugin(
    name: "SwiftLintBuildToolPlugin",
    package: "SwiftLintPlugins",
    condition: .when(traits: ["Lint"])
)

こうすると、すべてのビルド・すべてのプラットフォームでプラグインを走らせることなく、swift build --traits Lint でリンターを有効化する、といった opt-in の運用ができます。

フィルタの合成規則

各フィルタは独立しており、条件は「指定したすべてのフィルタが一致したとき」にのみ満たされます。指定しなかった軸には制約がかかりません。when(hostPlatforms:targetPlatforms:traits:) は、少なくとも 1 つの引数を指定する必要があります。

public struct PluginUsageCondition: Sendable {
    public static func when(
        hostPlatforms: [Platform]? = nil,
        targetPlatforms: [Platform]? = nil,
        traits: Set<String>? = nil
    ) -> PluginUsageCondition
}

PluginUsageCondition は BuildSettingCondition（SE-0238）にならい、オプショナル引数を持つ単一のファクトリメソッドを公開する形にしています。これにより、将来フィルタの軸が増えてもオーバーロードが組み合わせ的に増えるのを避けられます。

ビルド計画時の挙動

SwiftPM がビルドを計画し、条件付きのプラグイン利用に出会ったときの挙動は次のとおりです。

• 条件の評価: hostPlatforms はホストプラットフォームに、targetPlatforms はターゲットプラットフォーム（クロスコンパイルでない場合はホストと同じ）に、traits は有効なトレイトの集合に対して照合されます。
• プラグインのスキップ: 条件を満たさない場合、そのプラグインは実行されません。プラグインの prebuild／build コマンドはビルドグラフに追加されません。
• 依存解決は変わらない: 条件を満たさない場合でも、プラグインのパッケージ依存自体は SE-0273 と同様に解決・取得されます。これは依存解決にホスト固有のロジックを持ち込まないための設計です。
• バイナリ artifact の扱い: プラグインが現在のプラットフォーム向けに存在しないバイナリ artifact を使っていても、条件でそのプラットフォームが除外されていれば、SwiftPM はエラーを出しません。この提案がない状態では、使われないはずのバイナリが原因でビルドが失敗しえます。

この変更は additive で、condition を指定しない既存のプラグイン利用はこれまでどおり動作します。新しいAPIは新しいtools versionでゲートされます。Package.swift で #if os(...) を使っていたパッケージは、この新APIへ移行することで、よりクリーンで宣言的なマニフェストに書き換えられます。