「译」Google 最新发布了 Fragment 的新特性 Fragment 间传递数据的新方式 以及源码分析
- 如果评论区没有及时回复,欢迎来公众号:ByteCode 咨询
- 公众号:ByteCode。致力于分享最新技术原创文章,涉及 Kotlin、Jetpack、算法、译文、系统源码相关的文章
前言
- 原标题: Android Fragments: Fragment Result
- 原地址: https://proandroiddev.com/android-fragments-fragment-result……
- 原作者: Husayn Hakeem
- 译者:hi-dhl
- 本文已收录于仓库 Technical-Article-Translation
就在 2020/05/07 号 Now in Android #17 更新了,发布 Android 的新特性,其中就包括 Fragment 间通信的新方式,大家可以点击这里前往,看看都有那些更新
通过这篇文章你将学习到以下内容,将在译者思考部分会给出相应的答案
- 新 Fragment 间通信的方式的使用?
- 新 Fragment 间通信的源码分析?
- 汇总 Fragment 之间的通信的方式?
译文
Frrgament 间传递数据可以通过多种方式,包括使用 target Fragment APIs (Fragment.setTargetFragment() 和 Fragment.getTargetFragment()),ViewModel 或者 使用 Fragments’ 父容器 Activity,target Fragment APIs 已经过时了,现在鼓励使用新的 Fragment result APIs 完成 Frrgament 之间传递数据,其中传递数据由 FragmentManager 处理,并且在 Fragments 设置发送数据和接受数据
在 Frrgament 之间传递数据
使用新的 Fragment APIs 在 两个 Frrgament 之间的传递,没有任何引用,可以使用它们公共的 FragmentManager,它充当 Frrgament 之间传递数据的中心存储。
接受数据
如果想在 Fragment 中接受数据,可以在 FragmentManager 中注册一个 FragmentResultListener,参数 requestKey 可以过滤掉 FragmentManager 发送的数据
FragmentManager.setFragmentResultListener( |
参数 lifecycleOwner 可以观察生命周期,当 Fragment 的生命周期处于 STARTED 时接受数据。如果监听 Fragment 的生命周期,您可以在接收到新数据时安全地更新 UI,因为 view 的创建(onViewCreated() 方法在 onStart() 之前被调用)。
当生命周期处于 LifecycleOwner STARTED 的状态之前,如果有多个数据传递,只会接收到最新的值
当生命周期处于 LifecycleOwner DESTROYED 时,它将自动移除 listener,如果想手动移除 listener,需要调用 FragmentManager.setFragmentResultListener() 方法,传递空的 FragmentResultListener
在 FragmentManager 中注册 listener,依赖于 Fragment 发送返回的数据
- 如果在 FragmentA 中接受 FragmentB 发送的数据,FragmentA 和 FragmentB 处于相同的层级,通过 parent FragmentManager 进行通信,FragmentA 必须使用 parent FragmentManager 注册 listener
parentFragmentManager.setFragmentResultListener(...) |
- 如果在 FragmentA 中接受 FragmentB 发送的数据,FragmentA 是 FragmentB 的父容器, 他们通过 child FragmentManager 进行通信
childFragmentManager.setFragmentResultListener(...) |
listener 必须设置的Fragment 相同的 FragmentManager
发送数据
如果 FragmentB 发送数据给 FragmentA,需要在 FragmentA 中注册 listener,通过 parent FragmentManager 发送数据
parentFragmentManager.setFragmentResult( |
测试 Fragment Results
测试 Fragment 是否成功接收或发送数据,可以使用 FragmentScenario API
接受数据
如果在 FragmentA 中注册 FragmentResultListener 接受数据,你可以模拟 parent FragmentManager 发送数据,如果在 FragmentA 中正确注册了 listener,可以用来验证 FragmentA 是否能收到数据,例如,如果在 FragmentA 中接受数据并更新 UI, 可以使用 Espresso APIs 来验证是否期望的数据
@Test |
发送数据
可以在 FragmentB 的 parent FragmentManager 上注册一个 FragmentResultListener 来测试 FragmentB 是否成功发送数据,当发送数据结束时,可以来验证这个 listener 是否能收到数据
@Test |
示例项目
下面的示例项目,展示了如何使用 Fragment 新的 API
android-playground: https://github.com/husaynhakeem/android-playground…
总结
虽然使用了 Fragment result APIs,替换了过时的 Fragment target APIs,但是新的 APIs 在Bundle 作为数据传传递方面有一些限制,只能传递简单数据类型、Serializable 和 Parcelable 数据,Fragment result APIs 允许程序从崩溃中恢复数据,而且不会持有对方的引用,避免当 Fragment 处于不可预知状态的时,可能发生未知的问题
译者的思考
这是译者的一些思考,总结一下 Fragment 1.3.0-alpha04 新增加的 Fragment 间通信的 API
数据接受
FragmentManager.setFragmentResultListener( |
数据发送
parentFragmentManager.setFragmentResult( |
那么 Fragment 间通信的新 API 给我们带来哪些好处呢:
- 在 Fragment 之间传递数据,不会持有对方的引用
- 当生命周期处于 ON_START 时开始处理数据,避免当 Fragment 处于不可预知状态的时,可能发生未知的问题
- 当生命周期处于 ON_DESTROY 时,移除监听
我们一起来从源码的角度分析一下 Google 是如何做的
源码分析
按照惯例从调用的方法来分析,数据接受时,调用了 FragmentManager 的 setFragmentResultListener 方法
androidx.fragment/fragment/1.3.0-alpha04……androidx/fragment/app/FragmentManager.java
private final ConcurrentHashMap<String, LifecycleAwareResultListener> mResultListeners = |
- Lifecycle是一个生命周期感知组件,一般用来响应Activity、Fragment等组件的生命周期变化
- 获取 Lifecycle 去监听 Fragment 的生命周期的变化
- 当生命周期处于 ON_START 时开始处理数据,避免当 Fragment 处于不可预知状态的时,可能发生未知的问题
- 当生命周期处于 ON_DESTROY 时,移除监听
接下来一起来看一下数据发送的方法,调用了 FragmentManager 的 setFragmentResult 方法
androidx.fragment/fragment/1.3.0-alpha04……androidx/fragment/app/FragmentManager.java
private final ConcurrentHashMap<String, Bundle> mResults = new ConcurrentHashMap<>(); |
- 获取 requestKey 注册的 listener
- 当生命周期处于 STARTED 状态时,开始发送数据
- 否则保存当前传输的数据
源码分析到这里结束了,我们一起来思考一下,在之前我们的都有那些数据传方式
汇总 Fragment 之间的通信的方式
- 通过共享 ViewModel 或者关联 Activity来完成,Fragment 之间不应该直接通信 参考 Google: ViewModel#sharing
- 通过接口,可以在 Fragment 定义接口,并在 Activity 实现它 参考 Google: 与其他 Fragment 通信
- 通过使用 findFragmentById 方法,获取 Fragment 的实例,然后调用 Fragment 的公共方法 参考 Google: 与其他 Fragment 通信
- 调用 Fragment.setTargetFragment() 和 Fragment.getTargetFragment() 方法,但是注意 target fragment 需要直接访问另一个 fragment 的实例,这是十分危险的,因为你不知道目标 fragment 处于什么状态
- Fragment 新的 API, setFragmentResult() 和 setFragmentResultListener()
综合以上通信方式,那么你认为 Fragment 之间通信最好的方式是什么?
参考文献
- Now in Android #17: https://medium.com/androiddeve……
- Pass data between fragments: https://developer.android.com/training/basi……
- ViewModel#sharing: https://developer.android.com/topic/librari……
- 与其他 Fragment 通信: https://developer.android.com/training/basic……
推荐文章
- 本文作者:hi-dhl
- 本文标题:「译」Google 最新发布了 Fragment 的新特性 Fragment 间传递数据的新方式 以及源码分析
- 本文链接:https://hi-dhl.com/2020/06/10/translate/01-fragment/
- 版权声明:本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自 hi-dhl