美文网首页Android Other
Jetpack MVVM 常见错误一:使用 Fragment 作

Jetpack MVVM 常见错误一:使用 Fragment 作

作者: fundroid | 来源:发表于2022-03-17 10:48 被阅读0次

    Fragment 作为 LifecycleOwner 的问题

    MVVM 的核心是数据驱动UI,在 Jetpack 中,这一思想体现在以下场景:Fragment 通过订阅 ViewModel 中的 LiveData 以驱动自身 UI 的更新

    关于订阅的时机,一般会选择放到 onViewCreated 中进行,如下:

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
            super.onViewCreated(view, savedInstanceState)
    
            viewModel.liveData.observe(this) { // Warning : Use fragment as the LifecycleOwner
               updateUI(it) 
            } 
    
    }
    

    我们知道订阅 LiveData 时需要传入 LifecycleOwner 以防止泄露,此时一个容易犯的错误是使用 Fragment 作为这个 LifecycleOwner,某些场景下会造成重复订阅的Bug。

    做个实验如下:

    val handler = Handler(Looper.getMainLooper())
    
    class MyFragment1 : Fragment() {
        val data = MutableLiveData<Int>()
    
        override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
            super.onViewCreated(view, savedInstanceState)
    
            tv.setOnClickListener {
                parentFragmentManager.beginTransaction()
                    .replace(R.id.container, MyFragment2())
                    .addToBackStack(null)
                    .commit()
                    
                handler.post{ data.value = 1 }
            }
            
            data.observe(this, Observer {
                Log.e("fragment", "count: ${data.value}")
            })
    
    }
    

    当跳转到 MyFragment2 然后再返回 MyFragment1 中时,会打出输出两条log

    E/fragment: count: 1
    E/fragment: count: 1
    

    原因分析

    LiveData 之所以能够防止泄露,是当 LifecycleOwner 生命周期走到 DESTROYED 的时候会 remove 调其关联的 Observer

    //LiveData.java
    
    @Override
    public void onStateChanged(LifecycleOwner source, Lifecycle.Event event) {
       if (mOwner.getLifecycle().getCurrentState() == DESTROYED) {
              removeObserver(mObserver);
              return;
       }
       activeStateChanged(shouldBeActive());
       
    }
    

    前面例子中,基于 FragmentManager#replace 的页面跳转,使得 MyFragment1 发生了从 BackStack 的出栈/入栈,由于 Framgent 实例被复用并没有发生 onDestroy, 但是 Fragment的 View 的重建导致重新 onCreateView, 这使得 Observer 被 add 了两次,但是没有对应的 remove。

    所以归其原因, 是由于 Fragment 的 Lifecycle 与 Fragment#mView 的 Lifecycle 不一致导致我们订阅 LiveData 的时机和所使用的 LivecycleOwner 不匹配,所以在任何基于 replace 进行页面切换的场景中,例如 ViewPager、Navigation 等会发生上述bug

    解决方法

    明白了问题原因,解决思路也就清楚了:必须要保证订阅的时机和所使用的LifecycleOwner相匹配,即要么调整订阅时机,要么修改LifecycleOwner

    在 onCreate 中订阅

    思路一是修改订阅时机,讲订阅提前到 onCreate, 可以保证与 onDestory 的成对出现,但不幸的是这会带来另一个问题。

    当 Fragment 出入栈造成 View 重建时,我们需要重建后的 View 也能显示最新状态。但是由于 onCreate 中的订阅的 Observer 已经获取过 LiveData 的最新的 Value,如果 Value 没有新的变化是无法再次通知 Obsever 的

    在 LiveData 源码中体现在通知 Obsever 之前对 mLastVersion 的判断:

    //LiveData.java
    
        private void considerNotify(ObserverWrapper observer) {
            if (!observer.mActive) {
                return;
            }
             
            if (!observer.shouldBeActive()) {
                observer.activeStateChanged(false);
                return;
            }
            if (observer.mLastVersion >= mVersion) {// Value已经处于最新的version
                return;
            }
            
            observer.mLastVersion = mVersion;
            //noinspection unchecked
            observer.mObserver.onChanged((T) mData);
        }
    

    正是为了保证重建后的 View 也能刷新最新的数据, 我们才在 onViewCreated 中完成订阅。因此只能考虑另一个思路,替换 LifecycleOwner

    使用 ViewLifecycleOwner

    Support-28 或 AndroidX-1.0.0 起,Fragment 新增了 getViewLifecycleOwner 方法。顾名思义,它返回一个与 Fragment#mView 向匹配的 LifecycleOwner,可以在 onDestroyView 的时候走到 DESTROYED ,删除 onCreateView 中注册的 Observer, 保证了 add/remove 的成对出现。

    看一下源码,原理非常简单

    //Fragment.java
    void performCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container,
                @Nullable Bundle savedInstanceState) {
            //...
            
            mViewLifecycleOwner = new LifecycleOwner() {
                @Override
                public Lifecycle getLifecycle() {
                    if (mViewLifecycleRegistry == null) {
                        mViewLifecycleRegistry = new LifecycleRegistry(mViewLifecycleOwner);
                    }
                    return mViewLifecycleRegistry;
                }
            };
            mViewLifecycleRegistry = null;
            mView = onCreateView(inflater, container, savedInstanceState);
            if (mView != null) {
                // Initialize the LifecycleRegistry if needed
                mViewLifecycleOwner.getLifecycle();
               // Then inform any Observers of the new LifecycleOwner
                mViewLifecycleOwnerLiveData.setValue(mViewLifecycleOwner); //mViewLifecycleOwnerLiveData在后文介绍
            } else {
                //...
            }
        }
    

    基于 mViewLifecycleRegistry 创建 mViewLifecycleOwner,

         @CallSuper
        public void onViewStateRestored(@Nullable Bundle savedInstanceState) {// called when onCreateView
            if (mView != null) {
                mViewLifecycleRegistry.handleLifecycleEvent(Lifecycle.Event.ON_CREATE);
            }
        }
        
        
         @CallSuper
        public void onDestroyView() {
            if (mView != null) {
                mViewLifecycleRegistry.handleLifecycleEvent(Lifecycle.Event.ON_DESTROY);
            }
        }
    

    然后在 onCreateViewonDestroyView 时,推进到合适的生命周期。

    getViewLifecycleOwnerLiveData

    顺道提一下,与 getViewLifecycleOwner 同时新增的还有 getViewLifecycleOwnerLiveData。 从前面贴的源码中对 mViewLifecycleOwnerLiveData 的使用,应该可以猜出它的作用: 它是前文讨论的思路1的实现方案,即使在 onCreate 中订阅,由于在 onCreateView 中对 LiveData 进行了重新设置,所以重建后的 View 也可以更新数据。

      // Then inform any Observers of the new LifecycleOwner
      mViewLifecycleOwnerLiveData.setValue(mViewLifecycleOwner);
    

    需要特别注意的是,根据 MVVM 最佳实践,我们希望由 ViewModel 而不是 Fragment 持有 LiveData,所以不再推荐使用 getViewLifecycleOwnerLiveData

    最后: StateFlow 与 lifecycleScope

    前面都是以 LiveData 为例介绍对 ViewLifecycleOwner 的使用, 如今大家也越来越多的开始使用协程的 StateFlow , 同样要注意不要错用 LifecycleOwner

    订阅 StateFlow 需要 CoroutineScope, AndroidX 提供了基于 LifecycleOwner 的扩展方法

    val LifecycleOwner.lifecycleScope: LifecycleCoroutineScope
        get() = lifecycle.coroutineScope
    

    当我们在 Fragment 中获取 lifecycleScope 时,切记要使用 ViewLifecycleOwner

    class MyFragment : Fragment() {
    
        val viewModel: MyViewModel by viewModel()
    
        override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
            super.onViewCreated(view, savedInstanceState)
    
            //使用 viewLifecycleOwner 的 lifecycleScope
            viewLifecycleOwner.lifecycleScope.launch {
                viewLifecycleOwner.repeatOnLifecycle(Lifecycle.State.STARTED) {
                    viewModel.someDataFlow.collect {
                        updateUI(it)
                    }
                }
            }
        }
    }
    

    注意此处出现了一个 repeatOnLifecycle(...), 这跟本文无关,但是将涉及到第二宗罪的剧情,敬请期待。

    相关文章

      网友评论

        本文标题:Jetpack MVVM 常见错误一:使用 Fragment 作

        本文链接:https://www.haomeiwen.com/subject/illvdrtx.html