Navigation简析

最新推荐文章于 2025-04-07 17:26:42 发布

彬_小彬

最新推荐文章于 2025-04-07 17:26:42 发布

阅读量2.9k

点赞数 22

分类专栏： Android Jetpack 文章标签： android Jetpack Navigation

本文链接：https://blog.csdn.net/github_35942716/article/details/140677222

版权

Android 同时被 2 个专栏收录

93 篇文章

订阅专栏

Jetpack

16 篇文章

订阅专栏

Android Navigation 是 Jetpack 组件的一部分，提供了用于管理应用内导航的框架。它简化了应用内的导航操作，包括片段间的切换、参数传递和返回栈管理。以下是 Android Navigation 的工作原理及其基本使用方法。

Navigation 原理

导航图（NavGraph）：导航图是导航组件的核心，它是一个 XML 文件，定义了应用中的所有导航路径。导航图包含目的地（Destination），如活动（Activity）、片段（Fragment）和其他可导航的组件。每个目的地之间的导航路径通过动作（Action）连接。
NavController：NavController 是导航操作的执行者。它管理导航图，并处理用户交互和导航动作。通过 NavController，可以在目的地之间导航、处理返回栈和管理过渡动画。
NavHost：NavHost 是一个占位符，用于在 UI 中显示 NavController 管理的导航目的地。常见的 NavHost 是 NavHostFragment，它承载并显示导航图中的片段。
Safe Args：Safe Args 是一个 Gradle 插件，用于在导航过程中类型安全地传递参数。它会在编译时生成相应的代码，以确保参数传递的安全性和正确性。

基本使用方法

添加依赖项：在项目的 build.gradle 文件中添加导航组件的依赖项。

dependencies {
    def nav_version = "2.3.5"
    implementation "androidx.navigation:navigation-fragment-ktx:$nav_version"
    implementation "androidx.navigation:navigation-ui-ktx:$nav_version"
}

创建导航图：在 res/navigation 文件夹中创建一个导航图 XML 文件（如 nav_graph.xml）。

<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    app:startDestination="@id/homeFragment">

    <fragment
        android:id="@+id/homeFragment"
        android:name="com.example.HomeFragment"
        android:label="Home"
        tools:layout="@layout/fragment_home" >
        <action
            android:id="@+id/action_homeFragment_to_detailFragment"
            app:destination="@id/detailFragment" />
    </fragment>

    <fragment
        android:id="@+id/detailFragment"
        android:name="com.example.DetailFragment"
        android:label="Detail"
        tools:layout="@layout/fragment_detail" />
</navigation>

设置 NavHost：在主布局文件中添加 NavHostFragment。

<androidx.fragment.app.FragmentContainerView
    android:id="@+id/nav_host_fragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:navGraph="@navigation/nav_graph"
    app:defaultNavHost="true"
    android:name="androidx.navigation.fragment.NavHostFragment" />

导航操作：在 Activity 或 Fragment 中获取 NavController 并执行导航操作。

class HomeFragment : Fragment() {

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        
        view.findViewById<Button>(R.id.button_navigate).setOnClickListener {
            findNavController().navigate(R.id.action_homeFragment_to_detailFragment)
        }
    }
}

使用 Safe Args 传递参数：在导航图中定义参数，并在代码中使用 Safe Args 插件生成的类来传递参数。

<fragment
    android:id="@+id/detailFragment"
    android:name="com.example.DetailFragment"
    android:label="Detail"
    tools:layout="@layout/fragment_detail" >
    <argument
        android:name="userId"
        app:argType="integer" />
</fragment>

val action = HomeFragmentDirections.actionHomeFragmentToDetailFragment(userId = 123)
findNavController().navigate(action)

Navigation 工作流程

定义导航图：通过导航图定义应用中的所有导航路径和目的地。
设置 NavHost：在布局中添加 NavHost 以显示导航图中的内容。
获取 NavController：在代码中获取 NavController 以执行导航操作。
执行导航操作：通过 NavController 导航到目标目的地，并传递必要的参数。
处理返回栈：NavController 自动管理返回栈，确保用户可以使用系统的返回按钮正确返回到前一个目的地。

Navigation 的优势

简化导航逻辑：通过导航图集中定义导航路径，简化了导航逻辑，使代码更加清晰和易于维护。
编译时验证：导航组件在编译时验证导航路径的正确性，减少了运行时错误。
类型安全的参数传递：通过 Safe Args 插件，实现了类型安全的参数传递，避免了潜在的类型错误。
自动管理返回栈：NavController 自动管理返回栈，简化了返回操作的处理。
UI 集成：导航组件与 UI 组件（如 Toolbar、BottomNavigationView）无缝集成，提供了更好的用户体验。

通过以上原理和使用方法，Android Navigation 提供了一种高效、可靠的方式来管理应用内的导航路径和目的地，提升了应用的开发效率和用户体验。