萬盛學電腦網

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

Android Fragment 靜態聲明:在 Activity XML 布局中直接嵌入 Fragment 的完整指南

在 Activity 的 XML 布局文件中通過 <fragment> 標簽靜態聲明 Fragment,是構建多窗格 UI (如平板雙欄、大屏適配) 最直觀的方式。本文詳解聲明語法、必要屬性、生命週期特點、與動態添加的區別、嵌套 Fragment 陷阱及最佳實踐。

一、 核心語法與屬性

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:orientation="horizontal"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <!-- 列表 Fragment (左側, 佔 1/3) -->
    <fragment
        android:name="com.example.news.ArticleListFragment"
        android:id="@+id/list_fragment"
        android:layout_weight="1"
        android:layout_width="0dp"
        android:layout_height="match_parent" />

    <!-- 詳情 Fragment (右側, 佔 2/3) -->
    <fragment
        android:name="com.example.news.ArticleReaderFragment"
        android:id="@+id/viewer_fragment"
        android:layout_weight="2"
        android:layout_width="0dp"
        android:layout_height="match_parent" />

</LinearLayout>

關鍵屬性解析

  • android:name (必須):Fragment 類的**完全限定名**。系統會實例化該類。
  • android:id (必須,推薦):唯一標識,用於 findFragmentById() 獲取實例、**保存/恢復實例狀態** (配置變更時關鍵)。也可用 android:tag。
  • android:layout_width/height:布局尺寸,配合父容器 (如 LinearLayout + weight) 實現響應式分配。
  • tools:layout (可選):tools:layout="@layout/fragment_article_list",僅供預覽渲染,不影響運行。

二、 生命週期與實例化流程

  1. Activity setContentView() 解析 XML。
  2. 遇到 <fragment>,通過反射實例化 android:name 指定的類 (**必須有無參公共構造函數**)。
  3. 調用 Fragment onInflate() → onAttach() → onCreate() → onCreateView() (返回 View 或 0) → onViewCreated() → onActivityCreated() (已棄用) / onStart() → onResume()。
  4. Fragment View 直接加入父容器 ViewGroup,**不經過 FragmentTransaction**。

三、 靜態聲明 vs 動態添加 (FragmentTransaction)

維度靜態聲明 (XML)動態添加 (代碼)
適用場景固定佈局、常駐 Fragment (導航欄、雙欄主界面)動態切換、條件顯示、Back Stack 管理、對話框、底部彈窗
事務管理無 Back Stack,**不可 remove/replace/add**,生命週期綁定 Activity完全控制:add/replace/remove/hide/show/detach/attach + addToBackStack
配置變更恢復**自動恢復** (靠 id/tag 重新關聯實例),開發者無感需手動處理或依賴 setRetainInstance(true) / ViewModel
參數傳遞僅能通過 setArguments(Bundle) 在 onInflate 前設置 (罕用),通常在 onAttach 從 Activity 獲取創建前 setArguments(),或工廠模式注入
嵌套 Fragment**極易出錯** (見下文陷阱)使用 getChildFragmentManager() 相對可控

四、 獲取靜態 Fragment 實例

// Activity 中
ArticleListFragment listFragment = (ArticleListFragment) getSupportFragmentManager()
    .findFragmentById(R.id.list_fragment); // 必須有 android:id

// 或使用 tag
ArticleReaderFragment readerFragment = (ArticleReaderFragment) getSupportFragmentManager()
    .findFragmentByTag("viewer_tag"); // XML 中 android:tag="viewer_tag"

五、 大坑:靜態聲明的 Fragment 中嵌套子 Fragment

現象:父 Fragment 靜態聲明在 XML,其內部動態添加子 Fragment (如 ViewPager + FragmentPagerAdapter) 時,配置變更 (旋屏) 後子 Fragment 狀態丟失、重疊、崩潰。
原因:靜態 Fragment 重建時,子 FragmentManager 狀態恢復機制失效,子 Fragment 實例與新父實例關聯斷裂。
解決方案:

  • 方案 1 (推薦):父 Fragment 也改為**動態添加** (在 Activity onCreate 中 replace),擁有完整事務控制權。
  • 方案 2:父 Fragment 繼承 Fragment 並在 onCreateView 中手動 inflate 包含 <fragment> 的佈局 (不推薦,複雜)。
  • 方案 3:子 Fragment 使用 setRetainInstance(true) (已棄用) 或 ViewModel 跨實例保持數據,UI 重建接受閃爍。

六、 最佳實踐清單

  1. **僅用於固定、長期存在的 UI 區塊** (主導航、雙欄主內容)。
  2. **必須指定 android:id 或 android:tag**,否則配置變更無法恢復實例。
  3. Fragment 類**必須有公共無參構造函數** (Kotlin 需 constructor() 或無參主構造函數)。
  4. **避免在靜態 Fragment 中嵌套動態子 Fragment**,改用動態父容器。
  5. 佈局預覽添加 tools:layout 提升開發效率。
  6. 考慮迁移至 FragmentContainerView (API 28+,Jetpack 推薦),功能同 <fragment> 但修復了嵌套、動畫、Transition 等眾多 Bug,語法幾乎相同:
    <androidx.fragment.app.FragmentContainerView ... />

靜態聲明 Fragment 簡潔聲明式、自動狀態恢復,是固定多窗格佈局的首選。但邊界要清晰:**固定結構用靜態,動態切換用事務**,切勿混用導致狀態管理混亂。

copyright © 萬盛學電腦網 all rights reserved