@Observableから移行で、計算プロパティが自動更新に「Swift State Graph」

Swift State Graph
SwiftUI と UIKit の状態を、依存関係を自動で追うグラフで管理する Swift ライブラリ
GitHub
公開
正式公開 2025-02-14
作り手
VergeGroup(チーム)
対応
iOS・Mac
言語
Swift
価格
無料(OSS。GitHub の表示は Apache-2.0、README は MIT License)
評価
GitHub のスター 68(2026-10-23)

どんなアプリか

Swift State Graph は、SwiftUI と UIKit のアプリで使う、グラフ型の状態管理ライブラリです。アプリの外側に持つ状態を扱うためのもので、React や Jotai、Recoil の考え方を参考にしています。

A graph-based reactive state management library for Swift. For managing external(escaping) state, inspired by the concepts of React, Jotai and Recoil.

VergeGroup、GitHub の README

値を持つプロパティには @GraphStored を、ほかの値から計算されるプロパティには @GraphComputed を付けます。計算されるプロパティは依存している値を自動で追い、元の値が変わると更新されます。再計算は必要になったときに行われ、結果は無効になるまでキャッシュされます。

README によると、SwiftUI ではビューの中でプロパティをそのまま使えば変化が反映され、UIKit では withGraphTracking で変化を受け取ります。@Observable から移行して、計算されるプロパティの自動更新を使えるようにする道筋も示されており、値を UserDefaults に保存する @GraphUserDefault もあります。

料金とデータの置き場所

GitHub で公開されているオープンソースのライブラリです。ライセンスは、GitHub のリポジトリの表示では Apache-2.0、README の License の項では MIT License と書かれており、表記がそろっていません。

同じ分野のアプリ

名前型仕掛け対応料金
Swift State Graph状態管理依存関係を自動で追うグラフ型の状態管理。@Observable 互換iOS・Mac(Swift パッケージ)無料(OSS)
MessagingUI(swiftui-messaging-ui)UI 部品過去のメッセージを読み込んでもスクロール位置が飛ばないチャット UIiOS(Swift Package)無料(OSS, Apache-2.0)
swift-readability本文抽出Mozilla の readability をラップし、Web ページの本文を抽出Swift パッケージ無料(OSS, MIT)
WorkKit文書の読み取りPages・Numbers・Keynote の文書を開いて中身を取り出すSwift Package無料(OSS, AGPL-3.0)

入れる前に

動かすには Swift 6.0 以上と、iOS 17 以上または macOS 14 以上が必要です。Package.swift の dependencies に追加して導入します。

StateGraph と StateGraphNormalization は動的ライブラリとして配られています。ひとつのプロセスで読み込む StateGraph の実行部分はひとつでなければならず、アプリのターゲットで組み込み、依存するフレームワークでは追加のコピーを組み込まずにリンクする形になります。

StateGraphNormalization は StateGraph を再エクスポートしないため、両方を使うターゲットでは二つを明示的に依存先に加え、import する必要があります。