独占リモート Mac で Swift 6 を移行：厳格並行 CI ゲートと Actor 分離 Runbook

Swift 6 厳格並行チェック（-strict-concurrency=complete）が出すエラー数はコードベース規模に比例します。中規模 iOS プロジェクトで初回有効化時に 200〜800 件のコンパイルエラーが出ることも珍しくありません。修正は数週間から数ヶ月に及ぶため、その間 CI 環境は次を保証する必要があります：

• Xcode マイナーバージョンの固定：Actor isolation の診断文言は Xcode バージョンで変わるため、固定して初めて CI 出力を比較できます。
• 隣接テナントとの CPU 争奪なし：厳格並行のフルコンパイルは通常の debug ビルドより 20〜40% 長くなります。独占ノードで P95 テールレイテンシの暴騰を防ぎます。
• DerivedData の名前空間分離：複数 PR が並行チェックを同時実行する場合、増分キャッシュを分けないと結果が信頼できません。

Swift には 3 段階のコンパイラフラグがあり、OTHER_SWIFT_FLAGS（Xcode Build Settings）または Package.swift の swiftSettings で設定できます：

実務ではモジュール単位で段階的に進めるのがおすすめです。依存の少ないリーフモジュールから complete を有効にし、コアモジュールへ進めます。SwiftPM の .enableUpcomingFeature("StrictConcurrency") で target ごとのレベルを精密に制御できます。

移行期のコンパイルエラーの約 90% は次の 3 類に集中します。これらを先に片付けると赤文字の大半が消えます：

① Actor 越しの非 Sendable 型アクセス

// ❌ エラー: @MainActor 外から @MainActor 隔離状態へアクセス
actor DataFetcher {
    func load() async {
        let result = await networkClient.fetch()
        // ❌ passing argument of non-sendable type 'UserModel' across actor boundary
        await MainActor.run { viewModel.update(result) }
    }
}

修正：UserModel を Sendable に準拠させる（値型は多くの場合自動）、または境界を越える変換を Actor 内で完了させます。

② @MainActor の付け忘れ

UIKit/SwiftUI の ViewController、ObservableObject サブクラスは移行前は暗黙にメインスレッドでした。Swift 6 では明示的な @MainActor が必要です。Xcode の「Fix」で一括修正できますが、UI 以外のロジックまで引き込まないよう各箇所を review してください。

③ グローバル変数への並行アクセス

// ❌ Swift 6 ではグローバルは Sendable または nonisolated が必要
var sharedCache: NSCache<NSString, AnyObject> = .init()

// ✅ 移行期は nonisolated(unsafe) で明示
nonisolated(unsafe) var sharedCache: NSCache<NSString, AnyObject> = .init()

// ✅ 推奨: Actor に包み async API で公開
actor CacheStore {
    private let cache = NSCache<NSString, AnyObject>()
    func object(forKey key: String) -> AnyObject? { cache.object(forKey: key as NSString) }
}

PR ゲートに厳格並行チェックを組み込む要点：通常テスト Job とは別 Job で並行チェックを実行する。NUKCLOUD では 料金ページでディスクとリージョンを選び、注文ページで SSH と Runner 基線を受け取ってください。

name: Swift 6 Concurrency Gate

on:
  pull_request:
    branches: [main, release/*]

jobs:
  concurrency-check:
    runs-on: self-hosted          # NUKCLOUD 専用リモート Mac Runner
    timeout-minutes: 30
    steps:
      - uses: actions/checkout@v4

      - name: Xcode を選択（マイナーバージョン固定）
        run: sudo xcode-select -s /Applications/Xcode_16.3.app

      - name: Restore DerivedData cache
        uses: actions/cache@v4
        with:
          path: ~/DerivedData/swift6-check
          key: swift6-${{ runner.name }}-${{ hashFiles('**/*.xcodeproj/project.pbxproj', '**/Package.resolved') }}
          restore-keys: swift6-${{ runner.name }}-

      - name: Build with strict concurrency (complete)
        run: |
          xcodebuild build \
            -project MyApp.xcodeproj \
            -scheme MyApp \
            -destination 'generic/platform=iOS Simulator' \
            -derivedDataPath ~/DerivedData/swift6-check \
            OTHER_SWIFT_FLAGS="-strict-concurrency=complete" \
            | xcbeautify --renderer github-actions

      - name: Upload build log on failure
        if: failure()
        uses: actions/upload-artifact@v4
        with:
          name: swift6-build-log-${{ github.sha }}
          path: ~/DerivedData/swift6-check/Logs/Build/

1. 01
   ベースラインスナップショット：独占リモート Mac で -strict-concurrency=minimal のフルビルドを 1 回実行し、エラー数とコンパイル時間を記録して移行起点の定量基準にします。
2. 02
   リーフモジュール先行：SwiftPM 依存グラフから下流依存のない target を選び、complete を 1 つずつ有効化。target ごとに別 PR を出し、diff をレビュー可能に保ちます。
3. 03
   CI ブランチ戦略：Git の feature/swift6-migration 長期ブランチで並行チェック Job を warn-only（continue-on-error: true）にし、日常 PR のマージは阻害しません。モジュールが 0 エラーになった時点でのみ、そのモジュールのチェックを block-merge ゲートへ昇格させます。
4. 04
   Xcode バージョンの固定：xcode-select のバージョンを Runbook と README に記載し、ローカル Mac 開発者と CI ノードが同一マイナーバージョンを使い、「ローカルは通るが CI は落ちる」ノイズを防ぎます。
5. 05
   エラー推移ダッシュボード：各 CI 実行の Swift 6 エラー数を構造化ログまたは Build Metrics に記録し、折れ線で移行進捗を追跡。チームに「今週 X 件減らす」週次目標を設定します。
6. 06
   フルゲート受け入れ：全モジュールが 0 エラーになったら、main の Branch Protection で「Require swift6-concurrency-check to pass」を有効化し、全 target の Build Settings に SWIFT_VERSION = 6 を書き込み、正式に Swift 6 言語モードへ切り替えます。

Swift 6 移行期は開発者のローカル高速試行とCI のフル量信頼検証の両方が必要で、ノード要件は異なります：