Navigation
2022-07-12 本文已影响0人
NoBugException
Navigation 官方文档：
https://developer.android.google.cn/guide/navigation/navigation-getting-started?hl=zh-cn
Navigation 是用来管理 Fragment 的切换，并且可以通过可视化的方式，看见App的交互流程。
优点:
1、处理 Fragment 的切换（上文已说过）
2、默认情况下正确处理 Fragment 的前进和后退
3、为过渡和动画提供标准化的资源
4、实现和处理深层连接
5、可以绑定 Toolbar 、 BottomNavigationView 和 ActionBar 等
6、SafeArgs （Gradle插件） 数据传递时提供类型安全性
7、ViewModel 支持
Navigation 组件由三个关键部分组成，这三个部分协同工作。它们是：
1、导航图（新 XML 资源），创建 navigation 文件夹，在 navigation 文件夹中新建xml导航图
2、NavHostFragment，在 NavigationActivity 中加入 NavHostFragment（当前fragment的容器）
3、NavController，导航的控制者
【1】依赖
//Navigation
implementation "androidx.navigation:navigation-fragment-ktx:2.3.5"
implementation "androidx.navigation:navigation-ui-ktx:2.3.5"
【2】新建导航图
1、在res目录下新建navigation文件夹
2、在navigation文件夹新建xml文件 demo_nav.xml 文件，如下图：
image.png
<?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"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/demo_nav"
app:startDestination="@id/oneFragment">
<fragment
android:id="@+id/oneFragment"
android:name="com.yunchong.jetpack.fragments.OneFragment"
android:label="fragment_one"
tools:layout="@layout/fragment_one" >
<action
android:id="@+id/action_oneFragment_to_twoFragment"
app:destination="@id/twoFragment" />
</fragment>
<fragment
android:id="@+id/twoFragment"
android:name="com.yunchong.jetpack.fragments.TwoFragment"
android:label="fragment_two"
tools:layout="@layout/fragment_two" >
<action
android:id="@+id/action_twoFragment_to_threeFragment"
app:destination="@id/threeFragment" />
</fragment>
<fragment
android:id="@+id/threeFragment"
android:name="com.yunchong.jetpack.fragments.ThreeFragment"
android:label="fragment_three"
tools:layout="@layout/fragment_three" />
</navigation>
他们的导航关系如下：
image.png
navigation：是导航标签，管理多个fragment标签
startDestination：指定第一个展示的fragment
action的destination：指定当前fragment的下一个跳转目标
【3】fragment文件
fragment 文件可以是在导航地图中新建：
image.png
也可以使用已有的fragment。
目前新建了3个fragment：
class OneFragment : Fragment() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
}
override fun onCreateView(
inflater: LayoutInflater, container: ViewGroup?,
savedInstanceState: Bundle?
): View? {
val view = inflater.inflate(R.layout.fragment_one, container, false)
view.back.setOnClickListener {
}
view.next.setOnClickListener {
}
return view
}
}
其他两个文件和以上代码差不多，Fragment的xml布局这里就不展示了。
【4】在Activity中加载Navigation地图
<androidx.constraintlayout.widget.ConstraintLayout
android:layout_width="match_parent"
android:layout_height="match_parent" >
<fragment
android:id="@+id/demo_fragment"
android:layout_width="0dp"
android:layout_height="0dp"
android:name="androidx.navigation.fragment.NavHostFragment"
app:defaultNavHost="true"
app:navGraph="@navigation/demo_nav"
app:layout_constraintTop_toTopOf="parent"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintLeft_toLeftOf="parent"
app:layout_constraintRight_toRightOf="parent"/>
</androidx.constraintlayout.widget.ConstraintLayout>
其中最重要的三行代码是：
android:name="androidx.navigation.fragment.NavHostFragment"
app:defaultNavHost="true"
app:navGraph="@navigation/demo_nav"
前面两行代码是固定格式，第三句代码指定了Navigation地图。
【5】fragment 切换
Navigation优化了 fragment 的事务处理，Navigation使fragment的切换变得简单。
从一个fragment切换到下一个fragment：
Navigation.findNavController(view).navigate(R.id.action_oneFragment_to_twoFragment, bundle, navOption)
// 或者
// findNavController().navigate(R.id.action_oneFragment_to_twoFragment, bundle, navOption)
Navigation.findNavController(view) 和 findNavController() 是控制器，
action_oneFragment_to_twoFragment 是导航地图中action中定义的id。
弹出fragment：
Navigation.findNavController(view).popBackStack()
// 或者
// findNavController().popBackStack()
popBackStack 可以指定 destinationId 参数，如果没有指定，则默认弹出当前fragment 并切换到上一个fragment。
如果指定了 destinationId 参数，那么将会一直弹出，直到 destinationId 为止。
【6】数据传递方式
【1】使用 ViewModelProvider 可以做到 Activity 和 fragment 之间数据共享
ViewModelProvider(this).get(T::class.java)
【2】Bundle 传递
fragment 之间可以使用 Bundle 传递方式：
view.next.setOnClickListener {
// 参数设置
val bundle = Bundle()
bundle.putString("name","zhangsan")
// 传递
Navigation.findNavController(view).navigate(R.id.action_oneFragment_to_twoFragment, bundle)
}
// 接收
val name: String? = arguments?.getString("name") // 获取上级页面传递过来的文本
【3】利用 Safe Args 插件传递参数
由于类型安全，使用 safe args 生成的类的导航是按操作导航以及在导航期间传递参数的首选方式。
第一步、添加 safe args 插件：
buildscript {
repositories {
google()
mavenCentral()
}
dependencies {
classpath 'com.android.tools.build:gradle:7.2.1'
classpath "androidx.navigation:navigation-safe-args-gradle-plugin:2.3.5"
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.6.10"
}
}
第二步、在模块下添加：
plugins {
id 'org.jetbrains.kotlin.android.extensions'
id 'androidx.navigation.safeargs.kotlin'
}
第三步、在Navigation地图中添加argument
<fragment
android:id="@+id/twoFragment"
android:name="com.yunchong.jetpack.fragments.TwoFragment"
android:label="fragment_two"
tools:layout="@layout/fragment_two" >
<action
android:id="@+id/action_twoFragment_to_threeFragment"
app:destination="@id/threeFragment" />
<argument
android:name="name"
android:defaultValue="zhangsan"
app:argType="string"/>
</fragment>
第四步、发送数据
val bundle = OneFragmentDirections.actionOneFragmentToTwoFragment(name = "hello zhangsan").arguments
Navigation.findNavController(view).navigate(R.id.action_oneFragment_to_twoFragment, bundle, null)
第五步、接收数据
val safeArgs: TwoFragmentArgs by navArgs()
val name = safeArgs.name
【7】fragment切换动画
view.next.setOnClickListener {
// 设置动画参数
val navOption = navOptions {
anim {
enter = R.anim.slide_in_right
exit = R.anim.slide_out_left
popEnter = R.anim.slide_in_left
popExit = R.anim.slide_out_right
}
}
Navigation.findNavController(view).navigate(R.id.action_oneFragment_to_twoFragment, null, navOption)
}
或者在action中定义：
<fragment
android:id="@+id/oneFragment"
android:name="com.yunchong.jetpack.fragments.OneFragment"
android:label="fragment_one"
tools:layout="@layout/fragment_one" >
<action
android:id="@+id/action_oneFragment_to_twoFragment"
app:destination="@id/twoFragment"
app:enterAnim="@anim/slide_in_right"
app:exitAnim="@anim/slide_out_left"
app:popEnterAnim="@anim/slide_in_left"
app:popExitAnim="@anim/slide_out_right"/>
</fragment>
slide_in_right 代码如下：
<?xml version="1.0" encoding="utf-8"?>
<set xmlns:android="http://schemas.android.com/apk/res/android">
<translate
android:fromXDelta="100%"
android:toXDelta="0%"
android:fromYDelta="0%"
android:toYDelta="0%"
android:duration="700"/>
</set>
slide_out_left 代码如下：
<?xml version="1.0" encoding="utf-8"?>
<set xmlns:android="http://schemas.android.com/apk/res/android">
<translate
android:fromXDelta="0%"
android:toXDelta="-100%"
android:fromYDelta="0%"
android:toYDelta="0%"
android:duration="700"/>
</set>
slide_in_left 代码如下：
<?xml version="1.0" encoding="utf-8"?>
<set xmlns:android="http://schemas.android.com/apk/res/android">
<translate
android:fromXDelta="-100%"
android:toXDelta="0%"
android:fromYDelta="0%"
android:toYDelta="0%"
android:duration="700"/>
</set>
slide_out_right 代码如下：
<?xml version="1.0" encoding="utf-8"?>
<set xmlns:android="http://schemas.android.com/apk/res/android">
<translate
android:fromXDelta="0%"
android:toXDelta="100%"
android:fromYDelta="0%"
android:toYDelta="0%"
android:duration="700"/>
</set>
【8】navigation可以和一些控件绑定
Navigation 可以绑定 menus 、 drawers 、 bottom navigation、CollapsingToolbarLayout、Toolbar，它们提供
view.setupWithNavController(navController)
方法，来绑定navigation控制器。
[本章完...]
