UserVisibleHint 在 FragmentStatePagerAdapter 管理的选定 ViewPager 片段上为假

Question

我在 Android 应用中遇到了一个非常难以诊断的问题。 getUserVisibleHint() 在ViewPager 中的当前选定片段上返回false，它应该返回true（因为它是可见的并且被选中）。

我已将我看到此行为的实例描述如下：

• 片段被选中，当前显示在ViewPager
• ViewPager 由FragmentStatePagerAdapter 管理
• 片段之前被选中，它的状态被保存，后来由PagerAdapter恢复
  • viewpager 中至少有 3 个标签
  • 用户导航到选项卡 3，然后导航到选项卡 1，然后返回到选项卡 3。
• 应用使用支持库版本 24.0.0 或更高版本

Answer 1

调试显示FragmentStatePagerAdapter实际上在setPrimaryItem(ViewGroup container, int position, Object object)中正确设置了选定选项卡的状态，但后来在FragmentManager#moveToState(Fragment f, int newState, int transit, int transitionStyle, boolean keepActive)中设置为false

//from FragmentManager#moveToState(Fragment f, int newState, int transit, int transitionStyle, boolean keepActive)
f.mUserVisibleHint = f.mSavedFragmentState.getBoolean(
        FragmentManagerImpl.USER_VISIBLE_HINT_TAG, true);

上面的f.mSavedFragmentState已将可见状态保存为false，因为它是在片段不再出现在屏幕上时保存的。

所以这里的问题是状态丢失；可见状态在FragmentStatePagerAdapter#setPrimaryItem 中设置，但在调用片段的onResume 方法之前丢失了一段时间。

修复

在库中修复此错误之前，请覆盖您的 PagerAdapter 中的 setPrimaryItem 并强制所有未决事务首先提交。

public static class SectionsPagerAdapter extends FragmentStatePagerAdapter {
    public SectionsPagerAdapter(FragmentManager fm) {
        super(fm);
    }

    @Override
    public void setPrimaryItem(ViewGroup container, int position, Object object) {
        //Force any pending transactions to save before we set an item as primary
        finishUpdate(null);
        super.setPrimaryItem(container, position, object);
    }

    @Override
    public Fragment getItem(int position) {
        Fragment fragment = new DummySectionFragment();
        Bundle args = new Bundle();
        args.putInt(DummySectionFragment.ARG_SECTION_NUMBER, position + 1);
        fragment.setArguments(args);
        return fragment;
    }

    @Override
    public int getCount() {
        return 4;
    }

    @Override
    public CharSequence getPageTitle(int position) {
        return "Page " + (position + 1);
    }
}

要解决此问题，FragmentStatePagerAdapter 必须在设置用户可见提示之前提交任何片段事务。

FragmentStatePagerAdapter

只是为了展示FragmentStatePagerAdapter内部发生的事情

@Override
public Object instantiateItem(ViewGroup container, int position) {
    // If we already have this item instantiated, there is nothing
    // to do.  This can happen when we are restoring the entire pager
    // from its saved state, where the fragment manager has already
    // taken care of restoring the fragments we previously had instantiated.
    if (mFragments.size() > position) {
        Fragment f = mFragments.get(position);
        if (f != null) {
            return f;
        }
    }

    if (mCurTransaction == null) {
        mCurTransaction = mFragmentManager.beginTransaction();
    }

    Fragment fragment = getItem(position);
    if (DEBUG) Log.v(TAG, "Adding item #" + position + ": f=" + fragment);
    if (mSavedState.size() > position) {
        Fragment.SavedState fss = mSavedState.get(position);
        if (fss != null) {
            fragment.setInitialSavedState(fss);
        }
    }
    while (mFragments.size() <= position) {
        mFragments.add(null);
    }
    fragment.setMenuVisibility(false);
    fragment.setUserVisibleHint(false);
    mFragments.set(position, fragment);
    mCurTransaction.add(container.getId(), fragment);

    return fragment;
}

@Override
public void setPrimaryItem(ViewGroup container, int position, Object object) {
    Fragment fragment = (Fragment)object;
    if (fragment != mCurrentPrimaryItem) {
        if (mCurrentPrimaryItem != null) {
            mCurrentPrimaryItem.setMenuVisibility(false);
            mCurrentPrimaryItem.setUserVisibleHint(false);
        }
        if (fragment != null) {
            fragment.setMenuVisibility(true);
            fragment.setUserVisibleHint(true);
        }
        mCurrentPrimaryItem = fragment;
    }
}

@Override
public void finishUpdate(ViewGroup container) {
    if (mCurTransaction != null) {
        mCurTransaction.commitNowAllowingStateLoss();
        mCurTransaction = null;
    }
}

Answer 2

如果它与您的项目兼容，请尝试版本 27.1.1（或更新）的支持库。 related bug report 于 2018 年 2 月下旬被标记为已修复，27.1.1 版本于 2018 年 4 月发布。