萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 動態添加 Fragment 完整指南:FragmentTransaction 事務管理、回棧操作與容器佈局最佳實踐

動態添加 Fragment 是構建靈活單 Activity 多 Fragment 架構 (如底部導航、抽屜菜單、多步驟向導) 的核心技能。本文詳解 FragmentManager、FragmentTransaction 核心 API、添加/替移除/隱藏顯示操作、Back Stack 管理、容器佈局選擇、參數傳遞、生命週期交互及常見坑點,提供標準化封裝工具類。

一、 容器佈局:預留 Fragment 宿主

<!-- activity_main.xml -->
<FrameLayout
    android:id="@+id/fragment_container"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />
<!-- 或 androidx.fragment.app.FragmentContainerView (推薦, API 28+) -->
<androidx.fragment.app.FragmentContainerView
    android:id="@+id/fragment_container"
    android:name="com.example.HomeFragment" // 可選:預置初始 Fragment
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

關鍵:使用 FrameLayout 或 FragmentContainerView 作為容器,**不要**在 XML 中靜態聲明 <fragment> (除非永不替換)。

二、 核心操作 API 速查

FragmentManager fm = getSupportFragmentManager(); // Activity
// 或 fm = getChildFragmentManager(); // Fragment 中嵌套
// 或 fm = getParentFragmentManager(); // Fragment 中訪問父

FragmentTransaction ft = fm.beginTransaction();

// 基礎操作
ft.add(R.id.container, fragment, "tag");      // 添加 (疊加)
ft.replace(R.id.container, fragment, "tag");  // 替換 (移除同容器所有 + 添加) **最常用**
ft.remove(fragment);                          // 移除 (銷毀 View, 實例保留若未加 backStack)
ft.hide(fragment);                            // 隱藏 (View GONE, 實例保活)
ft.show(fragment);                            // 顯示
ft.attach(fragment);                          // 附加 (View 重建)
ft.detach(fragment);                          // 分離 (View 銷毀, 實例保留)

// 事務屬性
ft.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_FADE); // 動畫
ft.setCustomAnimations(enterAnim, exitAnim, popEnterAnim, popExitAnim); // 自定義動畫
ft.addToBackStack("name");                    // 加入回棧 (名字可為 null)
ft.setReorderingAllowed(true);                // 優化動畫重排 (API 26+ 推薦開啟)

// 提交
ft.commit();              // 異步提交,排隊執行
ft.commitNow();           // 同步執行 (需 API 24+,慎用)
ft.commitAllowingStateLoss(); // 狀態丟失風險下提交 (如 onSaveInstanceState 後)

三、 三大經典模式實戰

模式 1:替換模式 (底部導航/標籤頁切換) - 推薦配合 hide/show 優化

// 低效模式:每次 replace 重建 View,狀態丟失
// ft.replace(R.id.container, new Fragment()).commit();

// 高效模式:hide/show 保持實例 (需配合 FragmentTransaction.show/hide)
public void switchFragment(Fragment target, String tag) {
    FragmentManager fm = getSupportFragmentManager();
    FragmentTransaction ft = fm.beginTransaction();
    
    // 隱藏所有已添加 Fragment
    for (Fragment f : fm.getFragments()) {
        if (f != null && f.isAdded()) ft.hide(f);
    }
    
    Fragment existing = fm.findFragmentByTag(tag);
    if (existing != null) {
        ft.show(existing); // 復用實例
    } else {
        ft.add(R.id.container, target, tag); // 首次添加
    }
    ft.commit();
}

模式 2:回棧模式 (多級頁面/向導) - 物理返回鍵自動回退

public void navigateTo(Fragment nextFragment, String tag, boolean addToBackStack) {
    FragmentTransaction ft = getSupportFragmentManager().beginTransaction();
    ft.replace(R.id.container, nextFragment, tag);
    if (addToBackStack) ft.addToBackStack(tag); // 關鍵:入棧
    ft.commit();
}

// Activity 處理返回鍵 (可選,默認自動 popBackStack)
@Override public void onBackPressed() {
    if (getSupportFragmentManager().getBackStackEntryCount() > 0) {
        getSupportFragmentManager().popBackStack();
    } else {
        super.onBackPressed(); // 退出 Activity
    }
}

模式 3:對話框/底部彈窗 Fragment (DialogFragment/BottomSheetDialogFragment)

// 無需容器 ID,直接 show
MyDialogFragment dialog = MyDialogFragment.newInstance(args);
dialog.show(getSupportFragmentManager(), "dialog_tag");

// 底部彈窗
BottomSheetDialogFragment sheet = BottomSheetFragment.newInstance();
sheet.show(getSupportFragmentManager(), "sheet_tag");

四、 參數傳遞:唯一標準 setArguments(Bundle)

// 創建時設置 (Fragment 構造函數不傳參!)
public static MyFragment newInstance(int id, String title) {
    MyFragment f = new MyFragment();
    Bundle args = new Bundle();
    args.putInt("arg_id", id);
    args.putString("arg_title", title);
    f.setArguments(args);
    return f;
}

// Fragment 內獲取
@Override public void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    int id = getArguments().getInt("arg_id", -1);
    String title = getArguments().getString("arg_title");
}

原因:系統重建 Fragment 時 (配置變更、進程死後重活) 會自動保存/恢復 arguments,構造函數參數會丟失。

五、 生命週期交互關鍵點

  • replace 觸發舊 Fragment:onPause -> onStop -> onDestroyView -> onDestroy -> onDetach。
  • hide 觸發:onPause -> onStop -> onHiddenChanged(true) (View 變 GONE)。
  • show 觸發:onHiddenChanged(false) -> onStart -> onResume。
  • setMaxLifecycle(state) (API 26+):限制 Fragment 最大生命週期狀態 (如 STARTED 防止 onResume),ViewPager2 預啟用。

六、 通用封裝工具類 FragmentNavigator

public class FragmentNavigator {
    private final FragmentManager fm;
    private final int containerId;

    public FragmentNavigator(FragmentActivity activity, int containerId) {
        this.fm = activity.getSupportFragmentManager();
        this.containerId = containerId;
    }

    public void replace(Fragment fragment, String tag, boolean addToBackStack) {
        FragmentTransaction ft = fm.beginTransaction();
        ft.replace(containerId, fragment, tag);
        if (addToBackStack) ft.addToBackStack(tag);
        ft.setReorderingAllowed(true);
        ft.commit();
    }

    public void add(Fragment fragment, String tag) {
        fm.beginTransaction().add(containerId, fragment, tag).commit();
    }

    public void popBackStack() {
        fm.popBackStack();
    }

    public void clearBackStack() {
        fm.popBackStack(null, FragmentManager.POP_BACK_STACK_INCLUSIVE);
    }

    public Fragment findFragment(String tag) {
        return fm.findFragmentByTag(tag);
    }
}

七、 避坑指南

  1. commit() 後狀態丟失:onSaveInstanceState 後提交拋 IllegalStateException。用 commitAllowingStateLoss() 或確保在 onResume 前提交。
  2. 嵌套 Fragment 管理器混淆:父 Fragment 用 getChildFragmentManager() 管理子 Fragment,Activity 用 getSupportFragmentManager()。**切勿混用**。
  3. FragmentPagerAdapter vs FragmentStatePagerAdapter:前者保持所有 Fragment 實例 (適合少量頁面),後者銷毀非當前頁 (適合大量頁面)。ViewPager2 統一使用 FragmentStateAdapter (行為類後者)。
  4. FragmentContainerView 優勢:修復 <fragment> 嵌套 Bug、支持 android:name 預置、Transition 動畫正確、findFragmentById 即時生效。**全面替換 FrameLayout**。

掌握動態 Fragment 事務管理、Back Stack 控制、容器選擇與參數傳遞規範,即可構建結構清晰、導航流暢、生命週期安全的現代 Android 應用架構。

copyright © 萬盛學電腦網 all rights reserved