前言
这可以说是 Jetpack Navigation
胎教级文章,从 使用入门 到 常见问题 再到 示例项目 一篇文章全部包括。
Navigation及其用途
Navigation
是 Android 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")
}
添加导航图,请执行以下操作:
- 在“Project”窗口中,右键点击
res
目录,然后依次选择 New > Android Resource File。此时系统会显示 New Resource File 对话框。 - 在 File name 字段中输入名称,例如“nav_graph”。
- 从 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)
导航图规则
- 导航图之间可以通过
id
跳转到对应导航图的startDestination
- 同个导航图之内可以通过
action
互相跳转 - 不同导航图之间可以通过深层链接跳转
以上就是 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:官方为什么不解决上面这些问题呢?个人的猜测是官方还没有找一个优雅的解决方案,期待后续的版本的优化吧 😏)
示例项目
- github: fragmject
Thanks
以上就是本篇文章的全部内容,如有问题欢迎指出,我们一起进步。
如果喜欢的话希望点个赞吧,您的鼓励是我前进的动力。
谢谢~~
网友评论