Activity动态切换Fragment

news2025/5/11 23:24:20

Activity 动态切换 Fragment 是 Android 开发中常见的需求，用于构建灵活的用户界面。以下是实现 Activity 动态切换 Fragment 的几种方法，以及一些最佳实践：

1. 使用 FragmentManager 和 FragmentTransaction (推荐)

这是最常用和推荐的方法。 FragmentManager 管理 Activity 中的 Fragment，FragmentTransaction 用于执行 Fragment 的添加、替换、移除等操作。

import androidx.fragment.app.Fragment;
import androidx.fragment.app.FragmentManager;
import androidx.fragment.app.FragmentTransaction;
import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;

public class MainActivity extends AppCompatActivity {

    private FragmentManager fragmentManager;
    private Fragment currentFragment;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 获取 FragmentManager
        fragmentManager = getSupportFragmentManager();

        // 初始化第一个 Fragment
        if (savedInstanceState == null) { // 避免 Activity 重建时重复添加
            replaceFragment(new FragmentA(), false);
        }

        // 设置按钮点击事件
        Button buttonA = findViewById(R.id.button_a);
        Button buttonB = findViewById(R.id.button_b);

        buttonA.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                replaceFragment(new FragmentA(), true);
            }
        });

        buttonB.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                replaceFragment(new FragmentB(), true);
            }
        });
    }

    // 替换 Fragment 的方法
    public void replaceFragment(Fragment fragment, boolean addToBackStack) {
        // 创建 FragmentTransaction
        FragmentTransaction transaction = fragmentManager.beginTransaction();

        // 设置动画 (可选)
        // transaction.setCustomAnimations(R.anim.slide_in, R.anim.slide_out);

        // 替换 Fragment
        transaction.replace(R.id.fragment_container, fragment);

        // 可选：添加到 BackStack，允许用户按返回键返回上一个 Fragment
        if (addToBackStack) {
            transaction.addToBackStack(null); // 可以指定 BackStack 的名称
        }

        // 提交事务
        transaction.commit();

        // 记录当前 Fragment
        currentFragment = fragment;
    }
}

解释:

R.id.fragment_container: 这是 Activity 布局文件中用于放置 Fragment 的 FrameLayout 或其他容器的 ID。
getSupportFragmentManager(): 获取 FragmentManager 的实例。对于使用 AndroidX 的项目，使用 getSupportFragmentManager()。对于旧项目，使用 getFragmentManager()。
beginTransaction(): 创建一个 FragmentTransaction 对象，用于执行 Fragment 操作。
replace(containerViewId, fragment): 将指定容器中的现有 Fragment 替换为新的 Fragment。
addToBackStack(String name): 将 FragmentTransaction 添加到 BackStack。当用户按下返回键时，会从 BackStack 中弹出最后一个 FragmentTransaction，并恢复到之前的状态。 name 参数是 BackStack 的名称，可以用于以后查找和管理 BackStack。如果不需要 BackStack，可以省略此行。
commit(): 提交 FragmentTransaction，执行 Fragment 的替换操作。 重要: commit() 是异步的。
commitNow(): 立即执行 FragmentTransaction。通常不推荐使用，因为它会阻塞主线程。
currentFragment: 保存当前显示的 Fragment 的引用，方便以后操作。
savedInstanceState == null: 在 onCreate() 方法中检查 savedInstanceState 是否为 null，以避免在 Activity 重建时重复添加 Fragment。

2. 使用 add() 和 hide()/show() (适用于多个 Fragment 并存的情况)

如果需要在 Activity 中同时显示多个 Fragment，可以使用 add() 方法将 Fragment 添加到容器中，然后使用 hide() 和 show() 方法来控制 Fragment 的可见性。

public class MainActivity extends AppCompatActivity {

    private FragmentManager fragmentManager;
    private FragmentA fragmentA;
    private FragmentB fragmentB;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        fragmentManager = getSupportFragmentManager();

        // 初始化 Fragment
        fragmentA = new FragmentA();
        fragmentB = new FragmentB();

        // 添加 Fragment
        FragmentTransaction transaction = fragmentManager.beginTransaction();
        transaction.add(R.id.fragment_container, fragmentA, "fragmentA");
        transaction.add(R.id.fragment_container, fragmentB, "fragmentB");
        transaction.hide(fragmentB); // 默认隐藏 FragmentB
        transaction.commit();

        // 设置按钮点击事件
        Button buttonA = findViewById(R.id.button_a);
        Button buttonB = findViewById(R.id.button_b);

        buttonA.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                showFragmentA();
            }
        });

        buttonB.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                showFragmentB();
            }
        });
    }

    private void showFragmentA() {
        FragmentTransaction transaction = fragmentManager.beginTransaction();
        transaction.hide(fragmentB);
        transaction.show(fragmentA);
        transaction.commit();
    }

    private void showFragmentB() {
        FragmentTransaction transaction = fragmentManager.beginTransaction();
        transaction.hide(fragmentA);
        transaction.show(fragmentB);
        transaction.commit();
    }
}

解释:

add(containerViewId, fragment, tag): 将 Fragment 添加到容器中，并为其指定一个标签。标签可以用于以后查找 Fragment。
hide(fragment): 隐藏指定的 Fragment。
show(fragment): 显示指定的 Fragment。
findFragmentByTag(tag): 根据标签查找 Fragment。

3. 使用 ViewPager (适用于滑动切换 Fragment 的情况)

如果需要在 Activity 中实现滑动切换 Fragment 的效果，可以使用 ViewPager 和 FragmentPagerAdapter 或 FragmentStatePagerAdapter。

FragmentPagerAdapter: 适用于 Fragment 数量较少且固定的情况。它会将所有 Fragment 保存在内存中。
FragmentStatePagerAdapter: 适用于 Fragment 数量较多或动态变化的情况。它只会将当前显示的 Fragment 保存在内存中，其他 Fragment 会被销毁。

4. 使用 Navigation Component (适用于复杂的导航结构)

如果应用具有复杂的导航结构，可以考虑使用 Android Jetpack 的 Navigation Component。 Navigation Component 提供了一个声明式的导航系统，可以简化 Fragment 的切换和管理。

最佳实践:

使用 replace() 方法进行 Fragment 替换，而不是 add() 和 remove()。 replace() 方法更简洁，并且可以避免一些潜在的问题。
使用 addToBackStack() 方法将 FragmentTransaction 添加到 BackStack，以便用户可以通过按返回键返回上一个 Fragment。
在 onCreate() 方法中检查 savedInstanceState 是否为 null，以避免在 Activity 重建时重复添加 Fragment。
使用 Fragment 的标签 (tag) 来查找 Fragment。
避免在 Fragment 的 onCreateView() 方法中执行耗时的操作，否则可能会导致 UI 卡顿。
使用 commitAllowingStateLoss() 方法来提交 FragmentTransaction，以避免 IllegalStateException。 但是，请注意，commitAllowingStateLoss() 可能会导致一些数据丢失。
使用 ViewModel 来管理 Fragment 的数据，以便在 Activity 重建时保留数据。
使用 LiveData 来观察 ViewModel 中的数据，以便在数据发生变化时自动更新 UI。
使用 Data Binding 来简化 UI 的更新。
使用 Kotlin 协程来执行异步操作。

选择哪种方法？

简单的 Fragment 替换: 使用 replace() 和 addToBackStack()。
多个 Fragment 并存，需要控制可见性: 使用 add()、hide() 和 show()。
滑动切换 Fragment: 使用 ViewPager 和 FragmentPagerAdapter 或 FragmentStatePagerAdapter。
复杂的导航结构: 使用 Navigation Component。