Kotlin FragmentTransaction多容器管理多个fragment

在Activity中管理五个Fragment的切换显示和隐藏，并且希望将这部分逻辑进行封装。之前已经教过他们如何在Kotlin中使用FragmentTransaction进行基本的添加、隐藏、显示和替换操作，现在需要进一步封装这些操作，提高代码的可维护性和复用性。

管理五个Fragment，可能需要在不同的情况下切换显示不同的Fragment，同时隐藏其他的。之前给出的例子是两个Fragment的情况，现在扩展到五个，需要考虑如何高效管理多个实例，避免重复创建和内存泄漏。

希望有个结构化的方式，将Fragment的管理逻辑集中起来，而不是在Activity中分散处理。可能需要一个工具类或者辅助类来负责处理Fragment的切换，这样Activity的代码会更简洁。

需要考虑到Fragment的添加、显示、隐藏、查找等操作。可能需要一个容器ID，通常是Activity中的一个FrameLayout，作为Fragment的容器。另外，需要保存所有已添加的Fragment的引用，以便后续快速切换，而不必每次都重新添加。

可能的实现步骤：

创建一个FragmentManagerHelper类，接收Activity的supportFragmentManager和容器ID。
维护一个Map或者List来保存已经添加的Fragment实例，使用Tag作为键，方便查找。
提供切换Fragment的方法，比如switchFragment，参数是目标Fragment的Tag。
在切换时，检查目标Fragment是否已经添加，如果未添加则add并显示，同时隐藏其他Fragment；如果已添加，则直接显示并隐藏其他。
处理回退栈，可能需要addToBackStack，但用户是否需要保留每个切换操作的回退需要确认。
考虑Fragment的懒加载，可以在显示时触发相关生命周期方法。
确保线程安全，使用commitNow或者commitAllowingStateLoss，根据具体情况选择。

需要解决的关键点：

如何高效管理多个Fragment的实例，避免重复创建。
如何快速切换显示和隐藏，保持界面流畅。
如何封装成独立的类，减少Activity的代码量。
处理可能的异常情况，比如Fragment已经不在容器中。

切换时带有动画效果，或者支持自定义的过渡动画。

可能遇到的问题：

使用show/hide时，Fragment的生命周期不会触发onPause或onResume，需要用户自己处理数据的加载和释放。
回退栈的管理，如果用户按返回键，可能需要回到上一个Fragment的状态，这时候需要正确添加事务到回退栈。

在封装时，可以提供一个Helper类，内部使用事务来管理所有操作，对外暴露简单的方法如switchFragment(tag)，并且处理所有隐藏和显示的逻辑。同时，可以提供一个接口或回调，当Fragment切换时通知Activity进行其他操作，比如更新标题栏等。

最后，测试不同场景下的Fragment切换，确保没有内存泄漏，所有Fragment正确显示和隐藏，回退栈工作正常。

在 Activity 中管理多个 Fragment 的切换时，可以通过以下封装方案提升代码复用性和可维护性：

封装工具类 `FragmentManagerHelper`

复制代码

class FragmentManagerHelper(
    private val fragmentManager: FragmentManager,
    private val containerId: Int
) {
    // 存储已添加的 Fragment 实例
    private val fragments = mutableMapOf<String, Fragment>()
    private var currentTag: String? = null

    /**
     * 切换 Fragment
     * @param targetTag 目标 Fragment 的标识
     * @param allowStateLoss 是否允许状态丢失（用于特殊场景）
     */
    fun switchFragment(targetTag: String, allowStateLoss: Boolean = false) {
        val transaction = fragmentManager.beginTransaction()
        val currentFragment = currentTag?.let { fragments[it] }

        // 如果目标 Fragment 未添加过
        if (!fragments.containsKey(targetTag)) {
            val newFragment = createFragment(targetTag) // 工厂方法创建实例
            fragments[targetTag] = newFragment
            transaction.add(containerId, newFragment, targetTag)
        }

        // 隐藏当前 Fragment
        currentFragment?.let { transaction.hide(it) }

        // 显示目标 Fragment
        val targetFragment = fragments[targetTag]!!
        transaction.show(targetFragment)
        
        // 加入回退栈（可选）
        transaction.addToBackStack(targetTag)
        
        currentTag = targetTag
        
        // 提交事务
        if (allowStateLoss) {
            transaction.commitAllowingStateLoss()
        } else {
            transaction.commit()
        }
    }

    /**
     * 获取当前显示的 Fragment
     */
    fun getCurrentFragment(): Fragment? {
        return currentTag?.let { fragments[it] }
    }

    /**
     * 创建 Fragment 的工厂方法（需根据业务实现）
     */
    private fun createFragment(tag: String): Fragment {
        return when (tag) {
            "Home" -> HomeFragment()
            "Profile" -> ProfileFragment()
            "Settings" -> SettingsFragment()
            "Notifications" -> NotificationsFragment()
            "Messages" -> MessagesFragment()
            else -> throw IllegalArgumentException("Unknown fragment tag: $tag")
        }
    }
}

在 Activity 中使用

复制代码

class MainActivity : AppCompatActivity() {
    private lateinit var fragmentHelper: FragmentManagerHelper

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        
        // 初始化 Fragment 管理器
        fragmentHelper = FragmentManagerHelper(supportFragmentManager, R.id.container)
        
        // 初始化显示第一个 Fragment
        if (savedInstanceState == null) {
            fragmentHelper.switchFragment("Home")
        }
    }

    // 底部导航切换示例
    fun onBottomNavigationSelected(itemId: Int) {
        when (itemId) {
            R.id.nav_home -> fragmentHelper.switchFragment("Home")
            R.id.nav_profile -> fragmentHelper.switchFragment("Profile")
            R.id.nav_settings -> fragmentHelper.switchFragment("Settings")
            R.id.nav_notifications -> fragmentHelper.switchFragment("Notifications")
            R.id.nav_messages -> fragmentHelper.switchFragment("Messages")
        }
    }

    override fun onBackPressed() {
        // 处理回退栈逻辑（可选）
        if (fragmentManager.backStackEntryCount > 0) {
            fragmentManager.popBackStack()
        } else {
            super.onBackPressed()
        }
    }
}

主要特性说明

集中管理

使用 Map 存储所有 Fragment 实例，避免重复创建
智能切换逻辑
- 首次添加 Fragment 时执行 add()
- 后续切换使用 show()/hide()
- 自动维护当前显示的 Fragment 标识
生命周期感知

通过 savedInstanceState 判断是否初始化，避免重复创建
扩展性设计
- createFragment() 方法可扩展为抽象工厂模式
- 支持自定义回退栈策略
状态丢失保护

提供 commitAllowingStateLoss() 选项用于特殊场景
线程安全

所有操作通过 FragmentManager 确保主线程执行

优化建议

懒加载支持

在 Fragment 中添加以下方法：

复制代码

abstract class BaseFragment : Fragment() {
    private var isLoaded = false

    override fun onResume() {
        super.onResume()
        if (!isLoaded) {
            lazyLoad()
            isLoaded = true
        }
    }

    abstract fun lazyLoad()
}

动画支持

在事务中添加过渡动画：

复制代码

transaction.setCustomAnimations(
    R.anim.slide_in_right,
    R.anim.slide_out_left,
    R.anim.slide_in_left,
    R.anim.slide_out_right
)

状态保存

在 Activity 中保存当前 Tag：

复制代码

override fun onSaveInstanceState(outState: Bundle) {
    super.onSaveInstanceState(outState)
    outState.putString("CURRENT_TAG", fragmentHelper.currentTag)
}

override fun onRestoreInstanceState(savedInstanceState: Bundle) {
    super.onRestoreInstanceState(savedInstanceState)
    savedInstanceState.getString("CURRENT_TAG")?.let {
        fragmentHelper.switchFragment(it)
    }
}

这种封装方案可使 Fragment 切换逻辑与 Activity 解耦，提升代码的可测试性和可维护性，特别适合需要管理多个 Fragment 的复杂界面场景。

Kotlin FragmentTransaction多容器管理多个fragment

封装工具类 FragmentManagerHelper

在 Activity 中使用

主要特性说明

优化建议

封装工具类 `FragmentManagerHelper`