Android 实现单Activity多Fragment页面项目

前言

  以往项目都是多Activity实现,总体实现很方便。但是现在流行使用单Activity+多Fragment的形式实现项目,例如比较流行的Navigation基本可以满足,但是有时候会存在从一个页面跳转到另一个页面并且回传数据的问题,Navigation组件的话内部实现原理是使用replace()方式添加Fragment,这样会导致两个问题,第一个是每次切换Fragment都会重建,第二是无法做到数据的回传,网上也有一些针对此问题的解决方案。本文并不打算使用Navigation实现,而是通过使用Results API的方式。

Fragment通信

  今年 Google 推出了 Fragment Result API 和 Activity Results API,用来取代之前的 Activity 和 Fragment 之间通信方式的不足。Fragment Result API 主要介绍 Fragment 间通信的新方式,是在 Fragment 1.3.0-alpha04 新增加的 API ,而现在最新版本已经到 fragment-1.3.0-beta01 应该很快就能应用在项目里面了。本文就是通过Result API实现Fragment之间的通信。

接受数据

在需要接受数据的Fragment里面注册setFragmentResultListener()监听

FragmentManager.setFragmentResultListener(
    requestKey,
    lifecycleOwner,
    FragmentResultListener { requestKey: String, result: Bundle ->
        // Handle result
    })

参数解释:
requestKey :请求跳转到另一个fragment的字符串key
lifecycleOwner:生命周期观察者
FragmentResultListener :fragment结果回到监听

发送数据

当前fragment想把数据传递给上一个页面,则需要通过设置setFragmentResult()方法设置数据,

parentFragmentManager.setFragmentResult(
    requestKey, // Same request key FragmentA used to register its listener
    bundleOf(key to value) // The data to be passed to FragmentA
)

参数解释:
requestKey :请求跳转到另一个fragment的字符串key
Bundle:用于传递回调结果的bundle

Fragment携带数据跳转

  如果此次Fragment是做携带数据的跳转则必须携带requestKey,requestKey与设置回调数据时候使用同一个requestKey,因为想把回调封装进跳转的参数中,因此resultCallback充当Fragment回到结果的监听回调。

 /**
     * fragment中添加fragment(replace方式)
     * @param target Fragment 目标fragment
     * @param requestKey String 请求key
     * @param args Bundle 携带参数
     * @param resultCallback FragmentResultListener 跳转结果回调
     */
    fun startForResult(target: Fragment, requestKey: String, args: Bundle? = null, resultCallback: FragmentResultListener) {
        val targetArgs: Bundle = args ?: Bundle()
        targetArgs.putString(REQUEST_KEY, requestKey)
        target.arguments = targetArgs
        manager.beginTransaction()
            .setReorderingAllowed(true)
            .add(R.id.fragment_root, target)
            .addToBackStack(tag ?: target.javaClass.simpleName)
            .commit()
        target.setFragmentResultListener(requestKey) { it, bundle ->
            resultCallback.onFragmentResult(it, bundle)
        }
    }

BaseFragment封装

  关于ViewBinding和ViewModel的封装在前一篇文章已经讲了。对于ViewModel的封装当初公司有人提议是每个Fragment必须去实现一个ViewModel,如果没有则使用通用的EmptyViewModel代替,这样考虑是为了不让代码中出现太多?空校验,这一块看自己决定。整个BaseFragment代码如下:

abstract class BaseFragment<ViewModelLazy : ViewModel, Binding : ViewBinding> : Fragment(), View.OnClickListener {

    protected lateinit var TAG: String
    protected lateinit var ctx: AppCompatActivity
    protected lateinit var binding: Binding
    protected lateinit var manager: FragmentManager
    protected var requestKey: String? = null
    protected var viewModel: ViewModelLazy? = null

    companion object {
        const val REQUEST_KEY = "requestKey"
    }

    override fun onAttach(context: Context) {
        super.onAttach(context)
        this.ctx = context as AppCompatActivity
        TAG = this::class.java.simpleName
        manager = ctx.supportFragmentManager
    }

    override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?,
    ): View? {
        Log.e(TAG, "fragment_onCreateView")
        viewModel = bindViewModel()
        arguments?.let { bindBundle(it) }
        binding = bindLayout()
        initView()
        initData()
        bindObserver()
        bindListener()
        return binding.root
    }

    /**
     * 绑定ViewModel
     * @return ViewModelLazy
     */
    open fun bindViewModel(): ViewModelLazy? = null

    /**
     * 绑定intent
     * @param bundle Bundle
     */
    open fun bindBundle(bundle: Bundle) {
        requestKey = bundle.getString(REQUEST_KEY)
    }

    /**
     * 绑定布局
     * @return View
     */
    abstract fun bindLayout(): Binding

    /**
     * 初始化view
     */
    open fun initView() {

    }

    /**
     * 初始化数据
     */
    open fun initData() {

    }

    /**
     * 重新加载
     */
    open fun onReload() {

    }

    /**
     * 绑定observer
     */
    open fun bindObserver() {

    }

    /**
     * 绑定监听
     */
    open fun bindListener() {

    }

    /**
     * 监听回调
     * @param v View
     */
    override fun onClick(v: View?) {

    }

    /**
     * ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
     * +++++++++++++++++++++++++++++++++++++++++++++++++fragment回传数据++++++++++++++++++++++++++++++++
     * ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
     */
    /**
     * 设置回传fragment数据
     * @param args Bundle
     */
    fun onBackResult(args: Bundle) {
        requestKey?.let {
            setFragmentResult(it, args)
            manager.popBackStack()
        }
    }

    interface FragmentResultListener {
        /**
         * Callback used to handle results passed between fragments.
         *
         * @param requestKey key used to store the result
         * @param result result passed to the callback
         */
        fun onFragmentResult(requestKey: String, result: Bundle)
    }


    /**
     * ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
     * +++++++++++++++++++++++++++++++++++++++++++++++++页面跳转++++++++++++++++++++++++++++++++++++++++
     * ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
     */
    /**
     * fragment中添加fragment(add方式)
     * @param target Fragment
     * @param args Bundle
     */
    fun start(target: Fragment, args: Bundle? = null) {
        args?.let {
            target.arguments = it
        }
        manager.beginTransaction()
            .setReorderingAllowed(true)
            .add(R.id.fragment_root, target)
            .addToBackStack(target.javaClass.simpleName)
            .commit()
    }

    /**
     * fragment中添加fragment(add方式)
     * @param target Fragment
     * @param args Bundle
     */
    fun start(target: String, args: Bundle? = null) {
        val navigation = ARouter.getInstance().build(target).navigation() as BaseFragment<*, *>
        args?.let {
            navigation.arguments = it
        }
        manager.beginTransaction()
            .setReorderingAllowed(true)
            .add(R.id.fragment_root, navigation)
            .addToBackStack(target.javaClass.simpleName)
            .commit()
    }

    /**
     * fragment中添加fragment(replace方式)
     * @param target Fragment
     * @param args Bundle
     */
    fun replace(target: Fragment, args: Bundle? = null) {
        args?.let {
            target.arguments = it
        }
        manager.beginTransaction()
            .setReorderingAllowed(true)
            .replace(R.id.fragment_root, target)
            .addToBackStack(target.javaClass.simpleName)
            .commit()
    }

    /**
     * fragment中添加fragment(replace方式)
     * @param target Fragment
     * @param args Bundle
     */
    fun startRoot(target: Fragment, args: Bundle? = null) {
        args?.let {
            target.arguments = it
        }
        clearFragmentStack()
        manager.beginTransaction()
            .setReorderingAllowed(true)
            .replace(R.id.fragment_root, target)
            .addToBackStack(target.javaClass.simpleName)
            .commit()
    }

    /**
     * fragment中添加fragment(replace方式)
     * @param target Fragment 目标fragment
     * @param requestKey String 请求key
     * @param args Bundle 携带参数
     * @param resultCallback FragmentResultListener 跳转结果回调
     */
    fun startForResult(target: Fragment, requestKey: String, args: Bundle? = null, resultCallback: FragmentResultListener) {
        val targetArgs: Bundle = args ?: Bundle()
        targetArgs.putString(REQUEST_KEY, requestKey)
        target.arguments = targetArgs
        manager.beginTransaction()
            .setReorderingAllowed(true)
            .add(R.id.fragment_root, target)
            .addToBackStack(tag ?: target.javaClass.simpleName)
            .commit()
        target.setFragmentResultListener(requestKey) { it, bundle ->
            resultCallback.onFragmentResult(it, bundle)
        }
    }

    /**
     * 清空当前栈所有fragment
     */
    private fun clearFragmentStack() {
        val count: Int = manager.backStackEntryCount
        if (count > 0) {
            val entry: FragmentManager.BackStackEntry =
                manager.getBackStackEntryAt(0)
            manager.popBackStack(
                entry.name,
                FragmentManager.POP_BACK_STACK_INCLUSIVE
            )
        }
    }

    /**
     * 退出当前的fragment
     */
    fun onBackPressed() {
        manager.popBackStack()
    }

    /**
     * ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
     * +++++++++++++++++++++++++++++++++++++++++++++++++生命周期++++++++++++++++++++++++++++++++++++++++
     * ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
     */
    override fun onResume() {
        super.onResume()
        Log.d(TAG, "fragment_onResume")
    }

    override fun onPause() {
        super.onPause()
        Log.d(TAG, "fragment_onPause")
    }

    override fun onStart() {
        super.onStart()
        Log.d(TAG, "fragment_onStart")
    }

    override fun onStop() {
        super.onStop()
        Log.d(TAG, "fragment_onStop")
    }

    override fun onDestroy() {
        super.onDestroy()
        Log.d(TAG, "fragment_onDestroy")
    }

    override fun onDestroyView() {
        super.onDestroyView()
        Log.d(TAG, "fragment_onDestroyView")
    }

    override fun onDetach() {
        super.onDetach()
        Log.d(TAG, "fragment_onDetach")
    }
}

总结

  如上封装的其实也是不够完善的,但是总体可以实现单Activity+多Fragment模式的项目,并且不需要引用第三方框架,当然上面也封装了关于使用Arouter路由的方式实现组件化的Fragment通信方式。通过上面的方式写了demo,具体实现可参考demo。
Needle: 单Activity+多Fragment模式创建项目 (gitee.com)

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,835评论 4 364
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,598评论 1 295
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,569评论 0 244
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,159评论 0 213
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,533评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,710评论 1 222
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,923评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,674评论 0 203
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,421评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,622评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,115评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,428评论 2 254
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,114评论 3 238
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,097评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,875评论 0 197
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,753评论 2 276
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,649评论 2 271

推荐阅读更多精彩内容