AI Development

2026 Swift 6.2 SwiftData:並行処理リファクタリングを段階的に進めるには?

2026 Swift 6.2 SwiftData:並行処理リファクタリングを段階的に進めるには?

ビルドは通ったのに、画面操作が重くなり、SwiftDataの保存処理が戻ってこない状態です。

最短の解決策は、プロジェクト全体へ@MainActorを付けることでも、@unchecked Sendableで警告を消すことでもありません。Swift 6.2のツールチェーンと再現条件を固定し、最も危険な書き込み経路だけを@ModelActorへ閉じ込め、PersistentIdentifierまたはSendableなDTOで境界を越えます。

この手順は、Swift 6.2のブランチを維持しながらSwiftDataを改修する開発者向けです。データアクセス境界を分割するアーキテクト、複数ブランチを独立したMac環境で検証したい技術責任者にも適しています。

失敗した全体適用とツールチェーンの前提

最初に避けたいのは、コンパイル診断を止めるために全モデルとサービスへ@MainActorを追加する改修です。コンパイルは進んでも、インポートや保存までメインアクターに集中し、操作中の画面が止まることがあります。これは「コンパイルできた」だけで、データ層の所有権が整理されたことを意味しません。

バージョンの前提も修正が必要です。公式リリースノートでは、Xcode 26の初期版にSwift 6.2が含まれ、Xcode 26.6にはSwift 6.3が含まれています。したがって本稿は、現在の最新版を説明する記事ではなく、Swift 6.2を固定した保守ブランチの移行手順です。Xcode 18を前提に作業するのではなく、各ターゲットのSwift言語モードを確認します。

AppleのXcode 26リリースノートを基準に、次の状態を保存します。

  • ターゲットごとのSwift言語モード
  • Strict Concurrency Checkingの設定
  • デフォルトアクター分離の設定
  • 再現できる最小テスト
  • 保存前後のログ、スレッド情報、旧ブランチ

デフォルトアクター分離はプロジェクト全体に自動適用される前提ではありません。ターゲットや設定によって挙動が変わるため、設定値を記録せずに警告数だけ比較すると、後で修正効果を判定できなくなります。アクター分離の扱いは、Swift Evolutionのデフォルトアクター分離提案とも照合します。

最初の1時間で行う所有権の切り分け

最初から全機能を追いません。新規作成、更新、バッチインポートのうち、最も頻繁に失敗する1本だけを選びます。そこにModelContainer、ModelContext、UI状態、バックグラウンドタスクの所有者を書き込みます。

特に次の値がアクター境界を越えていないかを確認します。

  • @Modelのインスタンス
  • 別のコンテキスト
  • @Sendableクロージャー
  • 保存完了を待つための同期キューやセマフォ
  • ライフサイクルから外れたTask

ここで、診断を4種類に分けます。コンパイラーの型検査失敗、アクター分離違反、メインスレッドのブロック、実際に進行しない循環待機は同じ問題ではありません。画面が固まっただけでSwiftData内部のデッドロックと断定せず、スレッドサンプリングと呼び出し履歴で確認します。

SwiftDataのデータ層はどの呼び出し経路から直すべきですか。

読み取り中心の画面より、複数箇所から呼ばれる書き込み経路を先に選びます。保存、更新、関連オブジェクトの追加が同じコンテキストに集まる経路なら、所有権の漏れを観察しやすく、変更範囲も限定できます。

最初のコミットで作る書き込み境界

最初のコミットでは、汎用的なデータサービスを作りません。選んだ書き込み処理だけを担当する、責務の小さい@ModelActorを導入します。ModelActorはモデル属性への排他的なアクセスを整理できますが、すべての画面停止を自動修復するマクロではありません。公開仕様はAppleのModelActorドキュメントで確認します。

@ModelActor
actor ImportStore {
    func saveRecord(
        id: PersistentIdentifier?,
        title: String
    ) throws -> PersistentIdentifier {
        let record: Record

        if let id {
            guard let existing = modelContext.model(for: id) as? Record else {
                throw ImportError.notFound
            }
            record = existing
        } else {
            record = Record(title: title)
            modelContext.insert(record)
        }

        record.title = title
        try modelContext.save()
        return record.persistentModelID
    }
}

実際のモデル名や初期化方法はプロジェクトに合わせます。重要なのは、呼び出し側が別コンテキストで管理しているRecordを、そのままアクターへ渡さないことです。アクター内部で取得、変更、保存を完了させます。

依存性注入では、画面やViewModelにModelContextを直接持たせず、ImportStoreのプロトコルまたは具体的なインスタンスを渡します。これにより、旧実装と新実装を切り替える入口も残せます。

当日に置き換える入力と出力の契約

@ModelActorはモデルオブジェクトを返すべきですか。

通常は返さず、PersistentIdentifier、不変の値型、または明示的にSendableへ適合したDTOを返します。PersistentIdentifierは、受け取り側が自分のModelContextで再取得するための識別子です。公開されている型の意味は、PersistentIdentifierの公式ドキュメントで確認できます。

struct RecordSummary: Sendable {
    let id: PersistentIdentifier
    let title: String
}

func loadSummary(id: PersistentIdentifier) throws -> RecordSummary {
    guard let record = modelContext.model(for: id) as? Record else {
        throw ImportError.notFound
    }
    return RecordSummary(id: id, title: record.title)
}

UI側が必要とするのが表示名と識別子だけなら、DTOで十分です。バックグラウンド側のモデルをUIへ持ち帰る設計にすると、受け取り側のコンテキスト所有権が曖昧になります。

エラー、キャンセル、保存結果はasync throwsと構造化されたタスクで扱います。セマフォ、同期キューへの戻り、ライフサイクルから外れたTaskは、警告を消しても待機関係を複雑にします。

注意:バックグラウンド書き込みを避けるために、すべてをメインアクターへ戻す方法は移行完了ではありません。メインスレッドのブロックを確認した場合は、まず呼び出し履歴とサンプリング結果を保存してください。

SwiftDataのバックグラウンド保存で、モデルをメインアクターへ渡さない方法はありますか。

あります。書き込みアクターから識別子またはDTOだけを返し、画面側は自身のコンテキストで表示用データを取得します。モデルを直接返す必要がある設計なら、なぜその所有権移動が必要なのかを契約として明文化し、安易な@unchecked Sendableでは補いません。

移行範囲を選ぶ比較表

老朽化した全データ層を一度に変更する方法は、差分が大きく、失敗時の原因も追いにくくなります。最初の対象は、書き込み頻度、影響範囲、ロールバックの容易さで決めます。

移行単位 境界の作り方 利点 欠点 採用条件
プロジェクト全体 全サービスを同時変更 設計を統一しやすい 差分と回帰範囲が大きい 全面停止できる期間がある場合
1ターゲット 対象ターゲット内だけ変更 ビルドと検証を分離しやすい 共有モジュールの調整が必要 ターゲット間の依存が明確な場合
1データモジュール 1本の書き込み経路を@ModelActor化 失敗原因を追いやすい 一時的に旧実装が残る 継続開発中の旧プロジェクト
1画面の機能 UIから呼ぶ契約だけ変更 影響を限定できる データ所有権が分散しやすい 機能単位でテストがある場合

老朽化したプロジェクトは、1ターゲットまたは1データモジュールだけ移行できますか。

できます。むしろ継続納品中なら、その単位が安全です。ただし、共有のModelContainerや共通モデルを境界の外へ持ち出さないことが条件です。移行対象を固定し、旧実装との切り替え点を1か所に置きます。

最初の週に進める呼び出し経路

1回のコミットで変えるのは、観測可能な境界1つです。移行対象の書き込み経路が通ったら、次は呼び出し元を頻度と障害影響で並べます。各段階でコンパイル結果、保存結果、キャンセル時の挙動を記録します。

監査対象は次のとおりです。

  • @unchecked Sendable
  • @preconcurrency
  • Task.detached
  • 範囲を広げた@MainActor
  • 同期的な待機処理
  • 第三者モジュールを包む互換レイヤー

@unchecked Sendableは、コンパイラーに安全性を確認させない宣言です。@preconcurrencyも移行を先送りするための互換手段であり、恒久的なデータ境界ではありません。残す場合は、対象モジュール、理由、削除条件を記録します。未対応の依存ライブラリがある場合も、互換コードをモジュールの端に閉じ込め、業務モデルへ広げません。

並行リファクタリング中に旧実装をロールバック経路として残せますか。

残せます。新旧を切り替えるファクトリーや依存性注入の入口を残し、UIの各所に条件分岐を散らさないことが要点です。新実装が保存結果、キャンセル、再取得のいずれかで不安定なら、その入口で旧実装へ戻します。切り替え条件は「念のため」ではなく、ログや再現テストと結び付けます。

公開前の二つのツールチェーン検証

最後に、固定データセットで連続書き込み、キャンセル、バックグラウンド復帰、複数ウインドウ、拡張機能からの同時アクセスを確認します。各ケースで、クラッシュログ、ハング時のサンプリング、テスト結果、保存後の件数と識別子を記録します。

Swift 6.2を使う現在の納品ツールチェーンと、アップグレード予定のツールチェーンを分けて実行します。Derived Data、シミュレーター状態、単一の開発機だけが原因になっていないかを確認するためです。Swiftの非同期関数における分離規則は、async関数の分離に関するSwift Evolution提案とも照合します。

最初の経路について、次の証拠がそろうまで他のモジュールへ複製しません。

  • Swift 6.2設定で診断が解消している
  • メインスレッドを不要に待たせていない
  • キャンセル後に保存処理が残らない
  • 別コンテキストで再取得できる
  • 新旧実装を切り替えて同じデータ整合性を確認できる

独立したMac環境で旧ブランチと新ブランチを並行検証する場合は、ProxyMacのヘルプで利用条件を確認し、検証用の接続手順を分けて管理します。実行中の環境を確認する必要がある場合は、ProxyMacのコンソールを使い、ローカルのキャッシュやシミュレーター状態と混同しない記録を残します。

自宅のMacだけで進める場合、複数のXcode系統を切り替えるたびに、ストレージ消費、SDK差分、再インストール時間、開発機の占有が問題になります。長期的な重いビルドや物理デバイス接続が中心なら、自前環境の方が適しています。一方、旧ブランチと新ブランチを短期間だけ分離し、Swift 6.2の回帰確認を独立環境で行うなら、ProxyMacのMacレンタルを使う方が、開発機の状態を巻き込まずに検証しやすい構成です。

まずは1本の@ModelActor経路で、診断、活性、データ整合性の証拠をそろえます。その後に複数環境を用意する必要が生じた段階で、ProxyMacの利用条件やプランを確認し、旧実装を残したまま安全に次のモジュールへ進みます。

SwiftDataの並行処理改修を、ProxyMacの専用Macで着実に進めませんか?

ProxyMacなら、Apple Silicon M4を搭載した専用Mac環境でSwift 6.2プロジェクトを検証できます。
ModelActorやSendable DTOへの段階的な移行を、実際のmacOS環境で確認できます。