Package Manifestで実行可能ターゲットを宣言する

PackageDescription API に、実行可能ターゲットを宣言するための executableTarget を新しく追加します。パラメータは既存の target と同じですが、ターゲットの種類が「実行可能」であることがマニフェスト上で明示されます。

使い方

Package.swift でこれまで .target(...) と書いていたところを、実行可能ターゲットについては .executableTarget(...) に置き換えます。

// swift-tools-version:5.4
import PackageDescription

let package = Package(
    name: "MyTool",
    targets: [
        .executableTarget(
            name: "MyTool",
            dependencies: ["MyLibrary"]
        ),
        .target(
            name: "MyLibrary"
        ),
    ]
)

.executableTarget として宣言したターゲットでは、ソースファイルの名前に依存せずに実行可能モジュールとしてビルドされます。したがって、エントリポイントは main.swift でも、@main を付けた型でも構いません。

// Sources/MyTool/Entry.swift
@main
struct Entry {
    static func main() {
        print("Hello!")
    }
}

内部的には TargetType 列挙型に .executable ケースが追加されますが、マニフェストを書く側から見える変更は executableTarget の追加だけです。

tools-version による振る舞いの違い

swift-tools-version によって、SwiftPM の挙動が次のように変わります。

• tools-version が 5.4 より前の場合: 従来どおり、ターゲットのソースディレクトリ直下に main という名前のソースファイル（main.swift / main.m / main.c / main.cpp）があれば実行可能ターゲットとして扱われます。
• tools-version が 5.4 以降の場合:
  • .executableTarget で宣言されたターゲットは、それだけで実行可能ターゲットとして扱われます。
  • .target で宣言されたターゲットについても、従来どおり main ソースファイルの有無で実行可能かどうかが判定されますが、そう判定された場合には「.executableTarget に書き換えるべき」という警告が出ます（可能なら fix-it 付き）。

1 つのパッケージグラフ内に新旧の tools-version が混在していても問題はなく、各ターゲットの実行可能性はそれを宣言しているパッケージの tools-version に従って判定されます。

将来の tools-version では、この警告はエラー相当の扱いになり、.target で宣言されたターゲットはすべてライブラリターゲットとみなされるようになる予定です。

なお、コンパイラに渡すフラグ自体は従来と同じで、ライブラリターゲットには -parse-as-library が付き、実行可能ターゲットには付きません。main.swift が実行可能モジュールのエントリポイントとして解釈される挙動もそのまま維持されます。また、Swift モジュール全般のルールとして、1 つの実行可能モジュールに @main と main.swift の両方のエントリポイントを同居させることはできません。