深入理解Navigation架构之setPrimaryNavigationFragment接管系统的导航操作

简介: 深入理解Navigation架构之setPrimaryNavigationFragment接管系统的导航操作

1.前言


不管你之前用没用过Jetpack Navigation组件,但是或多或少你也可能听说过它。它是Jetpack库中的一个路由组件。此刻你的脑海中可能会浮现阿里ARouter框架。如果你熟悉ARouter但是对Navigation比较陌生,那么你先简单把它们联系在一起,有个直观的感受。


如果你对ARouter和Navigation都不太熟悉,没关系,并不影响你对本文的阅读。

Navigation支持Activity、Fragment、Dialog的路由跳转,功能非常强大。此刻灵魂拷问一下。


你知道Navigation是如何实现Activity、Fragment组件的跳转吗?

你知道Navigation如何接管系统返回键操作的?


第一个问题,在不看源码的情况下,我们大概也能略猜一二,Activity的路由是通过startActivity(intent)方法来实现的,Fragment的路由是通过FragmentTransaction的replace方法来实现的。关于真正的跳转原理,之后会出专文讲解,敬请关注本公众号,及时获取更文通知。


第二个问题,在不深入理解源码的情况下,如果被问到,我会直接被问懵。难道是重写onBackPressed()?


好了,不卖关子了,Navigation组件是通过FragmentTransaction.setPrimaryNavigationFragment()方法接管系统返回键操作的。有源码为证:


//NavHostFragment.java
public void onAttach(@NonNull Context context) {
    super.onAttach(context);
    // TODO This feature should probably be a first-class feature of the Fragment system,
    // but it can stay here until we can add the necessary attr resources to
    // the fragment lib.
    if (mDefaultNavHost) {
        getParentFragmentManager().beginTransaction()
                .setPrimaryNavigationFragment(this)
                .commit();
    }
}


NavHostFragment从字面意思理解,它是Navigation组件的导航宿主组件。Fragment组件如果想要在Navigation框架中实现路由功能必须满足两个条件:


  1. Fragment必须依附在NavHostFragment上
  2. NavHostFragment必须成为PrimaryNavigationFragment(后文简称:主导航Fragment)


行文至此,你可能有点懵,但是没关系,你只需要知道有主导航Fragment这个概念就行,接着往下看


本文的主角是setPrimaryNavigationFragment(),它是Fragment框架中的方法,它并不是什么新鲜玩意,它跟随Fragment框架一起发布的。但是很吊诡地是,翻遍所有的技术社区,都很难找到讲解它的文章。但是它真的很重要,它是Navigation组件的基础设施(水和电)。


要想深入理解Navigation实现原理,必须对Fragment实现原理深入了解。FragmentTransaction、BackStackRecord、FragmentManager等概念必须成竹于胸。推荐阅读深入理解Navigation架构之Fragment基础一文,扎扎实实掌握Fragment知识。

说回NavHostFragment


//NavHostFragment.java
public class NavHostFragment extends Fragment implements NavHost {
    public void onAttach(@NonNull Context context) {
        super.onAttach(context);
        // TODO This feature should probably be a first-class feature of the Fragment system,
        // but it can stay here until we can add the necessary attr resources to
        // the fragment lib.
        if (mDefaultNavHost) {
            getParentFragmentManager().beginTransaction()
                    .setPrimaryNavigationFragment(this)
                    .commit();
        }
    }
}


很简单的几行代码,却藏着不少信息


  1. NavHostFragment是导航宿主Fragment,要实现路由跳转的Fragment都是它的child Fragment。这里就涉及到childFragmentManager,parentFragmentManager等知识了。
  2. mDefaultNavHost是要设置成true,NavHostFragment才能成为主导航Fragment。
  3. 从注释中,可以看出,setPrimaryNavigationFragment()虽然很不起眼,它即将升级为Fragment的一类公民了(first-class)。


2. FragmentManager 回退栈



栈是一种很简单的数据结构。它的特点是“后进先出”。在FragmentManager中回退栈定义如下:


public abstract class FragmentManager{
    ArrayList<BackStackRecord> mBackStack;
}


在FragmentTransaction中有addToBackStack(String name)方法,可以将某个方法加入回退栈中。


class FragmentActvitiy1: AppCompatActivity() {
  fun addFragmentNotAddToBackStack() {
      supportFragmentManager.commit {
            setReorderingAllowed(true)
            add<AFragment>(R.id.top_fragment_container_view)
      }
      supportFragmentManager.commit {
            setReorderingAllowed(true)
            add<BFragment>(R.id.top_fragment_container_view)
      }
  }
}
class FragmentActvitiy2: AppCompatActivity() {
  fun addFragmentNotAddToBackStack() {
      supportFragmentManager.commit {
            setReorderingAllowed(true)
            add<AFragment>(R.id.top_fragment_container_view)
            addToBackStack(null)
      }
      supportFragmentManager.commit {
            setReorderingAllowed(true)
            add<BFragment>(R.id.top_fragment_container_view)
            addToBackStack(null)
      }
  }


上述两段代码,唯一的区别就是FragmentActivity1没有调用addToBackStack()方法,而


image.png

FragmentActivity2调用了。

image.png

FragmentActivity1 按返回键效果如下:

image.pngFragmentActivity2 按返回键效果如下:

image.png

image.png


3. FragmentManager处理返回原理


image.png

handleOnBackPressed() 处理逻辑如下:


当回退栈中有记录时,调用popBackStackImmediate(),该方法调用popBackStackImmediate(String name, int id, int flags)


image.png

image.png


代码1处就是处理当前FragmentManager有主导航Fragment时的返回场景。如果主导航Fragment不为空时,交由childManager处理返回。如果childMananger拦截了返回键处理则返回,否则继续让当前FragmentManager处理。具体场景,后文详解。


代码2处 popBackStackState(ArrayList records, ArrayList isRecordPop, String name, int id, int flags)的作用是将回退栈中的FragmentTransaction(BackStackRecord)放到records集合中,以备后用。


image.png

出栈分为4种情况(简单起见,id不考虑了,否则根据排列组合有8中情况)


case name POP_BACK_STACK_INCLUSIVE
case1 null 0
case2 not null 0
case3 not null 1
case4 null 1


POP_BACK_STACK_INCLUSIVE = 1时表示,根据name找到返回栈里面的BackStackRecord,一起出栈。


image.png

假设有回退栈如下。我们来走下四种case。


case->popBackStack(null,0)


image.png

image.pngimage.png

image.png

image.png

image.png

image.png



image.png

代码3处 removeRedundantOperationsAndExecute(mTmpRecords, mTmpIsPop)真正执行出栈操作。最终执行到executeOpsTogether方法。深入理解Navigation架构之Fragment基础一文有详细讲解。


4. setPrimaryNavigationFragment



经过前面那么多的铺垫,终于来到讲解本文主角setPrimaryNavigationFragment了(下文简称:“主导航Fragment”)。前文例子,我们都是基于FragmentActivity平铺Fragment场景讲解的。如果Fragment嵌套Fragment,该如何处理返回栈呢。“主导航Fragment”就是为了解决嵌套Fragment而设计的。前文讲到“Fragment必须依附在NavHostFragment上”,其实就是嵌套Fragment了。


image.png

从上图我们看到有三种角色。HostActivity,HostFragment,Child Fragment(s)。

HostFragment就是通过成为“主导航Fragment”,接管Activity的处理返回操作,并且将返回操作交由ChildFragment(s)去处理。作用可谓“承上启下”。

文字描述始终有点晦涩难懂。上场景图解。


image.png

分两种场景。


Case HostFragment
Case1 不成为主导航Fragment
Case2 成为主导航Fragment

Case1 伪代码如下


image.png

Case2 伪代码如下


image.png


返回场景如下


Case1

image.png

image.png

image.png

image.png

image.png

image.png


相关文章
|
9月前
|
SQL 前端开发 关系型数据库
如何开发一套研发项目管理系统?(附架构图+流程图+代码参考)
研发项目管理系统助力企业实现需求、缺陷与变更的全流程管理,支持看板可视化、数据化决策与成本优化。系统以MVP模式快速上线,核心功能包括需求看板、缺陷闭环、自动日报及关键指标分析,助力中小企业提升交付效率与协作质量。
|
8月前
|
数据采集 机器学习/深度学习 运维
量化合约系统开发架构入门
量化合约系统核心在于数据、策略、风控与执行四大模块的协同,构建从数据到决策再到执行的闭环工作流。强调可追溯、可复现与可观测性,避免常见误区如重回测轻验证、忽视数据质量或滞后风控。初学者应以MVP为起点,结合回测框架与实时风控实践,逐步迭代。详见相关入门与实战资料。
|
8月前
|
前端开发 JavaScript BI
如何开发车辆管理系统中的车务管理板块(附架构图+流程图+代码参考)
本文介绍了中小企业如何通过车务管理模块提升车辆管理效率。许多企业在管理车辆时仍依赖人工流程,导致违章处理延误、年检过期、维修费用虚高等问题频发。将这些流程数字化,可显著降低合规风险、提升维修追溯性、优化调度与资产利用率。文章详细介绍了车务管理模块的功能清单、数据模型、系统架构、API与前端设计、开发技巧与落地建议,以及实现效果与验收标准。同时提供了数据库建表SQL、后端Node.js/TypeScript代码示例与前端React表单设计参考,帮助企业快速搭建并上线系统,实现合规与成本控制的双重优化。
|
9月前
|
人工智能 监控 测试技术
告别只会写提示词:构建生产级LLM系统的完整架构图​
本文系统梳理了从提示词到生产级LLM产品的八大核心能力:提示词工程、上下文工程、微调、RAG、智能体开发、部署、优化与可观测性,助你构建可落地、可迭代的AI产品体系。
1143 52
|
8月前
|
机器学习/深度学习 人工智能 缓存
面向边缘通用智能的多大语言模型系统:架构、信任与编排——论文阅读
本文提出面向边缘通用智能的多大语言模型(Multi-LLM)系统,通过协同架构、信任机制与动态编排,突破传统边缘AI的局限。融合合作、竞争与集成三种范式,结合模型压缩、分布式推理与上下文优化技术,实现高效、可靠、低延迟的边缘智能,推动复杂场景下的泛化与自主决策能力。
694 3
面向边缘通用智能的多大语言模型系统:架构、信任与编排——论文阅读
|
8月前
|
人工智能 自然语言处理 安全
AI助教系统:基于大模型与智能体架构的新一代教育技术引擎
AI助教系统融合大语言模型、教育知识图谱、多模态交互与智能体架构,实现精准学情诊断、个性化辅导与主动教学。支持图文语音输入,本地化部署保障隐私,重构“教、学、评、辅”全链路,推动因材施教落地,助力教育数字化转型。(238字)
1391 23
|
9月前
|
消息中间件 数据采集 NoSQL
秒级行情推送系统实战:从触发、采集到入库的端到端架构
本文设计了一套秒级实时行情推送系统,涵盖触发、采集、缓冲、入库与推送五层架构,结合动态代理IP、Kafka/Redis缓冲及WebSocket推送,实现金融数据低延迟、高并发处理,适用于股票、数字货币等实时行情场景。
1363 3
秒级行情推送系统实战:从触发、采集到入库的端到端架构
|
9月前
|
前端开发 API 定位技术
如何开发车辆管理系统中的用车申请板块(附架构图+流程图+代码参考)
本文详细解析了如何将传统纸质车辆管理流程数字化,涵盖业务规则、审批流、调度决策及数据留痕等核心环节。内容包括用车申请模块的价值定位、系统架构设计、数据模型构建、前端表单实现及后端开发技巧,助力企业打造可落地、易扩展的车辆管理系统。
|
8月前
|
存储 人工智能 搜索推荐
拔俗AI助教系统:基于大模型与智能体架构的新一代教育技术引擎
AI助教融合大语言模型、教育知识图谱、多模态感知与智能体技术,重构“教、学、评、辅”全链路。通过微调LLM、精准诊断错因、多模态交互与自主任务规划,实现个性化教学。轻量化部署与隐私保护设计保障落地安全,未来将向情感感知与教育深度协同演进。(238字)
1032 0
|
8月前
|
机器学习/深度学习 人工智能 搜索推荐
拔俗AI学伴智能体系统:基于大模型与智能体架构的下一代个性化学习引擎
AI学伴智能体系统融合大模型、多模态理解与自主决策,打造具备思考能力的个性化学习伙伴。通过动态推理、长期记忆、任务规划与教学逻辑优化,实现千人千面的自适应教育,助力因材施教落地,推动教育公平与效率双提升。(238字)
1033 0