49、Navigation组件：Navigation Graph、NavHostFragment、Safe Args、深层链接

Navigation 组件，说白了就是 Google 给 Android 开发者准备的一套「页面导航标准答案」。我刚开始做 Android 开发那会儿，Activity 跳转全靠 Intent，Fragment 切换全靠 FragmentManager，代码写得跟蜘蛛网似的。后来 Navigation 组件一出来，我第一时间就切过去了——嗯，真香。

今天咱们就把 Navigation 的四个核心东西捋一遍：Navigation Graph、NavHostFragment、Safe Args、深层链接。你想想看，这四个东西组合起来，基本能覆盖 90% 的页面导航场景。

Navigation Graph：你的页面地图

Navigation Graph 本质上就是一个 XML 文件，放在 res/navigation/ 目录下。它定义了应用中所有页面的跳转关系。我个人习惯先画图再写代码，所以 Navigation Graph 对我来说就像一张「页面地图」。

举个例子，一个简单的登录流程：

<?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"
    app:startDestination="@id/loginFragment">

    <fragment
        android:id="@+id/loginFragment"
        android:name="com.example.LoginFragment"
        android:label="登录">
        <action
            android:id="@+id/action_login_to_home"
            app:destination="@id/homeFragment" />
    </fragment>

    <fragment
        android:id="@+id/homeFragment"
        android:name="com.example.HomeFragment"
        android:label="首页" />
</navigation>

这里有个关键点：startDestination 决定了应用启动时第一个显示的页面。我在项目中遇到过一个问题——有次我把 startDestination 写错了，结果应用一启动就崩溃，查了半天才发现是 Fragment 的类名拼错了。嗯，这里要注意，ID 和类名一定要匹配。

核心要点：Navigation Graph 中的每个节点（Fragment、Activity、DialogFragment）都必须有唯一的 ID，且 startDestination 必须指向一个存在的节点。

NavHostFragment：页面的容器

NavHostFragment 是 Navigation 组件的核心容器。它负责管理 Fragment 的添加、移除、替换。说白了，它就是 FragmentManager 的「高级封装版」。

在布局文件中，你只需要这样写：

<androidx.fragment.app.FragmentContainerView
    android:id="@+id/nav_host_fragment"
    android:name="androidx.navigation.fragment.NavHostFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:navGraph="@navigation/nav_graph" />

注意这里用的是 FragmentContainerView 而不是 fragment 标签。为什么？因为 FragmentContainerView 是 Google 专门为 Navigation 优化的容器，性能更好，而且能避免一些 Fragment 生命周期的问题。我曾经用 fragment 标签踩过坑——页面切换时会出现短暂的空白，换成 FragmentContainerView 后就再也没出现过。

小技巧：如果你需要在 Activity 中获取 NavController，可以这样写：NavHostFragment.findNavController(fragment) 或者 Navigation.findNavController(view)。我个人更推荐前者，因为 Fragment 的引用更安全。

Safe Args：类型安全的参数传递

以前 Fragment 之间传参数，我们通常用 Bundle。但 Bundle 有个问题——它是类型不安全的。你传一个 String，接收方可能当成 Int 来取，运行时直接崩溃。Safe Args 就是来解决这个问题的。

使用 Safe Args 需要两步：

  1. 在 Navigation Graph 中定义参数
  2. 在代码中使用生成的 Directions 和 Args 类

先看定义参数：

<fragment
    android:id="@+id/detailFragment"
    android:name="com.example.DetailFragment">
    <argument
        android:name="itemId"
        app:argType="integer"
        android:defaultValue="0" />
    <argument
        android:name="itemName"
        app:argType="string"
        android:defaultValue="" />
</fragment>

然后在代码中跳转：

// 发送方
val action = LoginFragmentDirections.actionLoginToHome()
action.itemId = 123
action.itemName = "测试商品"
findNavController().navigate(action)

// 接收方
val args = DetailFragmentArgs.fromBundle(requireArguments())
val itemId = args.itemId
val itemName = args.itemName

你看，参数类型在编译时就确定了，再也不用担心运行时类型不匹配的问题。我记得有次接手一个老项目，里面全是 Bundle 传参，光查一个 NullPointerException 就花了两天。后来我强制团队用 Safe Args，这类问题基本绝迹了。

注意：Safe Args 需要添加 Gradle 插件：id 'androidx.navigation.safeargs.kotlin'。如果你用的是 Java，就用 androidx.navigation.safeargs。别搞混了，不然编译会报错。

深层链接：从外部直达页面

深层链接（Deep Link）允许用户从外部直接跳转到应用内的某个页面。比如你点击一个商品链接，直接打开应用的商品详情页，而不是首页。

Navigation 组件支持两种深层链接：

  • URL 深层链接：通过 HTTP/HTTPS 链接跳转
  • Intent 深层链接：通过自定义 Scheme 或 Action 跳转

在 Navigation Graph 中配置深层链接：

<fragment
    android:id="@+id/detailFragment"
    android:name="com.example.DetailFragment">
    <deepLink app:uri="https://www.example.com/item/{itemId}" />
    <deepLink app:uri="myapp://item/{itemId}" />
    <argument
        android:name="itemId"
        app:argType="integer" />
</fragment>

然后在 AndroidManifest.xml 中配置：

<activity
    android:name=".MainActivity"
    android:launchMode="singleTask">
    <nav-graph android:value="@navigation/nav_graph" />
</activity>

这里有个坑：launchMode 必须设置为 singleTask，否则深层链接可能会创建多个 Activity 实例。我曾经没设这个，结果用户从外部链接进来，每次都会新开一个 Activity，返回键按半天都回不去。嗯，这个教训挺深刻的。

实战建议：深层链接的 URL 最好和你的 Web 页面 URL 保持一致。这样用户从浏览器点击链接，如果安装了 App 就直接打开 App 对应页面，没安装就打开网页。体验上无缝衔接。

知识体系总览

下面这张图是我自己整理的 Navigation 组件核心结构，你看一眼就能明白它们之间的关系：

Navigation 组件核心结构 NavController Navigation Graph 页面跳转地图 NavHostFragment Fragment 容器 Safe Args 类型安全传参 深层链接 外部直达页面 NavController 统一调度，四个组件各司其职 Navigation Graph 定义路线 → NavHostFragment 承载页面 → Safe Args 传递数据 → 深层链接打通外部

避坑指南

最后分享几个我踩过的坑，你遇到了可以直接拿来用：

  • Fragment 重建问题：Navigation 默认会保存 Fragment 的状态，但如果你在 Fragment 中使用了 onViewCreated 以外的生命周期方法，记得检查 savedInstanceState 是否为 null。我曾经在 onActivityCreated 里做数据加载，结果页面重建时重复加载了两次。
  • 动画冲突：如果你同时设置了 Fragment 的动画和 Navigation 的动画，可能会出现动画叠加。我的建议是统一在 Navigation Graph 中配置动画，不要在 Fragment 代码里单独写。
  • 返回栈管理：Navigation 默认会维护返回栈，但如果你用了 popUpTo 和 popUpToInclusive，一定要理解它们的含义。简单说，popUpTo 是「弹出到某个页面」，popUpToInclusive 是「连那个页面一起弹出」。我见过有人把这两个参数搞反，结果返回键直接退出应用了。

个人习惯：我一般会在 BaseFragment 中封装一个 navigateSafe() 方法，检查 NavController 和当前 Fragment 的状态，避免在 Fragment 已经 detached 的情况下执行导航操作。这个习惯帮我避免了不少 IllegalStateException。

好了，Navigation 组件的四个核心东西就讲完了。你想想看，从页面定义到容器管理，从参数传递到外部跳转，Navigation 组件其实把整个导航流程都帮你封装好了。你只需要按照它的规则来写代码，基本不会出大问题。

公众号:蓝海资料掘金营，微信deep3321

← 上一章 📖 返回目录 下一章 →