Zenn
🧭

Jetpack Compose Navigation で実現する型安全なルーティング

2025/02/21に公開
1

Jetpack Compose では、従来の文字列ベースのパス指定によるナビゲーションから一歩進んだ、型安全なナビゲーションが可能になりました。この記事では、型安全なナビゲーションの実装方法とそのメリットについて紹介します。

2025/02/25 追記

今回の方法では String や Int などのプリミティブ型しかサポートしていないため、カスタムオブジェクトを直接渡すことはできません。もしカスタムオブジェクトを渡したい場合は json string に一度変換して受け側でオブジェクトに再度変換する必要があります。

はじめに

従来の Android アプリケーションにおけるナビゲーション実装は、値を次の画面に渡したい時 URL のような文字列パスを組み立てたり、パラメータを埋め込んだりする必要がありました。
例えば、以下のようなコードが一般的でした:

// 従来の例: 文字列でパスを作成して遷移する方法
navController.navigate("profile/123")

この方法はシンプルですが、パラメータの型チェックがコンパイル時に行われず、誤ったパラメータやパスの組み立てミスによる実行時エラーが発生するリスクがありました。


型安全なナビゲーションの実装例

以下は、型安全なルート定義と値の受け渡しを実現するコード例です。
この例では、@Serializable アノテーションを用いることで、シリアライズ可能なオブジェクトをルートとして扱います。

// ホーム画面のルート(引数なし)
@Serializable
object Home

// プロフィール画面のルート(IDを引数として持つ)
@Serializable
data class Profile(val id: String)
NavHost(navController, startDestination = Home) {
    composable<Home> {
        HomeScreen(onNavigateToProfile = { id ->
            // 型安全な Profile オブジェクトを生成して遷移
            navController.navigate(Profile(id))
        })
    }
    composable<Profile> { backStackEntry ->
        // バックスタックから型に応じたルート情報を取得
        val profile: Profile = backStackEntry.toRoute()
        ProfileScreen(profile.id)
    }
}
// 遷移の際は、Profile オブジェクトを直接渡す
navController.navigate(Profile(id = "123"))

この実装のポイント

  • 型安全性の確保
    ルートをオブジェクトやデータクラスとして定義することで、コンパイル時に型チェックが行われます。
    パラメータの不一致や誤った型の値を渡すとコンパイルエラーとなるため、実行時の不具合を防止できます。

  • 可読性の向上
    ルートが明確な型として定義されるため、どの画面にどのパラメータが必要かがひと目で分かります。
    これにより、コードの保守性や拡張性が向上します。

  • シリアライズ対応
    @Serializable を利用することで、必要に応じて値のシリアライズ・デシリアライズが自動的に行われます。
    例えば、アプリの状態保存や復元の際にも便利です。

注意点

この機能は androidx.navigation:navigation-compose:2.8.0 から使用できます。


型安全なナビゲーションのメリット

従来の文字列ベースのナビゲーションと比較して、型安全なナビゲーションには以下のメリットがあります。

  1. コンパイル時の検証

    • パラメータの型や存在がチェックされるため、実行時エラーのリスクが低減されます。
  2. リファクタリングが容易

    • 型が定義されているため、名前や構造の変更があっても IDE のサポートを受けながら安全にリファクタリングできます。
  3. コードの可読性向上

    • ルートごとに必要なパラメータが明示されるため、他の開発者がコードを読んだ際にも意図が理解しやすくなります。
  4. シリアライズとの統合

    • シリアライズ可能なルート定義により、状態管理やデータの永続化が容易になります。

まとめ

Jetpack Compose のナビゲーションにおける型安全なルーティングは、従来の文字列パスを用いた方法に比べて、コンパイル時チェック、リファクタリングの容易さ、コードの可読性向上など、さまざまな面でメリットがあります。
ぜひこの手法をプロジェクトに取り入れ、より堅牢でメンテナンスしやすいコードベースを実現してください。


この記事が、あなたのアプリケーション開発の参考になれば幸いです。
皆さんのプロジェクトでの活用事例やご意見をお待ちしております!

Happy Coding!


以下の記事を参考にこの記事を作成しました。
https://developer.android.com/guide/navigation/design/type-safety

1

Discussion

ログインするとコメントできます