Android——JetPack{Navigation}

2021-09-08 本文已影响0人 So_ProbuING

Navigation诞生背景

单个Activity+多个Fragment的UI架构模式，已经被越来越多的项目开发所采用。但是对Fragment的管理一直是一件比较麻烦的事情。管理Fragment需要使用FragmentManager和FragmentTransaction来管理Fragment之间的切换。
为此，Jetpack提供了一个名为Navigation的组件，来帮助我们管理页面和Appbar

什么是Navigation

Navigation

Navigation三大件

Navigation Graph：这是一种新型的XML资源文件，其中包含应用程序的所有页面，以及页面间的关系
NavHost：用于显示导航中目标的空包容器。Navigation Graph中的Fragment正是通过NavHostFragment进行展示的
NavController：控制显示在NavHost中显示的内容，这是一个Java对象，用于在代码中完成Navigation Graph中具体的页面切换

当想要切换Fragment时，使用NavController对象，告诉它你想要去Navigation Graph中的哪个Fragment，NavController会将你想去的Fragment展示在NavHost中

Navigation三大件提供的功能

Navigation三大件提供的优势

往返操作——回退栈的操作
动画——提供标准的进入进出动画的使用资源
深层链接——deepLink

Navigation能做什么

使用Navigation

添加gradle依赖

    implementation 'androidx.navigation:navigation-fragment:2.3.0'
    implementation 'androidx.navigation:navigation-ui:2.3.0'

创建Navigation Graph
使用AndoridStudio 可以帮我们创建Navigation Graph

image.png

<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/nav_graph"
    app:startDestination="@id/fragmenta">
    <action android:id="@+id/to_fragmentb"
        app:destination="@+id/fragmentb"
        app:exitAnim="@anim/nav_default_exit_anim"
        app:enterAnim="@anim/nav_default_enter_anim"
        />
    <action android:id="@+id/to_fragmentc"
        app:destination="@+id/fragmentc"
        app:exitAnim="@anim/nav_default_exit_anim"
        app:enterAnim="@anim/nav_default_enter_anim"
        />
    <action android:id="@+id/to_fragmentd"
        app:destination="@+id/fragmentd"
        app:exitAnim="@anim/nav_default_exit_anim"
        app:enterAnim="@anim/nav_default_enter_anim"
        />
    <action android:id="@+id/to_fragmenta"
        app:destination="@+id/fragmenta"
        app:exitAnim="@anim/nav_default_exit_anim"
        app:enterAnim="@anim/nav_default_enter_anim"
        />
    <action android:id="@+id/to_fragmente"
        app:destination="@+id/fragmente"
        app:exitAnim="@anim/nav_default_exit_anim"
        app:enterAnim="@anim/nav_default_enter_anim"
        />
    <fragment
        android:id="@+id/fragmenta"
        android:name="com.probuing.jetpacklsn.navigationlsn.fragment.FragmentA"
        android:label="fragment">

    </fragment>
    <fragment
        android:id="@+id/fragmentb"
        android:name="com.probuing.jetpacklsn.navigationlsn.fragment.FragmentB"
        android:label="fragment">
        <deepLink app:uri="http://www.wx.com/{params}"/>
    </fragment>
    <fragment
        android:id="@+id/fragmentc"
        android:name="com.probuing.jetpacklsn.navigationlsn.fragment.FragmentC"
        android:label="fragment"></fragment>
    <fragment
        android:id="@+id/fragmentd"
        android:name="com.probuing.jetpacklsn.navigationlsn.fragment.FragmentD"
        android:label="fragment"></fragment>
    <fragment
        android:id="@+id/fragmente"
        android:name="com.probuing.jetpacklsn.navigationlsn.fragment.FragmentE"
        android:label="fragment"></fragment>
</navigation>

根布局中的app:startDestination="@id/fragmenta"：表示设置起始的路径点，也就是一开始加载的fragment
Action中的app:destination="@+id/fragmenta" 表示要前往的目的地是哪个组件，用id标识

添加NavHostFragment
在Activity的布局文件中添加

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

指定android:name 是在告诉系统，这是一个特殊的Fragment

app:defaultNavHost：表示使用该Fragment处理回退栈
app:navGraph:设置该Fragment对应的导航图
4.创建FragmentA （其他Fragment带代码类似）

public class FragmentB extends Fragment {
    private static final String TAG = "----------->";

    @Nullable
    @Override
    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
        View containerView = inflater.inflate(R.layout.fragment_b, container, false);
        return containerView;
    }
}

使用NavController完成导航

navController = Navigation.findNavController(this, R.id.nav_fragment);

使用navController完成Fragment跳转

        NavController navController = Navigation.findNavController(getView());
                navController.navigate(R.id.to_fragmentc);

参数传递

常见的参数传递

safe args传递参数

安装safe args插件在project的build.gradle文件中添加safe args插件

    dependencies {
        classpath 'androidx.navigation:navigation-safe-args-gradle-plugin:2.3.0-alpha01'
    }

在app的build.gradle文件中添加对safe args的依赖

plugins {
    id 'com.android.application'
    id 'androidx.navigation.safeargs'
}

在导航文件 nav_graph中添加<argument/>标签

    <fragment
        android:id="@+id/fragmentb"
        android:name="com.probuing.jetpacklsn.navigationlsn.fragment.FragmentB"
        android:label="fragment">
        <deepLink app:uri="http://www.wx.com/{params}"/>
        <argument android:defaultValue="unknow" android:name="user_name" app:argType="string"/>
        <argument android:defaultValue="0" android:name="user_age" app:argType="integer"/>
    </fragment>

添加<argument/>后，便可以在app/generatedJava目录下看到safe args插件为我们生成的代码文件了，这些代码文件中包含了参数所对应的Getter和Setter方法
需要在Fragment中利用所生成的代码文件，传递数据

image.png

NavigationUI的使用

NavigationUI的存在意义

Jetpack为了方便我们管理App bar中menu菜单的变化。切换页面时来管理App bar 与导航图中的页面关联
我们来实现一个这样的效果