如何在切换ViewPager+TabLayout标签时暂停对应Fragment（不销毁）

需求背景 #

当前实现了TabLayout搭配ViewPager及FragmentPagerAdapter的结构，要求：切换至其他标签时暂停当前Fragment（仅暂停而非销毁/移除），切回该Fragment对应的标签时恢复其运行状态。需基于ViewPager和FragmentPagerAdapter修复，不使用ViewPager2、FragmentStatePagerAdapter，且避免setOffscreenPageLimit(0)。

核心思路 #

利用TabLayout的选中/未选中回调，结合Fragment的自定义暂停/恢复方法实现状态控制——FragmentPagerAdapter默认会保留相邻Fragment的实例（不会销毁），只需在Tab切换时主动通知对应Fragment执行暂停或恢复逻辑即可。

步骤与修改代码 #

1. 给DataViewFragment添加自定义暂停/恢复方法 #

在DataViewFragment中添加两个自定义方法，用于处理业务逻辑的暂停和恢复（比如停止蓝牙数据接收、暂停动画等）：

public class DataViewFragment extends Fragment {
    // 原有业务代码...

    // Tab切换离开时的暂停逻辑
    public void onPauseFragment() {
        // 示例逻辑：停止蓝牙数据读取、暂停动画等
        // if (bluetoothReader != null) bluetoothReader.stop();
        // if (dataAnimation != null) dataAnimation.pause();
    }

    // Tab切换回来时的恢复逻辑
    public void onResumeFragment() {
        // 示例逻辑：重启蓝牙数据读取、恢复动画等
        // if (bluetoothReader != null) bluetoothReader.start();
        // if (dataAnimation != null) dataAnimation.resume();
    }
}

2. 修改PagerFragment的Tab监听与生命周期逻辑 #

移除原有代码中错误的适配器清除操作，添加正确的Tab切换监听来控制Fragment状态：

public class PagerFragment extends Fragment {

    ViewPagerAdapter pagerAdapter;
    ViewPager pager;
    TabLayout tabLayout;
    int position;
    private int lastSelectedPosition = -1; // 记录上一个选中的Tab位置

    public PagerFragment() {
        super();
    }

    public void setPosition(int position) {
        this.position = position;
    }

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
    }

    @Override
    public void onPause() {
        super.onPause();
        // 页面整体暂停时，同步暂停当前显示的Fragment
        if (lastSelectedPosition != -1) {
            DataViewFragment fragment = (DataViewFragment) pagerAdapter.getItem(lastSelectedPosition);
            if (fragment != null) fragment.onPauseFragment();
        }
    }

    @Override
    public void onResume() {
        super.onResume();
        // 页面整体恢复时，同步恢复当前显示的Fragment
        if (lastSelectedPosition != -1) {
            DataViewFragment fragment = (DataViewFragment) pagerAdapter.getItem(lastSelectedPosition);
            if (fragment != null) fragment.onResumeFragment();
        }
    }

    @SuppressLint("InflateParams")
    @Override
    public View onCreateView(@NonNull LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        ViewGroup root = (ViewGroup) inflater.inflate(R.layout.fragment_pager, null);
        pagerAdapter = new ViewPagerAdapter(getChildFragmentManager());
        setPosition(position);
        pagerAdapter.setDevicesList(devicesList);
        pager = root.findViewById(R.id.pager);
        pager.setAdapter(pagerAdapter);
       
        tabLayout = root.findViewById(R.id.tab_layout);
        // 自动根据适配器的getPageTitle生成Tab，无需手动添加
        tabLayout.setupWithViewPager(pager);

        // 设置初始选中的Tab并恢复状态
        if (position >= 0 && position < devicesList.size()) {
            tabLayout.getTabAt(position).select();
            pager.setCurrentItem(position);
            lastSelectedPosition = position;
            DataViewFragment initialFragment = (DataViewFragment) pagerAdapter.getItem(position);
            if (initialFragment != null) initialFragment.onResumeFragment();
        }

        // Tab切换监听：控制Fragment的暂停/恢复
        tabLayout.addOnTabSelectedListener(new TabLayout.OnTabSelectedListener() {
            @Override
            public void onTabSelected(TabLayout.Tab tab) {
                int currentPos = tab.getPosition();
                pager.setCurrentItem(currentPos);
                // 恢复当前选中的Fragment
                DataViewFragment selectedFragment = (DataViewFragment) pagerAdapter.getItem(currentPos);
                if (selectedFragment != null) {
                    selectedFragment.onResumeFragment();
                }
                lastSelectedPosition = currentPos;
            }

            @Override
            public void onTabUnselected(TabLayout.Tab tab) {
                int unselectedPos = tab.getPosition();
                // 暂停离开的Fragment
                DataViewFragment unselectedFragment = (DataViewFragment) pagerAdapter.getItem(unselectedPos);
                if (unselectedFragment != null) {
                    unselectedFragment.onPauseFragment();
                }
            }

            @Override
            public void onTabReselected(TabLayout.Tab tab) {
                // 按需处理重新选中Tab的逻辑，比如刷新数据
            }
        });

        // 移除重复的联动监听（setupWithViewPager已自动绑定）
        // tabLayout.addOnTabSelectedListener(new TabLayout.ViewPagerOnTabSelectedListener(pager));
        return root;
    }
}

3. 修正ViewPagerAdapter的逻辑 #

移除不必要的clear()方法调用（避免销毁Fragment实例），优化空判断：

public class ViewPagerAdapter extends FragmentPagerAdapter  {

    ArrayList<ConnectedBluetoothDevice> devicesList;
    ArrayList<DataViewFragment> dataViewFragments;

    public ViewPagerAdapter(FragmentManager fm) {
        super(fm);
    }

    public void setDevicesList(ArrayList<ConnectedBluetoothDevice> devicesList) {
        this.devicesList = devicesList;
        dataViewFragments = new ArrayList<>();
        for (int i = 0; i < devicesList.size(); i++) {
            dataViewFragments.add(new DataViewFragment(devicesList.get(i)));
        }
    }

    @NonNull
    public Fragment getItem(int position) {
        if (dataViewFragments != null && position < dataViewFragments.size()) {
            return dataViewFragments.get(position);
        } else {
            return new DataViewFragment(null);
        }
    }

    @Override
    public int getCount() {
        return devicesList == null ? 0 : devicesList.size();
    }

    public CharSequence getPageTitle(int position) {
        return devicesList.get(position).getName();
    }

    // 移除或注释掉clear方法，避免误操作销毁Fragment
    // public void clear() {
    //     dataViewFragments.clear();
    // }
}

关键说明 #

• 自定义状态方法：系统的onPause()/onResume()是针对页面整体生命周期，而我们需要的是Tab切换时的状态变化，因此自定义方法更精准。
• FragmentPagerAdapter特性：默认会保留当前页面左右各1个Fragment实例（可通过setOffscreenPageLimit()调整，但这里无需修改），确保Fragment不会被销毁，仅需控制状态。
• 避免重复操作：移除手动添加Tab和重复的联动监听，利用setupWithViewPager()自动完成Tab与ViewPager的绑定。

内容的提问来源于stack exchange，提问作者vel