美文网首页
一文看懂Navigation,从使用入门到常见问题再到示例项目

一文看懂Navigation,从使用入门到常见问题再到示例项目

作者: miaowmiaow | 来源:发表于2021-12-01 15:40 被阅读0次

    前言

    这可以说是 Jetpack Navigation 胎教级文章,从 使用入门常见问题 再到 示例项目 一篇文章全部包括。

    Navigation及其用途

    NavigationAndroid Jetpack 组件之一,主要是用于 Fragment 路由导航的框架,通过 Navigation 我们可以设计出单 Activity 应用架构。

    Navigation 由以下三个关键部分组成:

    • NavHost:显示 Fragment 的容器。
    • NavController:在 NavHost 中管理应用导航的对象。
    • 导航图:配置所有导航相关信息的 XML 资源。跟我们常用的 AndroidManifest.xml 类似。

    所以 Navigation 的使用即在 导航图 配置 Fragment 相关信息,再告诉 NavController 导航至特定目标, NavController 便会在 NavHost 中显示相应目标。

    使用入门

    请向应用的 build.gradle 文件添加以下依赖项:

    dependencies {
      val nav_version = "2.3.5"
      // Kotlin
      implementation("androidx.navigation:navigation-fragment-ktx:$nav_version")
      implementation("androidx.navigation:navigation-ui-ktx:$nav_version")
    }
    

    添加导航图,请执行以下操作:

    1. 在“Project”窗口中,右键点击 res 目录,然后依次选择 New > Android Resource File。此时系统会显示 New Resource File 对话框。
    2. File name 字段中输入名称,例如“nav_graph”。
    3. Resource type 下拉列表中选择 Navigation,然后点击 OK

    当您添加首个导航图时,Android Studio 会在 res 目录内创建一个 navigation 资源目录。该目录包含您的导航图资源文件(例如 nav_graph.xml)。

    <?xml version="1.0" encoding="utf-8"?>
    <navigation xmlns:android="http://schemas.android.com/apk/res/android"
                xmlns:app="http://schemas.android.com/apk/res-auto"
                android:id="@+id/nav_graph">
    
    </navigation>
    

    向 Activity 添加 NavHost

    请注意以下几点:

    • android:name 属性包含 NavHost 实现的类名称。
    • app:navGraph 属性将 NavHostFragment 与导航图相关联。导航图会在此 NavHostFragment 中指定用户可以导航到的所有目的地。
    • app:defaultNavHost="true" 属性确保您的 NavHostFragment 会拦截系统返回按钮。请注意,只能有一个默认 NavHost。如果同一布局(例如,双窗格布局)中有多个宿主,请务必仅指定一个默认 NavHost
    <?xml version="1.0" encoding="utf-8"?>
    <androidx.constraintlayout.widget.ConstraintLayout
        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"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        tools:context=".MainActivity">
    
        <androidx.appcompat.widget.Toolbar
            .../>
    
         <androidx.fragment.app.FragmentContainerView
            android:id="@+id/nav_host_fragment"
            android:name="androidx.navigation.fragment.NavHostFragment"
            android:layout_width="0dp"
            android:layout_height="0dp"
            app:layout_constraintLeft_toLeftOf="parent"
            app:layout_constraintRight_toRightOf="parent"
            app:layout_constraintTop_toTopOf="parent"
            app:layout_constraintBottom_toBottomOf="parent"
            app:defaultNavHost="true"
            app:navGraph="@navigation/nav_graph" /> 
    
        <com.google.android.material.bottomnavigation.BottomNavigationView
            .../>
    
    </androidx.constraintlayout.widget.ConstraintLayout>
    

    向导航图添加并导航到目的地

    在导航图中,操作由 <action> 元素表示。操作至少应包含自己的 ID 和用户应转到的目的地的 ID。

    <?xml version="1.0" encoding="utf-8"?>
    <navigation xmlns:app="http://schemas.android.com/apk/res-auto"
        xmlns:tools="http://schemas.android.com/tools"
        xmlns:android="http://schemas.android.com/apk/res/android"
        app:startDestination="@id/blankFragment">
        <fragment
            android:id="@+id/blankFragment"
            android:name="com.example.cashdog.cashdog.BlankFragment"
            android:label="@string/label_blank"
            tools:layout="@layout/fragment_blank" >
            <action
                android:id="@+id/action_blankFragment_to_blankFragment2"
                app:destination="@id/blankFragment2" />
        </fragment>
        <fragment
            android:id="@+id/blankFragment2"
            android:name="com.example.cashdog.cashdog.BlankFragment2"
            android:label="@string/label_blank_2"
            tools:layout="@layout/fragment_blank_fragment2" />
    </navigation>
    

    导航到目的地是使用 NavController 完成的,它是一个在 NavHost 中管理应用导航的对象。通过 navigate(int) 接受操作或目的地的资源 ID 作为参数。

    val navHostFragment = supportFragmentManager.findFragmentById(R.id.nav_host_fragment) as NavHostFragment
    val navController = navHostFragment.navController
    navController.navigate(R.id.action_blankFragment_to_blankFragment2)
    

    导航图规则

    1. 导航图之间可以通过 id 跳转到对应导航图的 startDestination
    2. 同个导航图之内可以通过 action 互相跳转
    3. 不同导航图之间可以通过深层链接跳转

    以上就是 Navigation 的基本使用,其他细节可到官网查看Navigation 组件使用入门 | Android Developers

    常见问题

    通过上面的介绍我们对 Navigation 有了一定的了解,但当你按照文档进行开发时,便会发现 Navigation 存在的一些小问题。

    因为 Navigation 是通过 replace 的方式去替换 Fragment ,即每次 Fragment 的切换都是重新创建的 ,而问题也随之而来。

    重复请求数据

    既然我们的项目用了 Navigation ,那么 Jetpack 全家桶肯定是一个不能少的了。 Fragment 的重建并不会使ViewModel 被销毁,所以 LiveData 的数据依然保存着,页面重建后会把数据重新渲染到页面上,所以在视觉上我们根本感觉不到被页面被重建了,但是相应的初始化逻辑会继续执行会重新请求数据,这就造成了资源的浪费。既然知道了原因,那如何避免这个问题呢?

    最简单的方法是在请求数据前加个空判断,代码如下:

    if (viewModel.data.value == null) {
        viewModel.getData()
    }
    

    乍一看会觉得这方案好low呀,请大家先别着急听我慢慢道来。在此之前我亦是采用过其他方案,比如对 LiveData 进行包装,随着业务需求的不断变化,你就要去维护它这是不能接受的。最终采用上述的方案,越简单越不会出错(UNIX设计哲学)。

    过渡动画卡顿

    导致过渡动画卡顿的原因当然也是 Fragment 重建咯,Fragment 重建后需要重新渲染页面,卡那么一下也是正常现象。既然知道了原因,那如何避免这个问题呢?

    最简单的方法是在动画执行完成后渲染页面,代码如下:

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        view.postDelayed({
            initLoad()
        }, delayedLoad) //delayedLoad为设置的过度动画时间
    }
    

    依旧是UNIX设计哲学,当然上述的方案并不是唯一解,其他方案请自行搜索学习哈😃

    (ps:官方为什么不解决上面这些问题呢?个人的猜测是官方还没有找一个优雅的解决方案,期待后续的版本的优化吧 😏)

    示例项目




    Thanks

    以上就是本篇文章的全部内容,如有问题欢迎指出,我们一起进步。
    如果喜欢的话希望点个赞吧,您的鼓励是我前进的动力。
    谢谢~~

    相关文章

      网友评论

          本文标题:一文看懂Navigation,从使用入门到常见问题再到示例项目

          本文链接:https://www.haomeiwen.com/subject/gxbsxrtx.html