ナビゲーションの状態を保存、管理する

以降のセクションでは、バックスタックを保存し、バックスタックのエントリに関連付けられた状態を保存するための戦略について説明します。

バックスタックを保存する

構成の変更やプロセスの終了など、さまざまなライフサイクル イベントでアプリのナビゲーション状態が維持されるようにすることは、優れたユーザー エクスペリエンスを実現するうえで非常に重要です。Navigation 3 では、バックスタックを所有しているため、バックスタックの作成方法や保存方法に関する厳格なガイドラインはありません。ただし、Navigation 3 には、保存可能なバックスタックを提供する便利なメソッド rememberNavBackStack が用意されています。

rememberNavBackStack

rememberNavBackStack コンポーザブル関数は、構成の変更やプロセスの終了後も保持されるバックスタックを作成するように設計されています。

rememberNavBackStack が正しく機能するには、バックスタック内の各キーが特定の要件を満たしている必要があります。

  • NavKey インターフェースを実装する: バックスタック内のすべてのキーは NavKey インターフェースを実装する必要があります。これは、キーを保存できることをライブラリに通知するマーカー インターフェースとして機能します。
  • @Serializable アノテーションがある: NavKey の実装に加えて、キー クラスとオブジェクトに @Serializable アノテーションを付ける必要があります。

次のスニペットは、rememberNavBackStack の正しい実装を示しています。

@Serializable
data object Home : NavKey

@Composable
fun NavBackStack() {
    val backStack = rememberNavBackStack(Home)
}
SavingStateSnippets.kt

代替: ViewModel に保存する

バックスタックを管理するもう 1 つの方法は、ViewModel に保存することです。ViewModel または他のカスタム ストレージを使用しているときに、プロセスの終了後もデータを保持するには、次の操作を行う必要があります。

  • キーがシリアル化可能であることを確認する: rememberNavBackStack と同様に、ナビゲーション キーはシリアル化可能である必要があります。
  • シリアル化と逆シリアル化を手動で処理する: 各キーのシリアル化された表現を永続ストレージ（SharedPreferences、データベース、ファイルなど）を保存します。

ViewModel 秒から NavEntry 秒までをスコープ設定する

ViewModels は、画面の回転などの構成変更後も UI 関連の状態を維持するために使用されます。デフォルトでは、ViewModels は最も近い ViewModelStoreOwner にスコープ設定されます。通常は Activity または Fragment です。

ただし、Activity 全体ではなく、バックスタック上の特定の NavEntry（特定の画面やデスティネーションなど）に ViewModel をスコープ設定したい場合もあります。これにより、ViewModel の状態は、その特定の NavEntry がバックスタックの一部である間のみ保持され、NavEntry がポップされるとクリアされます。

androidx.lifecycle:lifecycle-viewmodel-navigation3 アドオン ライブラリには、これを容易にする NavEntryDecorator が用意されています。このデコレータは、各 NavEntry に ViewModelStoreOwner を提供します。NavEntry のコンテンツ内に ViewModel を作成すると（Compose で viewModel() を使用するなど）、その特定の NavEntry のバックスタックのキーに自動的にスコープ設定されます。つまり、NavEntry がバックスタックに追加されると ViewModel が作成され、削除されるとクリアされます。

NavEntryDecorator を使用して ViewModel を NavEntry にスコープ設定する手順は次のとおりです。

  1. androidx.lifecycle:lifecycle-viewmodel-navigation3 依存関係を app/build.gradle.kts ファイルに追加します。
  2. NavDisplay を作成するときに、rememberSaveableStateHolderNavEntryDecorator() を entryDecorators のリストに追加します。
  3. NavDisplay に他のデコレータを追加します。

NavDisplay(
    entryDecorators = listOf(
        // Add the default decorators for managing scenes and saving state
        rememberSaveableStateHolderNavEntryDecorator(),
        // Then add the view model store decorator
        rememberViewModelStoreNavEntryDecorator()
    ),
    backStack = backStack,
    entryProvider = entryProvider { },
)
SavingStateSnippets.kt