一文学会Jetpack Navigation,开发您的第一个单Activity应用吧,文末有示例项目真保姆级教学

4,264 阅读3分钟

前言

这可以说是 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

示例项目

在这里也给自己的 fragmject 打个广告,真正的入门级的学习项目。通过对KotlinJetpack全家桶的系统运用,实现的一个功能完备符合主流市场标准App。 一个代码够简单,内容够全面,知识够详细,能让你快速上手的项目,对理解其他项目设计思想和封装技巧也很有帮助。

Thanks

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