@Observableから移行で、計算プロパティが自動更新に「Swift State Graph」
- 公開
- 正式公開 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 部品 | 過去のメッセージを読み込んでもスクロール位置が飛ばないチャット UI | iOS(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 する必要があります。