Navigation

benefit

Overview

1. Navigation Graph(导航图) 这是一个资源文件，再此文件描述了所有视图的跳转关系，和跳转参数，跳转动画的描述
2. NavHostFragment(导航宿主) 用于展示目的地视图的控件。
3. NavController(导航控制器)，通过该控制器，按照导航图控制NavHost容器的进栈入栈。
   When you navigate, you'll use the NavController object, telling it where you want to go or what path you want to take in your Navigation Graph. The NavController will then show the appropriate destination in the NavHostFragment.
   在导航图中编辑的目的地关系图，你将通过NavController来控制要跳转的路径，NavController将会在NavHostFragment上准确的显示目的地。

使用：

依赖引入：

 def nav_version = "2.1.0"
      // Java language implementation
      implementation "androidx.navigation:navigation-fragment:$nav_version"
      implementation "androidx.navigation:navigation-ui:$nav_version"

导航图

1、创建导航图

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

nav_graph.png

2、编辑窗口几个部分

1. Destinations panel：列出了导航宿主和目前位于 Graph Editor 中的所有目的地。
2. Graph Editor：包含导航图的视觉表示形式。您可以在 Design 视图和 Text 视图中的底层 XML 表示形式之间切换
3. Attributes：显示导航图中当前所选项的属性

3、编辑导航图

1、 向 Activity 添加 NavHost

导航宿主是 Navigation 组件的核心部分之一。导航宿主是一个空容器，用户在您的应用中导航时，目的地会在该容器中交换进出。
导航宿主必须派生于 NavHost。Navigation 组件的默认 NavHost 实现 (NavHostFragment) 负责处理 Fragment 目的地的交换。
在activity_main.xml 中添加NavHostFragment

<?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">

    <fragment
        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" />

</androidx.constraintlayout.widget.ConstraintLayout>

请注意以下几点：

• android:name 属性包含 NavHost 实现的类名称。
• app:navGraph 属性将 NavHostFragment 与导航图相关联。导航图会在此 NavHostFragment 中指定用户可以导航到的所有目的地。
• app:defaultNavHost="true" 属性确保您的 NavHostFragment 会拦截系统返回按钮。请注意，只能有一个默认 NavHost。如果同一布局（例如，双窗格布局）中有多个主机，请务必仅指定一个默认 NavHost。

您也可以使用 Layout Editor 向 您也可以使用 Layout Editor 向 Activity 添加 NavHostFragment，具体操作步骤如下：

1. 在项目文件列表中，双击 Activity 的布局 XML 文件，以在 Layout Editor 中将其打开。
2. 在 Palette 窗格内，选择 Containers 类别，或者搜索“NavHostFragment”。
3. 将 NavHostFragment 视图拖动到您的 Activity 上。
4. 接下来，在随即显示的 Navigation Graphs 对话框中，选择要与此 NavHostFragment 相关联的相应导航图，然后点击 OK。

2. 向导航图添加目的地

在本示例中，我们来创建一个新目的地。要使用 Navigation Editor 添加新目的地，请执行以下操作：

1. 在 Navigation Editor 中，点击 New Destination 图标

   image

   ，然后点击 Create new destination。

2. 在随即显示的 New Android Component 对话框中，创建您的 Fragment。如需详细了解 Fragment，请参阅 Fragment 文档。
   这儿创建了3个destination（HomeFragment,SettingFragment,FlowStep1Fragment）
   

   image.png

3. destination属性详解

• Type 字段指示在您的源代码中，该目的地是作为 Fragment、Activity 还是其他自定义类实现的。
• Label 字段包含该目的地的 XML 布局文件的名称。
• ID 字段包含该目的地的 ID，它用于在代码中引用该目的地。
• Class 下拉列表显示与该目的地相关联的类的名称。您可以点击此下拉列表，将相关联的类更改为其他目的地类型。

4.指定屏幕起始的destination 选中一个destination，这儿选中homefragment

1. 在 Design 标签页中，点击相应目的地，使其突出显示。

2. 点击 Assign start destination 按钮

   image

   。或者，您可以右键点击该目的地，然后点击 Set as Start Destination。

3、创建跳转Action

1. 选中起始navigation,选中目的navigation高亮，右侧有个圆圈

   
   HomeFragment.png
2. 点击圆圈拖拽到目的navigation，两个navigation之间变回生成一条连接线。

Action属性

• Type 字段包含“Action”。
• ID 字段包含该操作的 ID。
• Destination 字段包含目的地 Fragment 或 Activity 的 ID

4、使用NavController导航到目的地

 View rootView = inflater.inflate(R.layout.fragment_home, container, false);
        rootView.findViewById(R.id.bt_to_setting).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Navigation.findNavController(v).navigate(R.id.action_home_to_setting);
            }
        });
        rootView.findViewById(R.id.bt_toflowstep1).setOnClickListener(Navigation.createNavigateOnClickListener(R.id.action_home_to_flowStep1));
  }

有没有发现这样使用，并没有使用到我们刚刚准备的action，所以官方推荐我们使用Safe Args

5、Safe Args

要在目的地之间导航，建议使用 Safe Args Gradle 插件。该插件可以生成简单的对象和构建器类，这些类支持在目的地之间进行类型安全的导航和参数传递。

插件引入

顶级的build.gradle

  buildscript {
        repositories {
            google()
        }
        dependencies {
            def nav_version = "2.1.0"
            classpath "androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version"
        }
    }

项目build.gradle

apply plugin: "androidx.navigation.safeargs"