片段

將應用程式區隔成多個獨立的畫面，由 Activity 代管。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2025 年 6 月 4 日 1.8.8 - - -

宣告依附元件

如果要為 Fragment 新增依附元件，您必須將 Google Maven 存放區新增至專案。詳情請參閱「Google 的 Maven 存放區」一節。

在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：

Groovy

dependencies {
    def fragment_version = "1.8.8"

    // Java language implementation
    implementation "androidx.fragment:fragment:$fragment_version"
    // Kotlin
    implementation "androidx.fragment:fragment-ktx:$fragment_version"
    // Compose
    implementation "androidx.fragment:fragment-compose:$fragment_version"
    // Testing Fragments in Isolation
    debugImplementation "androidx.fragment:fragment-testing-manifest:$fragment_version"
    androidTestImplementation "androidx.fragment:fragment-testing:$fragment_version"
}

Kotlin

dependencies {
    val fragment_version = "1.8.8"

    // Java language implementation
    implementation("androidx.fragment:fragment:$fragment_version")
    // Kotlin
    implementation("androidx.fragment:fragment-ktx:$fragment_version")
    // Compose
    implementation("androidx.fragment:fragment-compose:$fragment_version")
    // Testing Fragments in Isolation
    debugImplementation("androidx.fragment:fragment-testing:$fragment_version")
}

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 說明文件。

1.8 版

1.8.8 版

2025 年 6 月 4 日

發布 androidx.fragment:fragment-*:1.8.8。1.8.8 版包含這些修訂項目。

修正錯誤

  • 修正問題：FragmentManager 在嘗試儲存使用 setMaxLifecycle(Lifecycle.State.INITIALIZED) 新增的 Fragment 狀態時會異常終止。由於這些片段從未經過 onCreate()，因此不再有任何狀態可儲存或呼叫 onSaveInstanceState()。(I6e37a)。

1.8.7 版

2025 年 5 月 20 日

發布 androidx.fragment:fragment-*:1.8.7。1.8.7 版包含這些修訂項目。

修正錯誤

  • 修正在相同影格中執行彈出和取代作業後，FragmentManager 未處於正確狀態的問題，這可能會導致透過 popBackStack 或預測返回手勢彈出返回堆疊時發生當機。(I50ad1)。
  • 修正了使用 AndroidX 轉場功能時發生的當機問題，當發生快速連續片段交易嘗試取消未開始的轉場，而 AndroidX 轉場程式庫未正確清除轉場狀態時，就會發生此問題。(請參閱 b/414612221)。(Ib5235)。

1.8.6 版

2025 年 2 月 12 日

發布 androidx.fragment:fragment-*:1.8.6。1.8.6 版包含這些修訂項目。

修正錯誤

  • FragmentContainerView 的 setOnApplyWindowInsetsListener 覆寫值現在會採用空值事件監聽器，與架構允許的內容相符。(I575f0、b/282790626)。

1.8.5 版

2024 年 10 月 30 日

發布 androidx.fragment:fragment-*:1.8.5。1.8.5 版包含這些修訂項目。

修正錯誤

  • 修正了只有在預測返回手勢遭到取消或中斷後，才會由 saveBackStack 觸發的 IllegalStateException。(I3387d、b/342419080)。

1.8.4 版

2024 年 10 月 2 日

發布 androidx.fragment:fragment-*:1.8.4。1.8.4 版包含這些修訂版本。

修正錯誤

  • 修正使用 Androidx 轉場時，快速按下系統返回按鈕或快速執行返回手勢，會導致 Fragment 停止運作的問題。(Ibc038、b/364804225)
  • 修正片段中的問題：中斷預測返回手勢會導致片段管理員進入未定義狀態，甚至顯示錯誤的片段。(If82e2、b/338624457)。
  • 修正 AndroidFragment 中的 UninitializedPropertyAccessException，當您動態交換 AndroidFragment 例項使用的 Class 時，會發生此問題。(I12dea)

1.8.3 版

2024 年 9 月 4 日

發布 androidx.fragment:fragment-*:1.8.3。1.8.3 版包含這些修訂項目。

修正錯誤

  • FragmentManager 處理預測返回手勢時，現在可正確考量待處理作業。這應該可確保系統返回不再導致 IndexOutOfBoundsException。(I9ba32、b/342316801)。
  • 當內含活動/片段的狀態已儲存時，如果將 AndroidFragment 新增至組合，就不會再發生當機問題。(I985e9、b/356643968)。

1.8.2 版

2024 年 7 月 24 日

發布 androidx.fragment:fragment-*:1.8.2。1.8.2 版包含這些修訂項目。

修正錯誤

  • AndroidFragment 現在可以妥善處理父項片段放入 Fragment 返回堆疊的情況，避免在返回該片段時出現「找不到 ID 的檢視畫面」問題。(I94608)。
  • 透過 FragmentTransaction.add 方法新增的片段會採用 ViewGroup，現在會等待 onContainerAvailable，然後再進入 onStart()。這會影響該 API 的使用者，例如 AndroidFragment，因為 AndroidFragment 必須等到 AndroidFragment 重新輸入組合，才能透過 onStart() 移動。(I94608)。

1.8.1 版

2024 年 6 月 26 日

發布 androidx.fragment:fragment-*:1.8.1。1.8.1 版包含這些修訂項目。

修正錯誤

  • 修正問題：在開始預測返回手勢時，沒有容器的片段會立即 DESTROYED。現在，這些事件會保留在 CREATED 狀態，直到手勢完成後才會釋出。(If6b83、b/345244539)。

1.8.0 版

2024 年 6 月 12 日

發布 androidx.fragment:fragment-*:1.8.0。1.8.0 版包含這些修訂版本。

自 1.7.0 版以來的重要變更

  • fragment-compose 構件現在包含 AndroidFragment Composable，可透過片段類別名稱將片段新增至 Compose 階層。它會自動處理 Fragment 狀態的儲存和還原作業。這應該是直接取代先前建議的使用 AndroidViewBinding 來加載 Fragment 的方法。
  • FragmentManager 的 OnBackStackChangedListener 介面現在會在 FragmentManager 執行作業時觸發 onBackStackChangeCancelled 回呼，讓回呼更接近 onBackStackChangeCommitted 回呼的時間點。

1.8.0-rc01 版

2024 年 5 月 29 日

發布 androidx.fragment:fragment-*:1.8.0-rc01。1.8.0-rc01 版包含這些修訂項目。

修正錯誤

  • FragmentManagers OnBackStackChangedListener 介面上的 onBackStackChangeCancelled 回呼現在會在 FragmentManager 中執行作業時觸發，讓回呼更接近 onBackStackChangeCommitted 回呼的時間點。(I5ebfb、b/332916112)。

1.8.0-beta01 版

2024 年 5 月 14 日

發布 androidx.fragment:fragment-*:1.8.0-beta01。1.8.0-beta01 版包含這些修訂項目。

修正錯誤

  • 在 Fragment 1.7.1 中：預測返回功能現在只會針對所有片段都具有 Animator 或可尋 Seekable Androidx 轉換的交易執行。這項修正可解決取消部分可暫停交易會導致黑色畫面的問題。(I43037、b/339169168)。

1.8.0-alpha02 版

2024 年 4 月 17 日

發布 androidx.fragment:fragment-*:1.8.0-alpha02。1.8.0-alpha02 版包含這些修訂項目。

修正錯誤

  • 在 Fragment 1.7.0-rc02 中：新增記錄檔，指出為何在未設定任何其他轉場的情況下，設定 sharedElement 會導致執行失敗。(Iec48e)
  • 在 Fragment 1.7.0-rc02 中：修正當所有其他轉換皆可尋找時，將不可尋找的共用元素新增至交易中，導致應用程式當機的問題。系統現在會正確將交易視為不可尋找。(I18ccd)

1.8.0-alpha01 版

2024 年 4 月 3 日

發布 androidx.fragment:fragment-*:1.8.0-alpha01。1.8.0-alpha01 版包含這些修訂版本。

新功能

  • 新的 AndroidFragment Composable 可透過片段類別名稱，將片段新增至 Compose 階層。它會自動處理 Fragment 狀態的儲存和還原作業。這可用來直接取代 AndroidViewBinding Composable。(b/312895363、Icf841)

說明文件變更

  • 更新 OnBackStackChangedListener API 的說明文件，指出 API 的呼叫時機和使用方式。(I0bfd9)。

依附元件更新

1.7 版

1.7.1 版

2024 年 5 月 14 日

發布 androidx.fragment:fragment-*:1.7.1。1.7.1 版包含這些修訂項目。

修正錯誤

  • 預測返回功能現在只會針對所有片段都具有 Animator 或可尋 Seekable Androidx 轉換的交易執行。這項修正可解決取消部分可尋找交易會導致畫面空白的問題。(I43037、b/339169168)。

1.7.0 版

2024 年 5 月 1 日

發布 androidx.fragment:fragment-*:1.7.0。1.7.0 版包含這些修訂項目。

預測返回手勢支援

  • 使用 Animator 或 AndroidX Transition 1.5.0 時，片段現在支援預測返回手勢。這樣一來，使用者就能透過返回手勢，在決定是否透過完成手勢或取消來提交交易前，先查詢 Animator/Transition 來查看先前的片段。
轉換系統 XML 資源 支援預測返回
Animation R.anim 否
Animator R.animator 是
架構 Transition R.transition 否
AndroidX Transition (使用 Transition 1.4.1 以下版本) R.transition 否
AndroidX Transition 搭配 Transition 1.5.0 R.transition 是

如果您在選擇採用預測返回手勢後，發現片段中支援預測返回功能時發生任何問題，請針對片段回報問題，並附上可重現問題的範例專案。您可以在活動的 onCreate() 中使用 FragmentManager.enabledPredictiveBack(false)，停用預測返回功能。

FragmentManager.OnBackStackChangedListener() 現在提供 onBackStackChangeProgressed() 和 onBackStackChangeCancelled()，分別用於接收預測返回進度和取消事件。

Fragment Compose 構件

我們已建立新的 fragment-compose 構件，專注於支援從以 Fragment 為基礎的架構，轉換為完全以 Compose 為基礎的架構。

這個新構件提供的第一個功能是 Fragment 上的 content 擴充方法，可為您建立 ComposeView 並設定正確的 ViewCompositionStrategy，讓您更輕鬆地使用 Compose 製作個別 Fragment 的 UI。

  class ExampleFragment : Fragment() {

      override fun onCreateView(
          inflater: LayoutInflater,
          container: ViewGroup?,
          savedInstanceState: Bundle?
      ) = content {
          // Write your @Composable content here
          val viewModel: ExampleViewModel = viewModel()

          // or extract it into a separate, testable method
          ExampleComposable(viewModel)
      }
  }

1.7.0-rc02 版

2024 年 4 月 17 日

發布 androidx.fragment:fragment-*:1.7.0-rc02。1.7.0-rc02 版包含這些修訂項目。

修正錯誤

  • 新增記錄，指出為何在未設定任何其他轉場的情況下，設定 sharedElement 會導致執行失敗。(Iec48e)
  • 修正錯誤：如果將無法尋找的共用元素新增至所有其他轉場效果皆可尋找的交易，系統就會當機。系統現在會正確將交易視為不可尋找。(I18ccd)

1.7.0-rc01 版

2024 年 4 月 3 日

發布 androidx.fragment:fragment-*:1.7.0-rc01。1.7.0-rc01 版包含這些修訂項目。

依附元件更新

1.7.0-beta01 版

March 20, 2024

發布 androidx.fragment:fragment-*:1.7.0-beta01。1.7.0-beta01 版包含這些修訂版本。

API 變更

  • FragmentHostCallback 現在是以 Kotlin 編寫，因此主機的泛型類型是否可為空值，會與 onGetHost() 的傳回類型是否可為空值相符。(I40af5)。

修正錯誤

  • 修正問題：在非容器中的片段上提交預測返回手勢時，該片段永遠不會遭到銷毀。片段現在會立即移至最終狀態。(Ida0d9)。
  • 修正片段中的問題：使用預測返回手勢中斷傳入的轉場時，會刪除進入的檢視畫面，並留下空白畫面。(Id3f22、b/319531491)。

1.7.0-alpha10 版本

2024 年 2 月 7 日

發布 androidx.fragment:fragment-*:1.7.0-alpha10。1.7.0-alpha10 版包含以下修訂項目。

修正錯誤

  • 修正先前片段版本中的已知問題：如果使用片段的預測返回功能支援 Animator 或 AndroidX 轉換，且從未透過 addOnBackStackChangedListener 新增 FragmentManager.OnBackStackChangedListener，片段就會從 handleOnBackProgressed 擲回 NullPointerException。(I7c835)。

1.7.0-alpha09 版

2024 年 1 月 24 日

發布 androidx.fragment:fragment-*:1.7.0-alpha09。1.7.0-alpha09 版包含此連結所列的修訂項目。

Fragment Compose 構件

我們已建立新的 fragment-compose 構件，專注於支援從以 Fragment 為基礎的架構，轉換為完全以 Compose 為基礎的架構。

這個新構件提供的第一個功能是 Fragment 上的 content 擴充方法，可為您建立 ComposeView 並設定正確的 ViewCompositionStrategy，讓您更輕鬆地使用 Compose 製作個別 Fragment 的 UI。(561cb7、b/258046948)。

class ExampleFragment : Fragment() {

    override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?
    ) = content {
        // Write your @Composable content here
        val viewModel: ExampleViewModel = viewModel()

        // or extract it into a separate, testable method
        ExampleComposable(viewModel)
    }
}

新功能

  • FragmentManager.OnBackStackChangedListener() 現在提供 onBackStackChangeProgressed() 和 onBackStackChangeCancelled()，分別用於接收預測返回進度和取消事件。(214b87)

已知問題

  • 使用 Fragment 的預測返回功能支援 Animator 或 AndroidX 轉換時，如果從未透過 addOnBackStackChangedListener 新增 FragmentManager.OnBackStackChangedListener，Fragment 就會從 handleOnBackProgressed 擲回 NullPointerException。手動新增監聽器即可解決這個當機問題。我們會在下一個 Fragments 版本中修正這個問題。

1.7.0-alpha08 版

2024 年 1 月 10 日

發布 androidx.fragment:fragment-*:1.7.0-alpha08。1.7.0-alpha08 版包含此連結所列的修訂項目。

清理

1.7.0-alpha07 版

2023 年 11 月 29 日

發布 androidx.fragment:fragment-*:1.7.0-alpha07。1.7.0-alpha07 版包含以下修訂項目。

修正錯誤

  • 修正設定共用元素轉換，但未設定 enter/exitTransition 而導致的 NullPointerException 問題。(I8472b)
  • 在 Fragment 1.6.2 中：當 FragmentContainerView 的 Fragment 加載時，現在可以在 onInflate 回呼中存取其狀態，例如 FragmentManager、Host 和 ID。(I1e44c、b/307427423)。
  • 在 Fragment 1.6.2 中：使用 clearBackStack 移除一組 Fragment 時，現在會在父項片段的 ViewModels 清除時，一併清除任何巢狀 Fragment 的 ViewModel。(I6d83c、b/296173018)。

1.7.0-alpha06 版

2023 年 10 月 4 日

發布 androidx.fragment:fragment-*:1.7.0-alpha06。1.7.0-alpha06 版包含以下修訂項目。

依附元件更新

1.7.0-alpha05 版

2023 年 9 月 20 日

發布 androidx.fragment:fragment-*:1.7.0-alpha05。1.7.0-alpha05 版包含以下修訂項目。

新功能

  • 使用 Androidx 轉場時，Fragment 現在支援預測返回手勢。這可讓您使用返回手勢，透過自訂的 AndroidX 轉換功能尋找先前的片段，然後再決定是否透過完成手勢提交或取消交易。您必須依賴 Transition 1.5.0-alpha03 版本才能啟用這項功能。(Ib49b4、b/285175724)

已知問題

  • 目前有一個問題，如果您取消一次返回手勢的轉場效果，下次開始返回手勢時，系統將無法執行轉場效果，導致畫面空白。這可能是 Transition 程式庫的問題所造成。(b/300157785)。如果您遇到這個問題，請針對 Fragment 提交問題報告，並附上可重現問題的範例專案。您可以在活動的 onCreate() 中使用 FragmentManager.enabledPredictiveBack(false)，停用預測返回功能。

1.7.0-alpha04 版

2023 年 9 月 6 日

發布 androidx.fragment:fragment-*:1.7.0-alpha04。1.7.0-alpha04 版包含以下修訂項目。

修正錯誤

  • 修正了取消預測返回手勢時，片段無法進入正確生命週期狀態的問題。(I7cffe、b/297379023)。
  • 修正迴歸問題：允許動畫搭配轉場效果執行。(I59f36)。
  • 修正在使用預測返回功能時，如果在返回堆疊中，嘗試在倒數第二個片段上快速連續返回兩次，會導致應用程式停止運作的問題。(Ifa1a4)

1.7.0-alpha03 版

2023 年 8 月 23 日

發布 androidx.fragment:fragment-*:1.7.0-alpha03。1.7.0-alpha03 版包含以下修訂項目。

修正錯誤

  • 修正 Fragment 在使用預測返回功能時發生的問題，該問題會導致 Fragment 管理員返回堆疊中的第一個 Fragment 遭到略過，且當使用 3 個按鈕導覽或預測返回手勢時，系統會結束活動。(I0664b、b/295231788)。

1.7.0-alpha02 版

2023 年 8 月 9 日

發布 androidx.fragment:fragment-*:1.7.0-alpha02。1.7.0-alpha02 版包含以下修訂項目。

修正錯誤

  • 使用 API 34 的預測返回手勢片段時，如果您使用不支援尋找 (Animations、Transitions) 或完全不支援轉場的轉場系統，片段現在會等待手勢完成，再執行返回動作。(I8100c)。

1.7.0-alpha01 版

2023 年 6 月 7 日

發布 androidx.fragment:fragment-*:1.7.0-alpha01。這個版本是在內部分支版本中開發而成。

新功能

  • 片段現在支援使用 Animator 時的應用程式內預測返回功能。這樣一來，您就能使用返回手勢，透過自訂動畫師查看先前的片段，然後再決定是否透過完成手勢提交交易，或取消交易。您也可以使用實驗版 enablePredictiveBack() 並傳入 false，停用這項新行為。

1.6 版本

1.6.2 版

2023 年 11 月 1 日

發布 androidx.fragment:fragment-*:1.6.2。1.6.2 版包含以下修訂項目。

修正錯誤

  • 當 FragmentContainerView 的 Fragment 加載時，現在可以在 onInflate 回呼中存取其狀態，例如 FragmentManager、Host 和 ID。(I1e44c、b/307427423)。
  • 使用 clearBackStack 移除一組片段時，現在會在清除父項片段的 ViewModels 時，一併清除任何巢狀 Fragment 的 ViewModel。(I6d83c、b/296173018)。

1.6.1 版

2023 年 7 月 26 日

發布 androidx.fragment:fragment-*:1.6.1。1.6.1 版包含此連結所列的修訂項目。

修正錯誤

  • 修正問題：即使片段例項已移回 RESUMED 狀態，在活動已停止但未刪除時儲存的狀態仍會錯誤快取。如果使用多個返回堆疊 API 儲存及還原片段，而該片段例項位於返回堆疊中，這會導致系統重複使用快取狀態。(I71288、b/246289075)。

依附元件更新

  • Fragment 現在依附於 Activity 1.7.2。這項修正可解決以下問題：如果 Kotlin 使用者未明確依附 Activity，就無法擴充 ComponentDialog。(b/287509323)

1.6.0 版

2023 年 6 月 7 日

發布 androidx.fragment:fragment-*:1.6.0。1.6.0 版包含以下修訂項目。

自 1.5.0 版以來的重要變更

  • Fragment 的儲存狀態已全面區分成兩種類型，一種是私人程式庫狀態 (自訂 Parcelable 類別)，另一種則是開發人員提供的狀態；開發人員提供的狀態現在一律儲存在 Bundle 之中，允許判定片段的狀態確切來自於何處。
  • FragmentManager.OnBackStackChangedListener 介面已擴充兩個額外的回呼 onBackStackChangeStarted 和 onBackStackChangeCommitted，分別在每個 Fragment 從片段返回堆疊新增/移除前，以及交易提交後立即呼叫。
  • FragmentStrictMode 新增了 WrongNestedHierarchyViolation，可偵測子項片段是否以巢狀結構位於其父項的檢視區塊階層中，但不會新增至父項的 childFragmentManager。
  • 採用 Intent 或 IntentSender 的 Fragment 和 FragmentManager API 現在可正確加註 @NonNull，以免傳遞空值，因為空值一定會立即導致這些方法呼叫的各個 Android 架構 API 發生當機問題
  • DialogFragment 現在可透過 requireComponentDialog() API 存取基礎 ComponentDialog。
  • Fragment 現在依附於 Lifecycle 2.6.1。
  • 片段現在依附於 SavedState 1.2.1。
  • Fragment 現在依附於 ProfileInstaller 1.3.0。

  • fragment-testing-manifest 成果會將資訊清單項目與片段測試元件的其他部分分開。也就是說，您可以執行以下操作：

    debugImplementation("androidx.fragment:fragment-testing-manifest:X.Y.Z")
androidTestImplementation("androidx.fragment:fragment-testing:X.Y.Z")

    這可避免因 fragment-testing 與 androidx.test 之間的版本偏差而發生衝突

1.6.0-rc01 版

2023 年 5 月 10 日

發布 androidx.fragment:fragment-*:1.6.0-rc01。1.6.0-rc01 版包含以下修訂項目。

修正錯誤

  • 修正問題：當連續提出多個 startActivityForResult 要求時，ActivityResult 會傳送錯誤的要求碼。(If0b9d、b/249519359)。
  • 修正了在交易實際上未變更返回堆疊的情況下，系統會為交易調度 onBackStackChangeListener 回呼的問題。(I0eb5c、b/279306628)

1.6.0-beta01 版

2023 年 4 月 19 日

發布 androidx.fragment:fragment-*:1.6.0-beta01。1.6.0-beta01 版包含以下修訂項目。

修正錯誤

  • 使用 postponeEnterTransition 搭配逾時，然後取代延後的片段，不再會導致延後的片段發生外洩。(I2ec7d、b/276375110)。
  • 新的 onBackStackChangeStarted 和 onBackStackChangeCommitted 回呼現在只會派送一個片段，即使有多筆交易包含相同的片段也一樣。(Ic6b69)。

1.6.0-alpha09 版

2023 年 4 月 5 日

發布 androidx.fragment:fragment-*:1.6.0-alpha09。1.6.0-alpha09 版包含以下修訂項目。

API 變更

  • DialogFragment 現在可透過 requireComponentDialog() API 存取基礎 ComponentDialog。(I022e3、b/234274777)。
  • 片段 commitNow()、executePendingTransactions() 和 popBackStackImmediate() API 已標記為 @MainThread，這表示如果未從主執行緒呼叫這些 API，就會擲回建構錯誤，而不是在執行階段等待失敗。(Ic9665、b/236538905)。

修正錯誤

  • 修正 FragmentManager 中的錯誤，在同一個畫面中儲存及還原資料可能會導致異常終止。(Ib36af、b/246519668)。
  • OnBackStackChangedListener onBackStackChangeStarted 和 onBackStackChangeCommitted 回呼現在只會在 FragmentManager 返回堆疊變更時執行。(I66055、b/274788957)。

1.6.0-alpha08 版

2023 年 3 月 22 日

發布 androidx.fragment:fragment-*:1.6.0-alpha08。1.6.0-alpha08 版包含以下修訂項目。

行為變更

  • OnBackStackChangedListener.onBackStackChangeCommited 回呼的時機已調整為在片段作業執行前執行。這麼做可確保回呼不會傳遞已分離的片段。(I66a76、b/273568280)。

修正錯誤

  • 在 Fragment 1.5.6 中：修正在 Lifecycle 已 STARTED 且結果已可使用時，在 setFragmentResultListener 中呼叫 clearFragmentResultListener 會失敗的問題。(If7458)

依附元件更新

1.6.0-alpha07 版

2023 年 3 月 8 日

發布 androidx.fragment:fragment-*:1.6.0-alpha07。1.6.0-alpha07 版包含以下修訂項目。

修正錯誤

  • 在 Fragment 1.5.6 中：修正移除任何 Fragment 的問題，無論是否已新增選單項目，都會使活動的選單失效。(50f098、b/244336571)。

1.6.0-alpha06 版

2023 年 2 月 22 日

發布 androidx.fragment:fragment-*:1.6.0-alpha06。1.6.0-alpha06 版包含以下修訂項目。

行為變更

  • FragmentManager 的 onBackStackChangedListener 上的新 onBackStackChangedStarted 回呼現在會在片段開始移至目標狀態前執行。(I34726)。

1.6.0-alpha05 版

2023 年 2 月 8 日

發布 androidx.fragment:fragment-*:1.6.0-alpha05。1.6.0-alpha05 版包含以下修訂項目。

新功能

  • FragmentManager.OnBackStackChagnedListener 介面現在提供 onBackStackChangeStarted 和 onBackStackChangeCommitted 這兩個額外的回呼，可提供更多額外資訊，並控管 FragmentManager 中返回堆疊的變更時間 (Ib7ce5、b/238686802)。

API 變更

  • 採用 Intent 或 IntentSender 的 Fragment 和 FragmentManager API 現在可正確加註 @NonNull，以免傳遞空值，因為空值一定會立即導致這些方法呼叫的各個 Android 架構 API 發生當機問題 (I06fd4)。

1.6.0-alpha04 版本

2022 年 12 月 7 日

發布 androidx.fragment:fragment-*:1.6.0-alpha04。1.6.0-alpha04 版本包含以下修訂版本。

新功能

  • FragmentStrictMode 新增了 WrongNestedHierarchyViolation，可偵測子項片段是否以巢狀結構位於其父項的檢視區塊階層中，但不會新增至父項的 childFragmentManager。(I72521, b/249299268)

行為變更

  • 片段現在會在 onAttach() 之前還原其 SavedStateRegistry 狀態，以確保可從所有向上生命週期方法中取得。(I1e2b1)

API 變更

  • fragment-testing-manifest 成果會將資訊清單項目與片段測試元件的其他部分分開。也就是說，您可以執行以下操作：
debugImplementation("androidx.fragment:fragment-testing-manifest:X.Y.Z")
androidTestImplementation("androidx.fragment:fragment-testing:X.Y.Z")

這可避免因 fragment-testing 與 androidx.test 之間的版本偏差而發生衝突。(I8e534、b/128612536)

修正錯誤

  • 在 Fragment 1.5.5 中：Fragment 不再錯誤地將 ViewModel 狀態儲存為檢視畫面註冊資料庫儲存狀態的一部分。(I10d2b, b/253546214)

1.6.0-alpha03 版本

2022 年 10 月 5 日

發布 androidx.fragment:fragment:1.6.0-alpha03、androidx.fragment:fragment-ktx:1.6.0-alpha03 和 androidx.fragment:fragment-testing:1.6.0-alpha03。1.6.0-alpha03 版本包含以下修訂項目。

API 變更

  • 延伸 DialogFragment 的類別現在須在其 onDismiss() 覆寫中呼叫超級程式庫 (I14798、b/238928865)。

修正錯誤

  • 修正整合新的供應商回呼介面 (OnConfigurationChangedProvider、OnMultiWindowModeChangedProvider、OnTrimMemoryProvider、OnPictureInPictureModeChangedProvider) 時引發的迴歸問題，確保片段一律會獲得適當的回呼 (I9b380、I34581、(I8dfe6、b/242570955)、If9d6b、Id0096、I690b3、I2cba2)。

1.6.0-alpha02 版本

2022 年 8 月 24 日

發布 androidx.fragment:fragment:1.6.0-alpha02、androidx.fragment:fragment-ktx:1.6.0-alpha02 和 androidx.fragment:fragment-testing:1.6.0-alpha02。1.6.0-alpha02 版包含以下修訂項目。

修正錯誤

  • 片段1.5.2︰修正同時執行 popBackStack() 和 replace() 交易的問題，會導致離開的片段執行錯誤的 Animation/Animator (Ib1c07、b/214835303)。

1.6.0-alpha01 版本

2022 年 7 月 27 日

發布 androidx.fragment:fragment:1.6.0-alpha01、androidx.fragment:fragment-ktx:1.6.0-alpha01 和 androidx.fragment:fragment-testing:1.6.0-alpha01。1.6.0-alpha01 版包含以下修訂項目。

行為變更

  • Fragment 的儲存狀態已全面區分成兩種類型，一種是私人程式庫狀態 (自訂 Parcelable 類別)，另一種則是開發人員提供的狀態；開發人員提供的狀態現在一律儲存在 Bundle 之中，允許判定片段的狀態確切來自於何處 (b/207158202)。

修正錯誤

  • 在 Fragment 1.5.1 中：修正 DialogFragmentCallbacksDetector 中的迴歸 (使用 Lint 版本套裝組合與 AGP 7.4 會導致 Lint 當機的問題) (b/237567009)。

依附元件更新

1.5 版本

1.5.7 版

2023 年 4 月 19 日

發布 androidx.fragment:fragment:1.5.7、androidx.fragment:fragment-ktx:1.5.7 和 androidx.fragment:fragment-testing:1.5.7。1.5.7 版包含以下修訂項目。

修正錯誤

  • 使用 postponeEnterTransition 搭配逾時，然後取代延後的片段，不再會導致延後的片段發生外洩。(I2ec7d、b/276375110)。

1.5.6 版

2023 年 3 月 22 日

發布 androidx.fragment:fragment:1.5.6、androidx.fragment:fragment-ktx:1.5.6 和 androidx.fragment:fragment-testing:1.5.6。1.5.6 版包含以下修訂項目。

修正錯誤

  • 修正問題：無論是否已新增選單項目，移除任何 Fragment 都會使活動的選單失效。(50f098、b/244336571)。
  • 修正問題：如果 Lifecycle 已 STARTED 且結果已可使用，在 setFragmentResultListener 中呼叫 clearFragmentResultListener 就不會運作。(If7458)

1.5.5 版本

2022 年 12 月 7 日

發布 androidx.fragment:fragment:1.5.5、androidx.fragment:fragment-ktx:1.5.5 和 androidx.fragment:fragment-testing:1.5.5。1.5.5 版包含以下修訂版本。

修正錯誤

  • Fragment 不再將 ViewModel 狀態錯誤儲存為檢視畫面註冊資料庫儲存狀態的一部分。(I10d2b, b/253546214)

1.5.4 版本

2022 年 10 月 24 日

發布 androidx.fragment:fragment:1.5.4、androidx.fragment:fragment-ktx:1.5.4 和 androidx.fragment:fragment-testing:1.5.4。1.5.4 版包含以下修訂項目。

修正錯誤

  • 已修正主機未實作提供者回呼介面 (OnConfigurationChangedProvider、OnMultiWindowModeChangedProvider、OnTrimMemoryProvider、OnPictureInPictureModeChangedProvider) 的自訂 FragmentController，以及呼叫已淘汰的調度函式可能無法調度至子項片段的錯誤 (I9b380)。

1.5.3 版本

2022 年 9 月 21 日

發布 androidx.fragment:fragment:1.5.3、androidx.fragment:fragment-ktx:1.5.3 和 androidx.fragment:fragment-testing:1.5.3。1.5.3 版包含以下修訂項目。

修正錯誤

  • 已修正導致返回堆疊上的片段取得 onMultiWindowModeChanged()、onPictureInPictureModeChanged()、onLowMemory() 和 onConfigurationChanged() 回呼的錯誤 (I34581、I8dfe6、b/242570955)
  • 巢狀結構子項片段將不再接收多個 onMultiWindowModeChanged()、onPictureInPictureModeChanged()、onLowMemory() 或 onConfigurationChanged() 回呼 (I690b3、Id0096、If9d6b、I2cba2)

1.5.2 版本

2022 年 8 月 10 日

發布 androidx.fragment:fragment:1.5.2、androidx.fragment:fragment-ktx:1.5.2 和 androidx.fragment:fragment-testing:1.5.2。1.5.2 版包含以下修訂項目。

修正錯誤

  • 修正問題：同時執行 popBackStack() 和 replace() 交易，會導致離開的片段執行錯誤的 Animation/Animator (Ib1c07、b/214835303)。

1.5.1 版本

2022 年 7 月 27 日

發布了 androidx.fragment:fragment:1.5.1、androidx.fragment:fragment-ktx:1.5.1 和 androidx.fragment:fragment-testing:1.5.1。1.5.1 版包含此連結所列的修訂項目。

修正錯誤

  • 修正 DialogFragmentCallbacksDetector 中的迴歸 (使用 Lint 版本套裝組合與 AGP 7.4 會導致 Lint 當機的問題) (b/237567009)。

依附元件更新

1.5.0 版本

2022 年 6 月 29 日

發布了 androidx.fragment:fragment:1.5.0、androidx.fragment:fragment-ktx:1.5.0 和 androidx.fragment:fragment-testing:1.5.0。1.5.0 版包含以下修訂版本。

自 1.4.0 版本以來的重要異動

  • CreationExtras 整合 - Fragment 現在可透過 Lifecycle 2.5.0 的 CreationExtras 提供無狀態 ViewModelProvider.Factory。
  • 元件對話方塊整合 - DialogFragment 現在會透過 Activity 1.5.0 使用 ComponentDialog 做為 onCreateDialog() 傳回的預設對話方塊。
  • 已儲存的執行個體狀態重構 - 片段儲存其執行個體狀態的方式已開始變更，這是為了清楚識別在片段中儲存的狀態，以及狀態的來源。目前的變更項目包括：
    • FragmentManager 現在會將已儲存的執行個體狀態儲存到 Bundle，而不是直接儲存至自訂的 Parcelable。
    • 透過 Fragment Result APIs 設定但尚未傳送的結果，現在會與 FragmentManager 的內部狀態分開儲存。
    • 與個別片段相關聯的狀態現在會與 FragmentManager 內部狀態分開儲存，方便您將與個別片段相關聯的已儲存狀態數量，與 Fragment 偵錯記錄中記錄的專屬 ID 建立關聯

其他變更

  • FragmentStrictMode 現在可讓第三方私人片段，使用含有類別名稱的 allowViolation() 來略過特定違規行為的懲罰。
  • 用於為活動 ActionBar 提供選單的 Fragment API 已淘汰。Activity 1.4.0 中新增的 MenuHost 和 MenuProvider API 提供了片段應使用的等同 API 介面，該介面可進行測試，且知道生命週期的情形。

1.5.0-rc01 版本

2022 年 5 月 11 日

發布 androidx.fragment:fragment:1.5.0-rc01、androidx.fragment:fragment-ktx:1.5.0-rc01 和 androidx.fragment:fragment-testing:1.5.0-rc01。1.5.0-rc01 版包含以下修訂項目。

已儲存的執行個體狀態重構

  • 與個別片段相關聯的狀態現在會與 FragmentManager 內部狀態分開儲存，方便您將與個別片段相關聯的已儲存狀態數量，與片段偵錯記錄中記錄的專屬 ID 建立關聯。(a153e0、b/207158202)。

1.5.0-beta01 版本

2022 年 4 月 20 日

發布了 androidx.fragment:fragment:1.5.0-beta01、androidx.fragment:fragment-ktx:1.5.0-beta01 和 androidx.fragment:fragment-testing:1.5.0-beta01。1.5.0-beta01 版包含以下修訂項目。

API 變更

  • DialogFragment 新增了新的 dismissNow 方法，該方法使用 commitNow 來與 showNow 函式進行成對。請注意，這樣做不會立即關閉 Dialog，而只會同步更新 FragmentManager 的狀態。(I15c36、b/72644830)

已儲存的執行個體狀態重構

  • FragmentManager 現在會將已儲存的執行個體狀態儲存到 Bundle，而不是直接儲存至自訂的 Parcelable。這是為片段實際儲存的內容提供更高透明度的第一步。(I93807、b/207158202)
  • 透過 Fragment Result API 設定但尚未傳送的結果，現在會與 FragmentManager 內部狀態分開儲存。這樣一來，就更容易掌握已儲存的執行個體狀態到底儲存了哪些結果。(I6ea12、b/207158202)

1.5.0-alpha05 版本

2022 年 4 月 6 日

發布了 androidx.fragment:fragment:1.5.0-alpha05、androidx.fragment:fragment-ktx:1.5.0-alpha05 和 androidx.fragment:fragment-testing:1.5.0-alpha05。1.5.0-alpha05 版包含以下修訂項目。

API 變更

1.5.0-alpha04 版本

2022 年 3 月 23 日

發布了 androidx.fragment:fragment:1.5.0-alpha04、androidx.fragment:fragment-ktx:1.5.0-alpha04 和 androidx.fragment:fragment-testing:1.5.0-alpha04。1.5.0-alpha04 版包含以下修訂項目。

API 變更

  • 用於為活動 ActionBar 提供選單的 Fragment API 已淘汰，因為這些 API 將片段與活動緊密結合，無法單獨測試。Activity 1.4.0-alpha01 中新增的 MenuHost 和 MenuProvider API 提供了片段應使用的等同 API 介面，該介面可進行測試，且知道生命週期的情形。(I50a59、I20758)

修正錯誤

  • SavedStateViewFactory 現在支援使用 CreationExtras (即使已透過 SavedStateRegistryOwner 初始化)。如果提供額外項目，系統將忽略初始化的引數 (I6c43b、b/224844583)。

1.5.0-alpha03 版

2022 年 2 月 23 日

發布了 androidx.fragment:fragment:1.5.0-alpha03、androidx.fragment:fragment-ktx:1.5.0-alpha03 和 androidx.fragment:fragment-testing:1.5.0-alpha03。1.5.0-alpha03 版包含以下修訂項目。

API 變更

  • 您現在可以將 CreationExtras 傳送至 by viewModels() 和 by activityViewModels() 函式。(Ibefe7、b/217601110)

行為變更

1.5.0-alpha02 版本

2022 年 2 月 9 日

發布了 androidx.fragment:fragment:1.5.0-alpha02、androidx.fragment:fragment-ktx:1.5.0-alpha02 和 androidx.fragment:fragment-testing:1.5.0-alpha02。1.5.0-alpha02 版包含此連結所列的修訂項目。

新功能

  • FragmentStrictMode 現在提供私人第三方片段的功能，可讓您使用有類別名稱的 allowViolation() 來略過特定違規行為。(I8f678)

1.5.0-alpha01 版本

2022 年 1 月 26 日

發布了 androidx.fragment:fragment:1.5.0-alpha01、androidx.fragment:fragment-ktx:1.5.0-alpha01 和 androidx.fragment:fragment-testing:1.5.0-alpha01。1.5.0-alpha01 版包含此連結所列的修訂項目。

新功能

修正錯誤

  • 在 Fragment 1.4.1 中：當 xml 產生的檢視 ID 為負值時，FragmentContainerView 不會再擲回非法狀態例外狀況。(Ic185b、b/213086140)
  • 在 Fragment 1.4.1 中：搭配 by viewModels() 延遲函式使用自訂 ownerProducer lambda 時，系統現在會在沒有提供自訂 ViewModelProvider.Factory 的情況下，使用該擁有者所提供的 defaultViewModelProviderFactory，而不是一律使用片段的工廠。(I56170、b/214106513)
  • 修正從 Fragment 的 registerForActivityResult() 回呼首次存取 ViewModel 時會停止運作的問題。(Iea2b3)

1.4 版本

1.4.1 版本

2022 年 1 月 26 日

發布 androidx.fragment:fragment:1.4.1、androidx.fragment:fragment-ktx:1.4.1 和 androidx.fragment:fragment-testing:1.4.1。1.4.1 版包含以下修訂項目。

修正錯誤

  • 當 xml 產生的檢視畫面 ID 為負值時，FragmentContainerView 不會再擲回非法狀態例外狀況。(Ic185b、b/213086140)
  • 搭配 by viewModels() 延遲函式使用自訂 ownerProducer lambda 時，系統現在會在沒有提供自訂 ViewModelProvider.Factory 的情況下，使用該擁有者所提供的 defaultViewModelProviderFactory，而不是一律使用片段的工廠。(I56170、b/214106513)

1.4.0 版本

2021 年 11 月 17 日

發布 androidx.fragment:fragment:1.4.0、androidx.fragment:fragment-ktx:1.4.0 和 androidx.fragment:fragment-testing:1.4.0。1.4.0 版包含以下修訂項目。

自 1.3.0 版以來的重要異動

  • FragmentStrictMode API 提供的執行階段檢查可讓您驗證依賴的應用程式或程式庫不會呼叫已淘汰的片段 API。當系統偵測到違規項目時，您可以選擇列印記錄訊息、觸發自己的自訂事件監聽器，或是讓應用程式停止運作。您可以透過新的 setStrictModePolicy() 方法在 FragmentManager 上設定 FragmentStrictMode.Policy，藉此控制要啟用哪些檢查以及觸發哪些「懲罰」。這項政策適用於該 FragmentManager，並會轉移給所有未設定專屬政策的子項片段管理員。請參閱適用於片段的 StrictMode。

  • FragmentContainerView 現在提供 getFragment() 方法，此方法會傳回最近新增至容器的片段。這會使用與 FragmentContainerView ID 相同的 findFragmentById() 邏輯，但允許鏈結呼叫。

    val navController = binding.container.getFragment<NavHostFragment>().navController

  • FragmentScenario 現已實作 Closeable，方便您搭配 Kotlin 的 use 方法或 try-with-resources 使用。

  • 新增 FragmentTransaction#TRANSIT_FRAGMENT_MATCH_ACTIVITY_{OPEN, CLOSE}，以指定是否要啟用在片段轉換效果中擷取自主題的標準「活動轉換」動畫。

  • 已移除 FragmentManager.enableNewStateManager(boolean) 的實驗性 API，現在只能使用新狀態管理員。

多個返回堆疊

FragmentManager 會維護使用 addToBackStack() 片段交易組成的返回堆疊。這可以讓您使用以片段儲存狀態機制來填入這些交易並回復先前的狀態，讓片段正確還原狀態。

此版本根據這三個新的 FragmentManager API (saveBackStack(String name)、restoreBackStack(String name) 和 clearBackStack(String name)) 進一步擴充這些機制。這些 API 使用與 addToBackStack() 相同的 name 來儲存 FragmentTransaction 的狀態，以及這些交易中所有新增片段的狀態，方便您日後使用完整的狀態來還原這些交易及其片段。這可讓您透過儲存目前的返回堆疊及還原已儲存的返回堆疊，以有效率的方式在多個返回堆疊之間「切換」。

saveBackStack() 的運作方式與 popBackStack() 類似，差別在於執行非同步動作時，所有片段交易都會傳回至該特定名稱，以便執行反向撤銷 (亦即「填入」) 以及所有即將捨棄的片段，但有以下幾項差異：

  • saveBackStack() 總是包含在內。
  • 如果在返回堆疊中找不到指定的名稱，或者提供的是空值名稱，popBackStack() 會在返回堆疊中填入所有交易。反之，如果您先前並未使用 addToBackStack() 提供確切的非空值名稱來修訂片段交易，saveBackStack() 就不會執行任何動作。
  • 只要是透過這些交易新增的片段，系統就會儲存其狀態。這表示系統會儲存所有片段的 View 狀態，呼叫每個片段的 onSaveInstanceState() 並還原該狀態，並且保留與這些片段相關聯的任何 ViewModel 執行個體 (且不會對這些片段呼叫 onCleared())。

可與 saveBackStack() 搭配使用的片段交易必須符合下列條件：

  • 所有片段交易都必須使用 setReorderingAllowed(true)，確保交易能夠以單一、不可部分完成的作業進行還原。
  • 所儲存的交易組合必須保持獨立 (也就是說，交易不得明確參照該交易組合以外的任何片段)，以確保不論返回堆疊日後發生任何變更，交易隨時都能順利還原。
  • 所有儲存的片段都不得為保留片段，也不得在其子項片段的過渡組合中建立保留片段，以確保 FragmentManager 不會在返回堆疊儲存後將任何參照傳回至已儲存片段。

與 saveBackStack() 類似，restoreBackStack() 和 clearBackStack() 分別會還原先前儲存的返回堆疊，以及清除先前儲存的返回堆疊，但如果您先前不曾使用相同的名稱呼叫 saveBackStack()，它們都不會執行任何動作。

詳情請參閱多個返回堆疊：深入探索一文。

1.4.0-rc01 版本

2021 年 11 月 3 日

發布 androidx.fragment:fragment:1.4.0-rc01，且自 Fragment 1.4.0-beta01 以來皆無異動。1.4.0-rc01 版包含以下修訂項目。

1.4.0-beta01 版本

2021 年 10 月 27 日

發布 androidx.fragment:fragment:1.4.0-beta01、androidx.fragment:fragment-ktx:1.4.0-beta01 和 androidx.fragment:fragment-testing:1.4.0-beta01。1.4.0-beta01 版本包含這些修訂版本。

修正錯誤

  • 父項片段現在會分派 onHiddenChanged() 至其整個階層，然後再啟動自己的回呼。(Iedc20、b/77504618)
  • 現在如果使用開放鍵盤從一個片段前往另一個有回收器檢視畫面的片段，鍵盤會自動關閉。(I8b842、b/196852211)
  • DialogFragment 現在會在您呼叫 show()、showNow() 或 dismiss() 時，針對其所有建立的交易使用 setReorderingAllowed(true)。(Ie2c14)
  • DetachAndAttachFragmentInSameFragmentTransaction 的極長 Lint 警告已縮短為 DetachAndAttachSameFragment。(e9eca3)

1.4.0-alpha10 版本

2021 年 9 月 29 日

發布 androidx.fragment:fragment:1.4.0-alpha10、androidx.fragment:fragment-ktx:1.4.0-alpha10 和 androidx.fragment:fragment-testing:1.4.0-alpha10。1.4.0-alpha10 版包含以下修訂項目。

Lint

  • 新增 DetachAndAttachFragmentInSameFragmentTransaction Lint 警告，用於偵測在相同的 FragmentTransaction 中，於同一個 Fragment 同時呼叫 detach() 和 attach() 的情形，由於這些互補作業會在相同交易中完成時取消彼此，因此必須將它們拆分為不同交易，才能實際執行。(aosp/1832956、b/200867930)
  • 使用 MenuHost 的 addMenuProvider API 時，針對 Fragment Lifecycle 的修正功能在 Fragment 檢視畫面 Lifecycle 加入 FragmentAddMenuProvider Lint 錯誤。(aosp/1830457、b/200326272)

說明文件更新

  • API 的淘汰訊息現在已由 Activity Result API (即startActivityForResult、startIntentSenderForResult、onActivityResult、requestPermissions 和 onRequestPermissionsResult) 處理，並已加以擴充以提供更多詳細資料。(cce80f)
  • Fragment 和 DialogFragment 的 onActivityCreated() 淘汰訊息已全部展開，而且提供更多詳細資料。(224db4)

1.4.0-alpha09 版本

2021 年 9 月 15 日

發布 androidx.fragment:fragment:1.4.0-alpha09、androidx.fragment:fragment-ktx:1.4.0-alpha09 和 androidx.fragment:fragment-testing:1.4.0-alpha09。1.4.0-alpha09 版包含以下修訂項目。

新功能

  • 您現在可以呼叫 clearBackStack(name) 以清除先前使用 saveBackStack(name) 儲存的任何狀態。(I70cd7)

API 變更

  • FragmentContainerView 類別已按照 Kotlin 重新編寫，確保 getFragment 函式正確遵循空值。(If694a、b/189629145)
  • FragmentstrictMode 現已以 Kotlin 編寫 (I11767、b/199183506)

修正錯誤

  • 透過 setReorderingAllowed(true) 新增片段，並在執行待處理交易前立即移除該片段的情況下，片段的狀態無法正確清理，這個問題現已修正。(I8ccb8)

1.4.0-alpha08 版本

2021 年 9 月 1 日

發布 androidx.fragment:fragment:1.4.0-alpha08、androidx.fragment:fragment-ktx:1.4.0-alpha08 和 androidx.fragment:fragment-testing:1.4.0-alpha08。1.4.0-alpha08 版包含以下修訂項目。

修正錯誤

  • 改善 UseRequireInsteadOfGet Lint 檢查功能，以更妥善的方式處理冗餘括號。(I2d865)
  • 改善 UseGetLayoutInflater Lint 檢查功能，以處理額外的邊緣案例。(Ie5423)

1.4.0-alpha07 版本

2021 年 8 月 18 日

發布 androidx.fragment:fragment:1.4.0-alpha07、androidx.fragment:fragment-ktx:1.4.0-alpha07 和 androidx.fragment:fragment-testing:1.4.0-alpha07，但沒有重大異動。1.4.0-alpha07 版包含以下修訂項目。

1.4.0-alpha06 版本

2021 年 8 月 4 日

發布 androidx.fragment:fragment:1.4.0-alpha06、androidx.fragment:fragment-ktx:1.4.0-alpha06 和 androidx.fragment:fragment-testing:1.4.0-alpha06。1.4.0-alpha06 版包含以下修訂項目。

修正錯誤

  • 修正在返回堆疊之間快速切換時，如果還原 FragmentTransaction 為顯示片段的第二副本，就會有多個返回堆疊以 IllegalStateException 顯示的問題。(I9039f)
  • 修正即使在還原狀態之後，FragmentManager 仍會保留之前透過 saveBackStack() 儲存狀態副本的問題。(Ied212)
  • 透過 show(FragmentTransaction, String) 方法明確新增 DialogFragment 時，在狀態儲存完畢後呼叫 DialogFragment 的 dismissAllowingStateLoss() 方法不會再導致當機。(I84422)

1.4.0-alpha05 版本

2021 年 7 月 21 日

發布 androidx.fragment:fragment:1.4.0-alpha05、androidx.fragment:fragment-ktx:1.4.0-alpha05 和 androidx.fragment:fragment-testing:1.4.0-alpha05。1.4.0-alpha05 版包含以下修訂項目。

修正錯誤

  • 在 Fragment 1.3.6 中：當根層級檢視畫面已設定 transitionGroup=”true” 時，Fragment 的檢視畫面現在會於使用 hide() 時正確設定為 GONE。(aosp/1766655、b/193603427)
  • 在 Fragment 1.3.6 中：FragmentActivity 現在一律會解鎖儲存的狀態為生命週期回呼中覆寫的第一個作業。(I6db7a)

依附元件更新

1.4.0-alpha04 版本

2021 年 6 月 30 日

發布 androidx.fragment:fragment:1.4.0-alpha04、androidx.fragment:fragment-ktx:1.4.0-alpha04 和 androidx.fragment:fragment-testing:1.4.0-alpha04。1.4.0-alpha04 版包含此連結所列的修訂項目。

API 變更

  • 現在 FragmentManager 會在背景中使用 SavedStateRegistry 儲存狀態。saveAllState() 和 restoreSavedState() 方法現在已於 FragmentController 中淘汰。如果您要使用 FragmentController 代管位於 FragmentActivity 以外的片段，就必須讓 FragmentHostCallbacks 執行 SavedStateRegistryOwner。(Iba68e、b/188734238)

修正錯誤

  • 修正問題：執行使用 replace() 的 FragmentTransaction 時如果同時完成，呼叫 saveBackStack() 做為支援多個返回堆疊的要求會失敗。(I73137)
  • 修正如果針對多個返回堆疊支援使用 restoreBackStack() API，就會在手動儲存包含多個交易的返回堆疊後出現 NullPointerException 的問題。這也修正了系統不會針對所有交易檢查 setReorderingAllowed(true) 的問題。(I8c593)
  • 修正問題：FragmentManager 以錯誤的方式繼續還原之前已儲存的片段狀態，即使那些片段已從 FragmentManager 移除也會如此，因此導致儲存的狀態會隨著時間持續增長。(I1fb8e)

1.4.0-alpha03 版本

2021 年 6 月 16 日

發布 androidx.fragment:fragment:1.4.0-alpha03、androidx.fragment:fragment-ktx:1.4.0-alpha03 和 androidx.fragment:fragment-testing:1.4.0-alpha03。1.4.0-alpha03 版包含以下修訂項目。

新功能

  • 所有 Fragment strictMode Violation 類別已更新，提供更詳細的錯誤訊息，說明違規問題詳情。(b/187871638)
    • FragmentTagUsageViolation 現在包含更詳細的錯誤訊息，說明容器要插入片段的父項容器。(Ic33a7)
    • WrongFragmentContainerViolation 現在有更詳細的錯誤訊息，包括要新增片段的容器。(Ib55f8)
    • TargetFragmentUsageViolation 的用途類別現在包含更詳細的錯誤訊息，說明違規事項和任何其他包含的資訊。(Icc6ac)
    • 擴充 RetainInstanceUsageViolation 的類別現在有更詳細的錯誤訊息，包含導致違規的片段。(I6bd55)
    • FragmentReuseViolation 現在提供更多詳細錯誤訊息，包含片段的前一個 ID。(I28ce2)
    • SetUserVisibleHintViolation 現在會顯示更詳細的錯誤訊息，包含設定的使用者顯示提示。(Ib2d5f)

行為變更

  • 已還原在 FragmentContainerView 上呼叫 fitsSystemWindows 的限制 - 應用程式不再因此當機。(6b8ddd、b/190622202)

修正錯誤

  • 在 Fragment 1.3.5 中：修正在 Fragment 1.3.4 由 aosp/1679887 造成的共用元素轉換中的迴歸。片段現在可以正確地處理轉換群組 (直接透過 transitionGroup="true" 設定，或透過 transitionName 或 background 間接設定)，共用元素將不再傳送 IndexOutOfBoundsException。(I16484、b/188679569、b/188969304)
  • 嘗試隱藏移除的片段時，FragmentManager 不會再停止運作 (I573dd、b/183634730)
  • 評估最高等級變數時，OnCreateDialogIncorrectCallback Lint 檢查將不再停止運作。(0a9efa、b/189967522)。

1.4.0-alpha02 版本

2021 年 6 月 2 日

發布 androidx.fragment:fragment:1.4.0-alpha02、androidx.fragment:fragment-ktx:1.4.0-alpha02 和 androidx.fragment:fragment-testing:1.4.0-alpha02。1.4.0-alpha02 版包含此連結所列的修訂項目。

新功能

  • 現在無論目前使用的嚴格模式政策為何，FragmentStrictMode 都會透過 FragmentManager 進行記錄時一律記錄違規行為。(I02df6、b/187872638)。

  • FragmentStrictMode 現支援將特定 Fragment 類別從嚴格模式 Violation 中排除，使該類別略過任何懲處。(Ib4e5d、b/184786736)

  • 我們已進一步擴充 FragmentStrictMode Violation 類別，以根據每項違規加入結構資訊。這可讓您驗證導致違規的確切原因以及違規的片段 (If5118、b/187871150)，每個 Violation 包含以下項目：

    • WrongFragmentContainerViolation 現在包含 Fragment 嘗試加入的目標 ViewGroup。(I83c75、b/187871150)
    • TargetFragmentUsageViolation 已展開為 SetTargetFragmentUsageViolation、GetTargetFragmentUsageViolation 和 GetTargetFragmentRequestCodeUsageViolation，其中 SetTargetFragmentUsageViolation 包含目標片段和要求代碼。(I741b4、b/187871150)
    • SetUserVisibleHintViolation 現在包含傳送至 setUserVisibleHint() 的布林值 (I00585、b/187871150)
    • FragmentTagUsageViolation 現在包含 <fragment> 標記嘗試將片段灌入的 ViewGroup。(I5dbbc、b/187871150)
    • FragmentReuseViolation 現在包含過去導致 Viotion 的 Fragment 執行個體專屬 ID。(I0544d、b/187871150)
    • RetainInstanceUsageViolation 現在為摘要，且有兩個子類別：SetRetainInstanceUsageViolation 和 GetRetainInstanceUsageViolation，分別代表兩種違規類型的案件。(Ic81e5、b/187871150)

行為變更

  • FragmentContainerView 現在在嘗試以程式控制方式或透過 XML 變更 fitsSystemWindow 屬性時，會擲回例外狀況。插邊應由個別片段的檢視畫面處理。(Ie6651、b/187304502)

1.4.0-alpha01 版本

2021 年 5 月 18 日

發布 androidx.fragment:fragment:1.4.0-alpha01、androidx.fragment:fragment-ktx:1.4.0-alpha01 和 androidx.fragment:fragment-testing:1.4.0-alpha01。1.4.0-alpha01 版包含以下修訂版本。

新功能

  • FragmentContainerView 現在提供 getFragment() 方法，此方法會傳回最近新增至容器的片段。這會使用 ID 與 FragmentContainerView 相同的 findFragmentById() 邏輯，但允許鏈結呼叫。(Ife17a、b/162527857)

    val navController = binding.container.getFragment<NavHostFragment>().navController

  • 新增 FragmentTransaction#TRANSIT_FRAGMENT_MATCH_ACTIVITY_{OPEN, CLOSE}，以指定是否要啟用在片段轉換效果中擷取自主題的標準「活動轉換」動畫。(I46652)

多個返回堆疊

FragmentManager 會維護使用 addToBackStack() 片段交易組成的返回堆疊。這可以讓您使用以片段儲存狀態機制來填入這些交易並回復先前的狀態，讓片段正確還原狀態。

此版本根據這兩個新的 FragmentManager API (saveBackStack(String name) 和 restoreBackStack(String name)) 進一步擴充這些機制。這些 API 使用與 addToBackStack() 相同的 name 來儲存 FragmentTransaction 的狀態，以及這些交易中所有新增片段的狀態，方便您日後使用完整的狀態來還原這些交易及其片段。這可讓您透過儲存目前的返回堆疊及還原已儲存的返回堆疊，以有效率的方式在多個返回堆疊之間「切換」。

saveBackStack() 的運作方式與 popBackStack() 類似，差別在於執行非同步動作時，所有片段交易都會傳回至該特定名稱，以便執行反向撤銷 (亦即「填入」) 以及所有即將捨棄的片段，但有以下幾項差異：

  • saveBackStack() 總是包含在內。
  • 如果在返回堆疊中找不到指定的名稱，或者提供的是空值名稱，popBackStack() 會在返回堆疊中填入所有交易。反之，如果您先前並未使用 addToBackStack() 提供確切的非空值名稱來修訂片段交易，saveBackStack() 就不會執行任何動作。
  • 只要是透過這些交易新增的片段，系統就會儲存其狀態。這表示系統會儲存所有片段的 View 狀態，呼叫每個片段的 onSaveInstanceState() 並還原該狀態，並且保留與這些片段相關聯的任何 ViewModel 執行個體 (且不會對這些片段呼叫 onCleared())。

可與 saveBackStack() 搭配使用的片段交易必須符合下列條件：

  • 所有片段交易都必須使用 setReorderingAllowed(true)，確保交易能夠以單一、不可部分完成的作業進行還原。
  • 所儲存的交易組合必須保持獨立 (也就是說，交易不得明確參照該交易組合以外的任何片段)，以確保不論返回堆疊日後發生任何變更，交易隨時都能順利還原。
  • 所有儲存的片段都不得為保留片段，也不得在其子項片段的過渡組合中建立保留片段，以確保 FragmentManager 不會在返回堆疊儲存後將任何參照傳回至已儲存片段。

與 saveBackStack() 類似，如果您之前不曾使用相同的名稱呼叫 saveBackStack()，restoreBackStack() 就不會有任何動作。(b/80029773)

Fragment strictMode

FragmentStrictMode API 提供的執行階段檢查可讓您驗證依賴的應用程式或程式庫不會呼叫已淘汰的片段 API。當系統偵測到違規項目時，您可以選擇列印記錄訊息、觸發自己的自訂事件監聽器，或是讓應用程式停止運作。您可以透過新的 setStrictModePolicy() 方法在 FragmentManager 上設定 FragmentStrictMode.Policy，藉此控制要啟用哪些檢查以及觸發哪些「懲罰」。這項政策適用於該 FragmentManager，並會轉移給所有未設定專屬政策的子項片段管理員。(#123、#131、#150、b/143774122)

  • 不論先前移除的 Fragment 執行個體是否會重新加入至 FragmentManager，detectFragmentReuse() 都會偵測。在 Fragment 執行個體已經刪除且從 FragmentManager 移除後，請勿與其互動或保留其參考。(#142、b/153738653)
  • detectFragmentTagUsage() 會偵測您是否於版面配置 XML 中使用 <fragment> 標記。加載片段為版面配置的部分時，您應總是使用 FragmentContainerView。(#141、b/153738235)
  • detectWrongFragmentContainer() 會偵測您新增至容器的片段是否不是 FragmentContainerView。建議您一律使用 FragmentContainerView 做為版面配置中的片段容器。(#146、b/181137036)
  • detectRetainInstanceUsage() 會偵測您是否使用已淘汰的 setRetainInstance() 或 getRetainInstance() API。(#140、b/153737954)
  • detectSetUserVisibleHint() 會偵測你是否使用已淘汰的 setUserVisibleHint() API。(#136、b/153738974)
  • detectTargetFragmentUsage() 會偵測您是否使用已淘汰的 setTargetFragment()、getTargetFragment() 或 getTargetRequestCode() API。(#139、b/153737745)

API 變更

新的 Lint 檢查

  • 在 DialogFragment 中使用 LayoutInflater.from(Context) 時，UseGetLayoutInflater Lint 檢查現在會顯示警告 - 請務必使用對話方塊片段的 getLayoutInflater() 方法以取得適合的 LayoutInflater。(#156、b/170781346)
  • DialogFragmentCallbacksDetector Lint 檢查現在會於 DialogFragment 的 onCreateDialog() 方法中呼叫 setOnCancelListener 或 setOnDismissListener 時發出警告 - 這些事件監聽器為 DialogFragment 擁有，且您應覆寫 onCancel() 和 onDismiss() 以接收這些回呼。(#171、b/181780047、b/187524311)

修正錯誤

  • 在 Fragment 1.3.4 中：修正搭配 ViewModelProvider 或在 Fragment 中 的 viewModel() Jetpack Compose 方法使用 ViewTreeViewModelStoreOwner.get() 時，會在 Fragment 1.3.3 加入迴歸的問題。如果片段會覆寫 getDefaultViewModelProviderFactory()，這些用途現在會正確地使用該片段提供的 ViewModelProvider.Factory (與 @AndroidEntryPoint 使用 Hilt 時註解 Fragment 的方式相同)。如果未覆寫該方法，與 Fragment 檢視畫面一起的儲存和還原狀態的 SavedStateViewModelFactory 就會建立為預設中心。(I5cbfa、b/186097368)
  • 在 Fragment 1.3.4 中：在 API 29 上使用 FragmentContainerView 時，插邊不會再無限期地分派，這修正了 BottomNavigationBar 和 FloatingActionButton 執行個體的問題。(I1bb78、b/186012452)
  • 在 Fragment 1.3.4 中：現在您可以在處理結束後，從片段結果套裝組合中擷取 Parcelable。(I65932、b/187443158)
  • 在 Fragment 1.3.4 中：在 ViewGroup 上執行共用元素轉換時，如果 ViewGroup 的 transitionGroup 設為 False，就能正確進行轉換。(I99675)

外部貢獻

1.3 版本

1.3.6 版本

2021 年 7 月 21 日

發布 androidx.fragment:fragment:1.3.6、androidx.fragment:fragment-ktx:1.3.6 和 androidx.fragment:fragment-testing:1.3.6。1.3.6 版包含以下修訂項目。

修正錯誤

  • 在 Fragment 1.4.0-alpha03 中：嘗試隱藏移除片段時，FragmentManager 不會再停止運作。(I573dd、b/183634730)
  • 當根層級畫面檢視已設定 transitionGroup=”true” 時，Fragment 的畫面檢視現在會於使用 hide() 時正確地設為 GONE。(aosp/1766655、b/193603427)
  • FragmentActivity 現在一律會解鎖儲存的狀態為生命週期回呼中覆寫的第一個作業。(I6db7a)

依附元件更新

1.3.5 版本

2021 年 6 月 16 日

發布 androidx.fragment:fragment:1.3.5、androidx.fragment:fragment-ktx:1.3.5 和 androidx.fragment:fragment-testing:1.3.5。1.3.5 版包含以下修訂項目。

修正錯誤

  • 修正在 Fragment 1.3.4 由 aosp/1679887 造成的共用元素轉換中的迴歸。片段現在可以正確地處理轉換群組 (直接透過 transitionGroup="true" 設定，或透過 transitionName 或 background 間接設定)，共用元素將不再傳送 IndexOutOfBoundsException。(I16484、b/188679569、b/188969304)

1.3.4 版本

2021 年 5 月 18 日

發布 androidx.fragment:fragment:1.3.4、androidx.fragment:fragment-ktx:1.3.4 和 androidx.fragment:fragment-testing:1.3.4。1.3.4 版包含以下修訂項目。

修正錯誤

  • 修正搭配 ViewModelProvider 或在 Fragment 中 的 viewModel() Jetpack Compose 方法使用 ViewTreeViewModelStoreOwner.get() 時，會在 Fragment 1.3.3 加入迴歸的問題。如果片段會覆寫 getDefaultViewModelProviderFactory()，這些用途現在會正確地使用該片段提供的 ViewModelProvider.Factory (與 @AndroidEntryPoint 註解片段的方式相同)。如果未覆寫該方法，與 Fragment 檢視畫面一起的儲存和還原狀態的 SavedStateViewModelFactory 就會建立為預設中心。(I5cbfa、b/186097368)
  • 在 API 29 上使用 FragmentContainerView 時，插邊不會再無限期地分派，這修正了 BottomNavigationBar 和 FloatingActionButton 執行個體的問題。(I1bb78、b/186012452)
  • 現在您可以在處理結束後，從片段結果套裝組合中擷取 Parcelable。(I65932、b/187443158)
  • 在 ViewGroup 上執行共用元素轉換時，如果 ViewGroup 的 transitionGroup 設為 False，就能正確進行轉換。(I99675)

1.3.3 版本

2021 年 4 月 21 日

發布 androidx.fragment:fragment:1.3.3、androidx.fragment:fragment-ktx:1.3.3 和 androidx.fragment:fragment-testing:1.3.3。1.3.3 版包含以下修訂項目。

新功能

  • 搭配 Fragment 的 View 使用 ViewTreeSavedStateRegistryOwner.get() 時，傳回的 SavedStateRegistryOwner 現在可以正確與 SavedStateViewModelFactory 搭配使用。(I21acf、b/181577191)

修正錯誤

  • 修正 Fragment 1.3.2 中引起的迴歸問題；填入 FragmentTransaction 且包含 setPrimaryNavFragment 作業 (例如 NavHostFragment 使用的作業) 時，此問題會導致 popEnter 動畫無法執行。(I38c87、b/183877426)
  • FragmentContainerView 現在會確保每個 Fragment 都會分派一組新的 WindowInsets，確保每個片段現在都能獨立消耗插邊。(I63f68、b/172153900)
  • 當子項片段所加入的容器與自訂 Dialog 類別的其中一個容器 ID 相同時，DialogFragment 現在可以妥善處理這類情況，因此解決了重複使用 BottomSheetDialog 等對話方塊內部使用的 ID 時導致的檢視區塊階層問題。(Ie6279、b/180021387)
  • FragmentManager.dump() 現在可正確地在已啟用片段的清單中縮排第一個片段。(If5c33、b/183705451)

新狀態管理員錯誤修正

  • 新的片段狀態管理員現在可透過隱藏作業，正確地處理結束事件轉換。(I9e4de、b/184830265)

1.3.2 版本

2021 年 3 月 24 日

發布 androidx.fragment:fragment:1.3.2、androidx.fragment:fragment-ktx:1.3.2 和 androidx.fragment:fragment-testing:1.3.2。1.3.2 版包含以下修訂項目。

新狀態管理員錯誤修正

  • 同時執行 popBackStack() 和 commit() 作業時，上次作業會設定所有動畫的方向，而不會執行某些快顯動畫和部分進入的動畫。(I7072e、b/181142246)
  • 在共用元素階層中的檢視畫面將不再於執行共用元素轉換時清除轉換名稱。(I4d4a6、b/179934757)

依附元件更新

  • 片段現在依附於 Activity 1.2.2，修正使用 Fragment 1.3.1 以上版本時 Activity 的 InvalidFragmentVersionForActivityResult Lint 檢查問題。
  • 片段現在依附於 Lifycycle 2.3.1。

1.3.1 版本

2021 年 3 月 10 日

發布 androidx.fragment:fragment:1.3.1、androidx.fragment:fragment-ktx:1.3.1 和 androidx.fragment:fragment-testing:1.3.1。1.3.1 版包含以下修訂項目。

新功能

  • DialogFragment 中的對話方塊現可透過 DecorView 存取 ViewTree 擁有者，確保 DialogFragment 可與 ComposeView 搭配使用。(Ib9290、b/180691023)

修正錯誤

  • 使用 FragmentContainerView 匯入現有 RESUMED 活動的片段，現在會在設定變更後正確顯示。(Ie14c8、b/180538371)
  • 片段 toString() 的結尾不再有額外的 } (I54705、b/177761088)
  • FragmentActivity 中的覆寫方法現在可正確繼承基礎方法 javaDoc (I736ce、b/139548782)
  • setFragmentResult 和 setFragmentResultListener 的文件已更新其參數文件，使其不再接受是否可為空值 (I990ba、b/178348386)

新狀態管理員錯誤修正

  • 修正 mFocusedView 造成的片段記憶體流失問題 (Ib4e9e、b/179925887)
  • 使用顯示/隱藏交易時，片段現在可以正確呼叫 onCreateOptionsMenu (I8bce8、b/180255554)
  • 有片段 (轉換前開始) 的子項片段現在可以正確觸及 RESUMED (Ic11e6、b/180825150)
  • 使用 <fragment> 標記加載的片段現在一律適用於 RESUMED (I452ac、I9fa49)

依附元件更新

1.3.0 版本

2021 年 2 月 10 日

發布 androidx.fragment:fragment:1.3.0、androidx.fragment:fragment-ktx:1.3.0 和 androidx.fragment:fragment-testing:1.3.0。1.3.0 版包含以下修訂項目。

自 1.2.0 版以來的重大異動

  • 新的狀態管理員：FragmentManager 的重大內部重新編寫修正了多個生命週期、動畫和轉換分派的問題，以及延期片段的處理方式。

  • Activity Result API 整合：新增 Activity 1.2.0 的 ActivityResultRegistry API 支援，可處理 startActivityForResult()+onActivityResult() 和 requestPermissions()+onRequestPermissionsResult() 流程，除了針對測試這些流量提供的掛鉤之外，不會覆寫 Fragment 中的方法。請參閱最新的從活動取得結果。

    • 此版本修正了幾項無效要求代碼的問題以及權限指派要求，避免 Activity Result API 使用舊版 FragmentActivity。您必須升級至 1.3.0 版，才能在 FragmentActivity 或 AppCompatActivity 中使用 Activity Result API。

  • Fragment Result API：現支援透過 FragmentManager 的新 API 在兩個片段之間傳送結果。這項功能適用於「導覽」中的階層片段 (父項/子項)、DialogFragment 和片段，且可確保結果至少傳送給 STARTED 時，Fragment 才會傳送到您的片段。目標片段 API 已淘汰，並改用新的 API。請參閱使用 Fragment Result API 取得結果。

  • FragmentOnAttachListener：FragmentActivity 和 Fragment 的 onAttachFragment() 回呼已淘汰。已新增 FragmentOnAttachListener 以提供更靈活的替代方案，您可將 onAttachFragment() 委派給其他獨立且可測試的事件監聽器，並支援除了直接子項 FragmentManager 之外，在 FragmentManagers 中加入事件監聽器。

  • FragmentScenario 改善：fragment-testing 構件中的 FragmentScenario 類別在 Kotlin 中經過重新編寫，並進行了幾項改善：

    • FragmentScenario 現在使用 setMaxLifecycle() 以實作 moveToState()，確保所有 API 層級的行為一致，並解除 Fragment 狀態與基礎 Activity 之間的關係。
    • FragmentScenario 現在支援設定初始 Lifecycle.State，藉此在初次移動至各個 Lifecycle.State 前先確認片段狀態。
    • 現在提供 onFragment 的 FragmentScenario API 替代選項，此選項採用 Kotlin 修訂後擴充功能方法 withFragment，可讓您回傳值。值得一提的是，這個區塊會擷取指定區塊中產生的例外狀況。

  • ViewTree 支援：Fragment現在支援在Lifecycle 2.3.0 中新增的 ViewTreeLifecycleOwner.get(View)、ViewTreeViewModelStoreOwner.get(View) 和 ViewTreeSavedStateRegistryOwner API SavedState 1.1.0，可使 Fragment 傳回 ViewModelStoreOwner，Fragment 則與 SavedStateRegistryOwner 和 LifecycleOwner 連結至片段的 Lifecyle 檢視畫面 (在 Fragment 內使用 View 時)。

  • TRANSIT_ 動畫變更：片段預設效果、TRANSIT_FRAGMENT_OPEN、TRANSIT_FRAGMENT_CLOSE 和 TRANSIT_FRAGMENT_FADE 現在會使用 Animator，而不是 Animation。用於建構這些 Animator 的資源現已設為不公開。

  • setRetainInstance() 淘汰：Fragment 中的 setRetainInstance() 方法已淘汰。推出 ViewModels 後，開發人員可利用特定 API 保留狀態，並將其與 Activity、Fragment 和 Navigation 圖表建立關聯。因此，開發人員可以使用一般且未保留的片段，並分別保留所需的特定狀態，避免常見的外洩來源、同時保留單一建立與刪除保留狀態的實用屬性 (也就是 ViewModel 和 onCleared() 回呼)。

  • ViewPager 1 轉接程式淘汰：ViewPager2 1.0.0 推出後，與 ViewPager 互動的 FragmentPagerAdapter 和 FragmentStatePagerAdapter 類別已淘汰。請參閱從 ViewPager 移轉至 ViewPager2。

1.3.0-rc02 版本

2021 年 1 月 27 日

發布 androidx.fragment:fragment:1.3.0-rc02、androidx.fragment:fragment-ktx:1.3.0-rc02 和 androidx.fragment:fragment-testing:1.3.0-rc02。1.3.0-rc02 版包含此連結所列的修訂項目。

修正錯誤

  • 修正設定變更後，父項 DialogFragment 會顯示在子項 DialogFragment 上方的問題；子項對話方塊片段一律顯示在上層對話方塊片段上方。(I30806、b/177439520)
  • 修正問題：如果使用 Animation 執行 hide 作業，會導致隱藏片段在動畫結束時閃爍。(I57e22、b/175417675)
  • 在附加檢視表階層之前新增的轉換片段，現在可與 RESUMED 正確連結。(I1fc1d、b/177154873)

新狀態管理員錯誤修正

  • Fragment 的檢視畫面 Lifecycle 現在可以正確地處理在 Lifecycle 達到 CREATED 之前刪除片段的檢視畫面，避免出現表示「沒有來自 INITIALIZED 的下傳事件」例外內容。(eda2bd、b/176138645)
  • 使用 Animator 的片段現在會在使用 FragmentContainerView 時，以正確的順序顯示。(Id9aa3、b/176089197)

1.3.0-rc01 版本

2020 年 12 月 16 日

發布 androidx.fragment:fragment:1.3.0-rc01、androidx.fragment:fragment-ktx:1.3.0-rc01 和 androidx.fragment:fragment-testing:1.3.0-rc01。1.3.0-rc01 版包含以下修訂項目。

修正錯誤

  • onPrepareOptionsMenu() 現在使用與 onCreateOptionsMenu() 相同的邏輯，而父項片段呼叫 setMenuVisibility(false) 時不會再呼叫此方法。(Id7de8、b/173203654)

新狀態管理員錯誤修正

  • 已修正將含有 Animation 的片段新增至 FragmentContainerView 後，會干擾 Pop 作業加入的問題。(I952d8)
  • 修正在 onCreate() 或 onViewCreated() 方法中如果遭到取代，片段檢視畫面就會保留在檢視區塊階層中的問題。(I8a7d5)
  • 繼續處理時，聚焦現已還原至 Fragment 根層級檢視畫面。(Ifc84b)
  • 在同一個片段交易中結合填入和取代作業，現在會顯示正確的動畫 (Ifd4e4、b/170328691)

1.3.0-beta02 版本

2020 年 12 月 2 日

發布 androidx.fragment:fragment:1.3.0-beta02、androidx.fragment:fragment-ktx:1.3.0-beta02 和 androidx.fragment:fragment-testing:1.3.0-beta02。1.3.0-beta02 版包含以下修訂項目。

新功能

  • FragmentScenario 已完全轉換為 Kotlin，同時使用 Kotlin 1.4 適用於 FragmentAction 的功能介面，確保原始碼與二進位檔相容。(I19d31)

行為變更

  • 不用使用 class 或 android:name 屬性加載片段的 FragmentContainerView 現在可以在 FragmentActivity 之外使用。(Id4397、b/172266337)
  • 嘗試將片段時間生命週期上限設為 DESTROYED 時，將會擲回 IllegalArgumentException (Ie7651、b/170765622)
  • 初始化處於 DESTROYED 狀態的 FragmentScenario 時，現在會擲回 IllegalArgumentException (I73590、b/170765622)

新狀態管理員錯誤修正

  • 修正問題：如果使用 Animator 或 TRANSIT_FRAGMENT_ 選項的片段轉換過程中斷，檢視畫面不會達到最終狀態。(I92426、b/169874632)
  • 修正會導致正在結束 Animation 的片段無法正確刪除的錯誤 (I83d65)
  • 結束的片段如果反轉其效果，現在會正確地取消並以正確的輸入效果重新開始。(I62226、b/167092035)
  • 修正 hide() 的 Animator 結束事件無法執行的問題。(Id7ffe)
  • 片段現在會於延遲然後立即啟動時正確顯示。(Ie713b、b/170022857)
  • 片段如果在動畫期間移除其聚焦的檢視畫面，將不再於達到 RESUMED 時嘗試在卸離的檢視畫面上還原焦點 (I38c65、b/172925703)

外部貢獻

  • FragmentFactory 現在會針對不同的 ClassLoader 執行個體分別快取片段類別。感謝 Simon Schiller！(#87、b/113886460)

1.3.0-beta01 版本

2020 年 10 月 1 日

發布 androidx.fragment:fragment:1.3.0-beta01、androidx.fragment:fragment-ktx:1.3.0-beta01 和 androidx.fragment:fragment-testing:1.3.0-beta01。1.3.0-beta01 版包含以下修訂項目。

新功能

  • setMaxLifecycle() 現在支援將 Lifecycle 狀態設為 INITIALIZING，但前提是該片段尚未移至 CREATED。(b/159662173)

API 變更

行為變更

修正錯誤

  • 使用 <fragment> 標記加載的片段現在會正確等待，直到其檢視畫面加入容器中，再移動至 STARTED (I02f4c)
  • 會先顯示，然後 setMaxLifecycle() 至 CREATED 的片段現在會正確地執行其結束效果。(b/165822335)
  • 移除未新增至返回堆疊的卸離的片段，不會再造成記憶體流失。感謝 Nicklas Ansman Giertz！(b/166489383)
  • 使用中的片段現在一律有非空值 FragmentManager，且有非空值 FragmentManager 的片段一律視為使用中 (aosp/1422346)
  • 片段預設效果 TRANSIT_FRAGMENT_OPEN、TRANSIT_FRAGMENT_CLOSE 和 TRANSIT_FRAGMENT_FADE 現在會使用 Animator，而不是 Animation。(b/166155034)

新狀態管理員錯誤修正

  • 片段現在會在動畫開始播放前正確還原檢視畫面焦點狀態。(Icc256)
  • 只有共用元素轉換的片段，現在會正確完成其特殊效果，也就是說，這些片段會實際轉換至其最終狀態 (Iaebc7、b/166658128)
  • 在刪除片段前，系統一律會從容器中移除片段檢視。(Id5876)
  • 新版狀態管理員現在一律會先移除退場片段的檢視畫面，然後再加入進場片段的檢視畫面。(I41a6e)
  • 新版狀態管理員現在會遵循片段檢視畫面瀏覽權限的明確變更。也就是說，如果在動畫開始前將進入片段的檢視畫面設為 INVISIBLE，該檢視畫面就不會保持顯示。(b/164481490)
  • 片段現在會以 Animators 優先，而不是 Animations，也就是說，如果片段同時都有 Animator 和 Animation，就只會執行前者並忽略後者。(b/167579557)
  • 新的狀態管理員在使用進入動畫時，不會再導致片段閃爍。(b/163084315)

已知問題

使用新版狀態管理員時，如果在進場特殊效果期間按下返回，而不是返回上一個片段，系統不會再重新加入舊的片段，因而導致畫面空白。(b/167259187、b/167092035、b/168442830)

1.3.0-alpha08 版本

2020 年 8 月 19 日

發布 androidx.fragment:fragment:1.3.0-alpha08、androidx.fragment:fragment-ktx:1.3.0-alpha08 和 androidx.fragment:fragment-testing:1.3.0-alpha08。1.3.0-alpha08 版包含以下修訂項目。

新狀態管理員

此版本包含 FragmentManager 內部狀態管理的重大重構，主要影響生命週期方法、動畫和轉換作業的分派，以及延遲交易的處理方式。這個選項預設為啟用。詳情請參閱片段：重新建立內部網誌文章。(b/139536619、b/147749580)

  • 您可以使用 FragmentManager.enableNewStateManager(boolean) 中的實驗性 API 來控制 FragmentManager 是否使用新版狀態管理工具。(I7b6ee)

您只能透過使用新版狀態管理員的方式解決以下問題：

  • replace 作業的上一個片段現在會於新的片段開始前正確停止。(b/161654580)
  • 片段現在會避免在相同片段中出現多個競爭動畫，避免 Animation 覆寫所有 Transition 效果，或是只針對個別片段執行 Animator 和 Transition。(b/149569323)
  • 所有進入和結束片段的 enterTransition 和 exitTranstion 現在都會執行，而非只有最後一個進入片段和第一個結束片段。(b/149344150)
  • 已延後的片段不再卡在 CREATED 狀態，而是會然後與其他片段一起移至 STARTED。(b/129035555)
  • 修正在混合延後的重新預訂交易和非重新預訂交易時，FragmentManager 會不正確執行運算子的問題。(b/147297731)
  • 在延後片段時，同時填入多個片段不會再導致暫時顯示中繼片段 (b/37140383)
  • 在 onAttachFragment() 回呼中呼叫 findFragmentById() 或 findFragmentByTag() 時，FragmentManager 現可傳回正確片段 (b/153082833)
  • 用於替換的片段延後時，片段就不會再對遭刪除的片段呼叫 onCreateView() (b/143915710)
  • 嘗試合併架構 Transition 和 AndroidX Transition 執行個體時的錯誤訊息，現在會提及含有無效轉換的片段。(b/155574969)

行為變更

  • 您現在可以在片段的 onCreate() 生命週期方法中，對 ActivityResultLauncher 呼叫 launch()。(b/161464278)
  • 在 onCreate() 之後呼叫 registerForActivityResult() 現在可擲回例外狀況，表示不允許此設定，而非在設定變更後直接不傳回結果。(b/162255449)
  • FragmentActivity 現在會使用 Activity 1.2.0-alpha08 中導入的 OnContextAvailableListener API 還原 FragmentManager 的狀態。任何新增至 FragmentActivity 子類別的事件監聽器，都會在此事件監聽器之後執行。(I513da)

修正錯誤

  • 現在必須遵循使用 startIntentSenderForResult() 傳遞的 ActivityOptions (b/162247961)

已知問題

  • 使用新版狀態管理員時，如果您直接設定在 onViewCreated() 之後和 onResume() 之前的片段根層級檢視畫面瀏覽權限，負責控管根層級檢視畫面瀏覽權限的 FragmentManager 就會覆寫您設定的瀏覽權限。為解決這個問題，請一律使用 hide() 和 show() 運算變更片段的瀏覽權限。(b/164481490)

1.3.0-alpha07 版本

2020 年 7 月 22 日

發布 androidx.fragment:fragment:1.3.0-alpha07、androidx.fragment:fragment-ktx:1.3.0-alpha07 和 androidx.fragment:fragment-testing:1.3.0-alpha07。1.3.0-alpha07 版包含以下修訂項目。

新功能

  • FragmentScenario 現在支援將初始 Lifecycle 狀態設為 CREATED、STARTED 或 RESUMED，而不是一律將片段移至 RESUMED 狀態。(b/159662750)
  • 已新增 onFragment 的 FragmentScenario API 替代選項，此選項採用 Kotlin 修訂後擴充功能方法 withFragment，可讓您回傳值。值得一提的是，這個區塊會擷取指定區塊中產生的例外狀況。(b/158697631)

行為變更

  • FragmentScenario 現在使用 setMaxLifecycle() 來實作 moveToState()，以確保所有 API 級別的行為一致，並解除 Fragment 狀態與基礎 Activity 之間的關係。(b/156527405)
  • ViewTreeSavedStateRegistryOwner 傳回的 SavedStateRegistryOwner 已連結到片段檢視畫面的 Lifecycle。這樣可確保其狀態會與片段檢視畫面的狀態同時儲存和復原。(b/158503763)

修正錯誤

  • 片段現在會等待片段的檢視畫面先附加，然後再呼叫 ViewCompat.requestApplyInsets()，避免出現插入要求遺失的情況。(b/158095749)
  • 呼叫 clearFragmentResultListener 可正確清除生命週期觀察器。(b/159274993)

1.3.0-alpha06 版本

2020 年 6 月 10 日

發布 androidx.fragment:fragment:1.3.0-alpha06、androidx.fragment:fragment-ktx:1.3.0-alpha06 和 androidx.fragment:fragment-testing:1.3.0-alpha06。1.3.0-alpha06 版包含以下修訂項目。

新功能

  • FragmentActivity 和 Fragment 的 onAttachFragment() 回呼已淘汰。已新增 FragmentOnAttachListener 以提供更靈活的替代方案，您可將 onAttachFragment() 委派給其他獨立且可測試的事件監聽器，並支援除了直接子項 FragmentManager 之外，在 FragmentManagers 中加入事件監聽器。(I06d3d)

修正錯誤

  • 父項片段現在可以在子項片段之前還原其檢視畫面狀態，修正在 DialogFragment 設定將另一個 DialogFragment 顯示為子項片段後，變更顯示順序的問題。(b/157195715)
  • 修正以往 UseRequireInsteadOfGet Lint 檢查無法正確處理 ?. 和 !! 運算子的連續使用情況，這個問題現已修正。(b/157677616)

1.3.0-alpha05 版本

2020 年 5 月 20 日

發布 androidx.fragment:fragment:1.3.0-alpha05、androidx.fragment:fragment-ktx:1.3.0-alpha05 和 androidx.fragment:fragment-testing:1.3.0-alpha05。1.3.0-alpha05 版包含以下修訂項目。

新功能

API 變更

  • setFragmentResult() 和 setFragmentResultListener() API 現已分別採用非空值的 Bundle 和 FragmentResultListener。如要明確清除先前設定的結果或事件監聽器，請使用新的 clearFragmentResult() 和 clearFragmentResultListener() 方法。(b/155416778)
  • 用來接收 lambda 的 setFragmentResultListener() Kotlin 擴充功能現已標示為 inline。(b/155323404)

行為變更

  • 先前已針對 Fragment 淘汰的 startActivityForResult()、startIntentSenderForResult() 和 requestPermissions 現在於內部使用 ActivityResultRegistry，這樣一來，就移除了使用這些 API 時，只能在要求程式碼中使用較低位元 (0xFFFF 以下) 的限制。(b/155518741)

說明文件更新

  • 已擴充 Fragment(@LayoutRes int) 和 DialogFragment(@LayoutRes int) 建構函式的說明文件，以釐清使用預設 FragmentFactory 時，您應透過子類別的不含引數建構函式呼叫這些建構函式。(b/153042497)

1.3.0-alpha04 版本

2020 年 4 月 29 日

發布 androidx.fragment:fragment:1.3.0-alpha04、androidx.fragment:fragment-ktx:1.3.0-alpha04 和 androidx.fragment:fragment-testing:1.3.0-alpha04。1.3.0-alpha04 版包含以下修訂項目。

新功能

  • 現支援透過 FragmentManager 的新 API 在兩個片段之間傳送結果。這項功能適用於「導覽」中的階層片段 (父項/子項)、DialogFragment 和片段，且可確保結果至少傳送給 STARTED 時，Fragment 才會傳送到您的片段。(b/149787344)

API 變更

  • 已淘汰目標片段 API。如要在片段之間傳輸資料，請改用新的 Fragment Result API。(b/149787344)
  • Fragment 上的 startActivityForResult()/onActivityResult() 和 requestPermissions()/onRequestPermissionsResult() API 已淘汰。請使用 Activity Result API。(aosp/1290887)
  • 來自 Activity 1.2.0-alpha04 的破壞性變更：prepareCall() 方法已重新命名為 registerForActivityResult()。(aosp/1278717)

修正錯誤

  • 片段的 getViewLifecycleOwner() 現在會在呼叫 onSaveInstanceState() 之前停止，為片段生命週期的行為建立鏡射。(b/154645875)
  • 呼叫片段的 setMenuVisibility(false) 現在可以正確變更其子項片段提供的選單顯示設定。(b/153593580)
  • 修正透過 FragmentContainerView 將片段新增至 DialogFragment 的檢視階層時會發生 illegalStateException 的問題 (b/154366601)
  • 代管活動以外的片段時，對片段執行 getDefaultViewModelProviderFactory() 方法不會再導致當機問題 (b/153762914)

1.3.0-alpha03 版本

2020 年 4 月 1 日

發布 androidx.fragment:fragment:1.3.0-alpha03、androidx.fragment:fragment-ktx:1.3.0-alpha03 和 androidx.fragment:fragment-testing:1.3.0-alpha03。1.3.0-alpha03 版包含此連結所列的修訂項目。

API 變更

  • Fragment 的 prepareCall 方法現在是 final (b/152439361)

修正錯誤

  • 修正使用 BottomSheetDialogFragment 時，Fragment 1.3.0-alpha02 中導入迴歸的問題 (b/151652127、aosp/1263328、aosp/1265163)
  • 修正設定變更後，從片段使用 prepareCall 的問題。(b/152137004)
  • 修正使用 setTargetFragment() 時忽略共用元素和結束轉換的問題。(b/152023196)
  • 從 Fragment 1.2.4 中：更新片段 ProGuard 規則，以允許對保留的片段進行模糊處理。(b/151605338)
  • 從 Fragment 1.2.4 中：已停用 DialogFragment 類別的 FragmentLiveDataObserve Lint 規則，因為其生命週期和檢視畫面生命週期都會保持同步，因此呼叫 observe 時可以安全使用 this 或 viewLifecycleOwner。(b/151765086)

依附元件變更

  • 片段依附於 Activity 1.2.0-alpha03，這可大幅改善 Activity 1.2.0-alpha02 導入的 Activity Result API。

1.3.0-alpha02 版本

2020 年 3 月 18 日

發布 androidx.fragment:fragment:1.3.0-alpha02、androidx.fragment:fragment-ktx:1.3.0-alpha02 和 androidx.fragment:fragment-testing:1.3.0-alpha02。1.3.0-alpha02 版包含以下修訂項目。

新功能

  • 新增 Activity 1.2.0-alpha02 中導入的 ActivityResultRegistry API 支援，可處理 startActivityForResult()+onActivityResult() 以及 requestPermissions()+onRequestPermissionsResult() 流程，除了提供用於測試這些流程的掛鉤之外，不會覆寫 Fragment 中的方法。請參閱最新的從 Activity 取得結果。(b/125158199)

API 變更

  • DialogFragment 現在提供採用 @LayoutRes 的建構函式，可指出 onCreateView() 預設應加載的版面配置。(b/150327080)
  • onActivityCreated() 方法現已淘汰。修飾片段檢視畫面的程式碼應透過 onViewCreated() 執行 (在 onActivityCreated() 之前呼叫)，而其他初始化程式碼則應在 onCreate() 中執行。如要在活動的 onCreate() 完成時接收回呼，LifeCycleObserver 活動應於 onAttach() 中活動的 Lifecycle 註冊，並在收到 onCreate() 回呼時移除。(b/144309266)

修正錯誤

  • 在 Fragment 1.2.3 中：修正在 onCreateDialog() 內呼叫 getLayoutInflater() 時，在 DialogFragment 中導致 StackOverflowError 的錯誤。(b/117894767、aosp/1258664)
  • 在 Fragment 1.2.3 中：縮減 Fragment 內含 ProGuard 規則的範圍，以確保系統可移除未使用的 Fragment 類別。(b/149665169)
  • 在 Fragment 1.2.3 中：修正 UseRequireInsteadOfGet 使用遮蔽 Kotlin 屬性名稱的本機變數名稱時，系統會進行檢查的問題。(b/149891163)
  • 在 Fragment 1.2.3 中：FragmentContainerView 不會再因為在版面配置預覽中使用不正確的建構函式而擲回 UnsupportedOperationException。(b/149707833)

已知問題

  • BottomSheetDialogFragment 不再正確地固定螢幕上的對話方塊。(b/151652127)

1.3.0-alpha01 版本

2020 年 3 月 4 日

發布 androidx.fragment:fragment:1.3.0-alpha01、androidx.fragment:fragment-ktx:1.3.0-alpha01 和 androidx.fragment:fragment-testing:1.3.0-alpha01。1.3.0-alpha01 版包含以下修訂項目。

新功能

API 變更

  • Fragment 中的 setRetainInstance() 方法已淘汰。推出 ViewModels 後，開發人員可利用特定 API 保留狀態，並將其與 Activity、Fragment 和 Navigation 圖表建立關聯。因此，開發人員可以使用一般且未保留的片段，並分別保留所需的特定狀態，避免常見的外洩來源、同時保留單一建立與刪除保留狀態的實用屬性 (也就是 ViewModel 和 onCleared() 回呼)。(b/143911815)
  • 隨著 ViewPager2 1.0.0 的推出，用於與 ViewPager 互動的 FragmentPagerAdapter 和 FragmentStatePagerAdapter 類別已經淘汰。請參閱從 ViewPager 移轉至 ViewPager2。(b/145132715)

修正錯誤

  • Fragment ProGuard 規則現在只會保留預設建構函式的 Fragment 類別 (而不是所有 Fragment 執行個體)，這修正了 Fragment 1.2.1 中導入的迴歸問題。(b/149665169
  • Fragment 1.2.2 中新增的 require___() Lint 規則，在本機變數名稱與已覆蓋的 Kotlin 資源名稱相同時，不會再發生誤判情形 (例如 view)。(b/149891163)
  • 使用 Android Studio 中的版面配置預覽時，FragmentContainerView 不會再擲回 UnsupportedOperationException (b/149707833)
  • 修正狀態儲存後新增的保留片段不會持續重新建立，且會在每次設定變更後刪除。(b/145832397)

1.2.5 版本

1.2.5 版本

2020 年 6 月 10 日

發布 androidx.fragment:fragment:1.2.5、androidx.fragment:fragment-ktx:1.2.5 和 androidx.fragment:fragment-testing:1.2.5。1.2.5 版包含以下修訂項目。

修正錯誤

  • 片段的 getViewLifecycleOwner() 現在會在呼叫 onSaveInstanceState() 之前停止，為片段生命週期的行為建立鏡射。這項功能之前已於 Fragment 1.3.0-alpha04 中推出。(b/154645875)
  • 呼叫片段的 setMenuVisibility(false) 現在可以正確變更其子項片段提供的選單顯示設定。這項功能之前已於 Fragment 1.3.0-alpha04 中推出。(b/153593580)

1.2.4 版本

1.2.4 版本

2020 年 4 月 1 日

發布 androidx.fragment:fragment:1.2.4、androidx.fragment:fragment-ktx:1.2.4 和 androidx.fragment:fragment-testing:1.2.4。1.2.4 版包含以下修訂項目。

修正錯誤

  • 更新 Fragment ProGuard 規則，以允許對保留的片段進行模糊處理。(b/151605338)
  • 已停用 DialogFragment 類別中 FragmentLiveDataObserve Lint 規則，因為其生命週期和檢視畫面生命週期都會保持同步，因此呼叫 observe 時可以安全使用 this 或 viewLifecycleOwner。(b/151765086)

1.2.3 版本

1.2.3 版本

2020 年 3 月 18 日

發布 androidx.fragment:fragment:1.2.3、androidx.fragment:fragment-ktx:1.2.3 和 androidx.fragment:fragment-testing:1.2.3。1.2.3 版包含以下修訂項目。

修正錯誤

  • 修正 DialogFragment 中的錯誤，此錯誤在 onCreateDialog() 內呼叫 getLayoutInflater() 會導致 StackOverflowError。(b/117894767、aosp/1258665)
  • 縮減 Fragment 內含 ProGuard 規則的範圍，以確保系統可移除未使用的片段類別。(b/149665169)
  • 修正問題：使用遮蔽 Kotlin 屬性名稱的本機變數名稱時，UseRequireInsteadOfGet Lint 檢查會出現偽陽性 (b/149891163)
  • FragmentContainerView 無法再因為於版面配置預覽中使用不正確的建構函式擲回 UnsupportedOperationException。(b/149707833)

1.2.2 版本

1.2.2 版本

2020 年 2 月 19 日

發布 androidx.fragment:fragment:1.2.2、androidx.fragment:fragment-ktx:1.2.2 和 androidx.fragment:fragment-testing:1.2.2。1.2.2 版包含以下修訂項目。

新的 Lint 檢查

  • Lint 建議使用 viewLifecycleOwner 做為 LifecycleOwner，以呼叫 onCreateView()、onViewCreated() 和 onActivityCreated() 中的 OnBackPressedDispatcher。(b/142117657)
  • 新增 Lint 檢查，確認您在使用 fragment-testing 成果時使用的是正確的 debugImplementation。(b/141500106)
  • 片段現在會建議針對同時包含 get 和 require 同等項目的所有 Fragment API 使用相關聯的 require___() 方法，以取得更多描述性錯誤訊息，而不要使用 checkNotNull(get___())、requireNonNull(get___()) 或 get___()!!。(aosp/1202883)

修正錯誤

  • 修正 Fragment ProGuard 檔案以避免 R8 警告 (b/148963981)
  • 改善現有的 Lint 檢查，建議使用 observe 時使用 viewLifecycleOwner，這樣也可以處理 observe 的 livedata-ktx 擴充功能方法版本。(b/148996309)
  • 修正許多 Lint 檢查的格式 (aosp/1157012)

外部貢獻

  • 感謝 Zac Sweers 代表 Slack 提供 require___() 的 Lint 檢查！(aosp/1202883)

1.2.1 版本

1.2.1 版本

2020 年 2 月 5 日

發布 androidx.fragment:fragment:1.2.1、androidx.fragment:fragment-ktx:1.2.1 和 androidx.fragment:fragment-testing:1.2.1。1.2.1 版包含以下修訂項目。

修正錯誤

  • 透過 add 和 replace 方法新增的片段，採用 Class 執行個體 (或 Kotlin 修訂版) 現已預設由 ProGuard 保留。(b/148181315)
  • 執行 finishUpdate() 時，FragmentStatePagerAdapter 和 FragmentPagerAdapter 不再偵測到 FragmentManager 擲回的例外狀況。(aosp/1208711)
  • 修正 FragmentManager.findFragment() 無法與透過 <fragment> 標記新增的片段搭配運作的問題。(b/147784323)
  • 使用 <fragment> 標記加載的片段，現在會在版面配置中 onCreate() 之前一律接受 onInflate() 的呼叫。(aosp/1215856)
  • 當 Activity 已經刪除時，針對 FragmentManager 執行個體呼叫 toString() 不會再擲回 NullPointerException。(b/148189412)

依附元件變更

版本 1.2.0

版本 1.2.0

2020 年 1 月 22 日

發布 androidx.fragment:fragment:1.2.0、androidx.fragment:fragment-ktx:1.2.0 和 androidx.fragment:fragment-testing:1.2.0。1.2.0 版包含以下修訂項目。

自 1.1.0 版以來的重要異動

  • FragmentContainerView：FragmentContainerView 是強烈建議加入的片段，用於動態新增片段，取代 FrameLayout 或其他版面配置。這也支援與 <fragment> 標記相同的 class、android:name 和選用 android:tag，但使用一般 FragmentTransaction 新增這個初始片段，而非 <fragment> 使用的自訂程式碼路徑。
  • onDestroyView() 時間碼：片段現在會等待結束動畫、結束架構轉換，然後結束 AndroidX 轉換 (使用轉換 1.3.0 時) 結束，再呼叫 onDestroyView()。
  • 以類別為基礎的 add() 和 replace()：在 FragmentTransaction 中加入 add() 與 replace() 的超載，並採用 Class<? extends Fragment> 和選用的 Bundle 引數。這些方法會使用您的 FragmentFactory 建構要新增的 Fragment 執行個體。使用修正類型的 Kotlin 擴充功能 (例如 fragmentTransaction.replace<YourFragment>(R.id.container)) 也已新增至 fragment-ktx。
  • Lifecycle ViewModel SavedState 整合：現在 SavedStateViewModelFactory 在搭配 Fragment 使用 by viewModels()、by activityViewModels()、ViewModelProvider 建構函式或 ViewModelProviders.of() 時，使用的是原廠預設選項。
  • 新 Lint 檢查：新增 Lint 檢查，以確保您在透過 onCreateView()、onViewCreated() 或 onActivityCreated() 觀察 LiveData 時使用的是 getViewLifecycleOwner()。
  • getFragmentManager() 淘汰：Fragment 的 getFragmentManager() 和 requireFragmentManager() 方法已淘汰，並由單一 getParentFragmentManager() 方法取代，這個方法會傳回 Fragment 加入的非空值 FragmentManager (您可以使用 isAdded() 來判斷呼叫是否安全)。
  • 淘汰 FragmentManager.enableDebugLogging()：靜態 FragmentManager.enableDebugLogging 方法已淘汰。FragmentManager 現在會遵循用於 FragmentManager 標記的 Log.isLoggable()，因此您不必重新編譯應用程式，就能啟用 DEBUG 或 VERBOSE 記錄。

已知問題

  • 僅在 FragmentContainerView 透過 class 或 android:name 屬性參考的片段，不會由 ProGuard 自動保留，您必須手動為每個片段類別新增保留規則。(b/142601969)
  • 在含有 FragmentContainerView 的 XML 中使用 class 或 android:name 加入 NavHostFragment 時，您無法在 Activity 的 onCreate() 中使用 findNavController()。(b/142847973)

1.2.0-rc05 版本

2020 年 1 月 8 日

發布 androidx.fragment:fragment:1.2.0-rc05、androidx.fragment:fragment-ktx:1.2.0-rc05 和 androidx.fragment:fragment-testing:1.2.0-rc05。1.2.0-rc05 版包含以下修訂項目。

修正錯誤

  • 修正使用 <fragment> 標記時 Fragment 1.2.0-rc04 中會導致活動刪除時無法正確呼叫 onViewCreated() 的問題。(b/146290333)
  • 使用 <fragment> 標記新增的片段現在也能正常清除 NonConfig，即使只是有時出現在版面配置中 (也就是僅出現在橫向版面配置中) 也一樣。因此，即使這些片段不在版面配置中，也會正確地移至 CREATED，而不會建立執行個體卻不透過任何生命週期方法移動。(b/145769287)

1.2.0-rc04 版本

2019 年 12 月 18 日

發布 androidx.fragment:fragment:1.2.0-rc04、androidx.fragment:fragment-ktx:1.2.0-rc04 和 androidx.fragment:fragment-testing:1.2.0-rc04。1.2.0-rc04 版包含以下修訂項目。

修正錯誤

  • 已調整 TRANSIT_FRAGMENT_OPEN、TRANSIT_FRAGMENT_CLOSE 和 TRANSIT_FRAGMENT_FADE 的動畫，以免發生視覺問題。(b/145468417)

1.2.0-rc03 版本

2019 年 12 月 4 日

發布 androidx.fragment:fragment:1.2.0-rc03、androidx.fragment:fragment-ktx:1.2.0-rc03 和 androidx.fragment:fragment-testing:1.2.0-rc03。1.2.0-rc03 版包含以下修訂項目。

修正錯誤

  • 修正在結束動畫/轉換執行期間，findFragmentById()/findFragmentByTag() 仍會傳回已移除片段的意外行為變更。(b/143982969、aosp/1167585)
  • 如果包含的活動呼叫 onSaveInstanceState()，子項片段現在會正確地在其父項前停止。(b/144380645)
  • 修正以下問題：在彈出隱藏的「片段」之後，檢視畫面會錯誤地標記為 INVISIBLE (b/70793925)
  • 片段共用元素轉換現在會處理已旋轉、縮放等的檢視畫面 (b/142835261)

說明文件更新

  • 釐清有關 setUserVisibleHint() 的淘汰說明文件。(b/143897055)
  • 改善 setFragmentFactory() 和 getFragmentFactory() 的說明文件，以更有效地表示設定 FragmentFactory 也會影響子項 FragmentManagers。(aosp/1170095)

依附元件變更

  • 片段現在依附於 Lifecycle 2.2.0-rc03、Lifecycle ViewModel SavedState 1.0.0-rc03 以及 Activity 1.1.0-rc03。

1.2.0-rc02 版本

2019 年 11 月 7 日

發布 androidx.fragment:fragment:1.2.0-rc02、androidx.fragment:fragment-ktx:1.2.0-rc02 和 androidx.fragment:fragment-testing:1.2.0-rc02。1.2.0-rc02 版包含以下修訂項目。

修正錯誤

  • 在 Kotlin 中，從 onCreateView()、onViewCreated() 或 onActivityCreated() (於 Fragment 1.2.0-rc01 中導入) 觀察 LiveData 時使用 getViewLifecycleOwner() 的 LintFix，現在會使用 Kotlin 屬性存取語法 viewLifecycleOwner，而不是 getViewLifecycleOwner()。(aosp/1143821)

1.2.0-rc01 版本

2019 年 10 月 23 日

發布 androidx.fragment:fragment:1.2.0-rc01、androidx.fragment:fragment-ktx:1.2.0-rc01 和 androidx.fragment:fragment-testing:1.2.0-rc01。1.2.0-rc01 版包含以下修訂項目。

新功能

  • FragmentContainerView 現在除了支援 android:name 以外，還支援 class 屬性 (與 <fragment> 標記的功能相同)。(b/142722242)
  • 新增一項 Lint 檢查，確保您在透過 onCreateView()、onViewCreated() 或 onActivityCreated() 觀察 LiveData 時使用 getViewLifecycleOwner()。(b/137122478)

修正錯誤

  • DialogFragment 上的 onDismiss 和 onCancel 回呼現在能保證傳送至這些回呼的 DialogInterface 並非空值，且 getDialog() 會在執行時傳回非空值。(b/141974033)
  • FragmentContainerView 現已將 class 或 android:name 定義的片段新增為加載的部分元件，確保 findFragmentById() 和 findFragmentByTag() 會在之後立即運作 (b/142520327)
  • 修正 FragmentContainerView 中因狀態已儲存而產生的 IllegalStateException (b/142580713)
  • 修正 FragmentContainerView 類別經模糊處理時，FragmentContainerView 中產生的 UnsupportedOperationException (b/142657034)

已知問題

  • 僅在 FragmentContainerView 透過 class 或 android:name 屬性參考的片段，不會由 ProGuard 自動保留，您必須手動為每個片段類別新增保留規則。我們已停用建議移至 FragmentContainerView 的 Lint 規則，直到透過 aapt2 的問題修正為止。(b/142601969)

1.2.0-beta02 版本

2019 年 10 月 11 日

發布 androidx.fragment:fragment:1.2.0-beta02、androidx.fragment:fragment-ktx:1.2.0-beta02 和 androidx.fragment:fragment-testing:1.2.0-beta02。1.2.0-beta02 版包含以下修訂項目。

修正錯誤

  • 修正問題：Fragment 的 onInflate() 並未從 FragmentContainerView 收到正確屬性，例如 NavHostFragment。(b/142421837)

1.2.0-beta01 版本

2019 年 10 月 9 日

發布 androidx.fragment:fragment:1.2.0-beta01、androidx.fragment:fragment-ktx:1.2.0-beta01 和 androidx.fragment:fragment-testing:1.2.0-beta01。1.2.0-beta01 版包含以下修訂項目。

新功能

  • 透過加入 android:name 和選用的 android:tag XML 屬性的支援，FragmentContainerView 加入了新增初始片段的支援。與 <fragment> 標記不同的是，FragmentContainerView 會在背景中使用 FragmentTransaction 來新增初始片段，因此可以在 FragmentContainerView 中進一步執行 FragmentTransaction 版面配置作業。(b/139830628、b/141177981)
  • 片段現在包含 Lint 警告，可讓您快速將 FragmentContainerView 替換成 <fragment>。(b/139830056)

修正錯誤

  • 修正使用 androidx.transition 時的 ClassCastException。(b/140680619)
  • 使用 Transition 1.3.0-beta01 時，Fragment 現在會等待 androidx.transition 轉換作業 (以及架構轉換和動畫，這兩者已分別在 Fragment 1.2.0-alpha03 和 Fragment 1.2.0-alpha02 中完成修正) 結束，然後再分派 onDestroyView()。(aosp/1119841)
  • 使用 Transition 1.3.0-beta01 時，Fragment 現在會先取消 androidx.transition 轉換，然後再啟動相同容器的新轉換/動畫。(aosp/1119841)
  • 修正使用 FragmentContainerView 時，在片段的根層級使用 androidx.transition 轉換時的 API 17 和以下版本問題。(b/140361893)
  • fragment-testing 成果現已支援 AndroidX Test 1.2.0，修正了與最新版 Espresso 3.2.0 不相容的問題。(b/139100149)
  • 移除 FragmentManager 中的 Log.w 使用。(aosp/1126468)

已知問題

  • Fragment 的 onInflate() 並未收到 FragmentContainerView 的適當屬性，例如 NavHostFragment。(b/142421837)

1.2.0-alpha04 版本

2019 年 9 月 18 日

發布 androidx.fragment:fragment:1.2.0-alpha04、androidx.fragment-ktx:example:1.2.0-alpha04 和 androidx.fragment:fragment-testing:1.2.0-alpha04。1.2.0-alpha04 版包含以下修訂項目。

API 變更

  • Fragment 中的 getFragmentManager() 和 requireFragmentManager() 方法已淘汰，並由單一 getParentFragmentManager() 方法取代，這個方法會傳回 Fragment 加入的非空值 FragmentManager (您可以使用 isAdded() 來判斷呼叫是否安全)。(b/140574496)
  • 靜態 FragmentManager.enableDebugLogging 方法已淘汰。FragmentManager 現在會遵循 FragmentManager 標記的 Log.isLoggable()，因此您不必重新編譯應用程式，就能啟用 DEBUG 或 VERBOSE 記錄。(aosp/1116591)

修正錯誤

  • 片段現在會在其他片段執行的動畫結束時正確地刪除。(b/140574199)
  • 修正問題：片段會不正確地呼叫 Activity.findViewById()。(aosp/1116431)

1.2.0-alpha03 版本

2019 年 9 月 5 日

發布 androidx.fragment:fragment:1.2.0-alpha03、androidx.fragment:fragment-ktx:1.2.0-alpha03 和 androidx.fragment:fragment-testing:1.2.0-alpha03。您可以前往這裡查看這個版本包含的修訂項目。

API 變更

  • FragmentContainerView 現在是 final。(b/140133091)

修正錯誤

  • FragmentContainerView 現在會於返回堆疊放出片段時，會正確還原繪圖順序。(b/139104187)
  • 修正問題：同時填入片段及新增片段時，系統會執行錯誤的動畫。(b/111659726)
  • 片段現在會等待轉換 (除了在 Fragment 1.2.0-alpha02 中已修正的動畫之外) 完成，然後再分派 onDestroyView()。(b/138741697)

1.2.0-alpha02 版本

2019 年 8 月 7 日

發布 androidx.fragment:fragment:1.2.0-alpha02、androidx.fragment:fragment-ktx:1.2.0-alpha02 和 androidx.fragment:fragment-testing:11.2.0-alpha02。您可以前往這裡查看這個版本包含的修訂項目。

新功能

  • 使用 by viewModels()、by activityViewModels()、ViewModelProvider 建構函式，或搭配 Fragment 使用 ViewModelProviders.of() 時，SavedStateViewModelFactory 現在是預設的原廠設定。(b/135716331)
  • 在 FragmentTransaction 上搭配 setTransition 使用 TRANSIT_FRAGMENT_OPEN、TRANSIT_FRAGMENT_CLOSE、TRANSIT_FRAGMENT_FADE 時，預設動畫已更新為 Android 10 裝置活動所使用的動畫 (aosp/1012812、aosp/1014730)

API 變更

  • 引進 FragmentContainerView，做為強烈建議您加入動態片段的動態容器以取代 FrameLayout 的用法，以修正動畫 Z-order 問題和視窗分派至 Fragments 的動畫。(b/37036000、aosp/985243、b/136494650)
  • 新增靜態 FragmentManager.findFragment(View) 方法，可從由片段加載的檢視畫面擷取內含的 Fragment。fragment-ktx 中也提供 Kotlin 擴充功能。(aosp/1090757)
  • 在採用 Class<? extends Fragment> 和選擇性引數 Bundle 的 FragmentTransaction 上，新增 add() 和 replace() 的超載。這些方法會使用您的 FragmentFactory 建構要新增的 Fragment 執行個體。使用修正類型的 Kotlin 擴充功能 (例如 fragmentTransaction.replace<YourFragment>(R.id.container)) 也已新增至 fragment-ktx。(b/126124987)
  • @MainThread 註解已新增至 Fragment 生命週期回呼。(b/127272564)
  • FragmentTransaction 和 FragmentManager.BackStackEntry 的導覽標記標題相關 API 已淘汰。(b/138252944)
  • FragmentTransaction 的 setTransitionStyle 方法已淘汰。(aosp/1011537)
  • FragmentManager 中的許多方法已不再是 abstract。FragmentManager 本身仍是 abstract，因此不應直接執行個體化或延伸；您應只會繼續收到來自 getSupportFragmentManager()、getChildFragmentManager() 等的現有執行個體。

修正錯誤

  • 在 Fragment 1.1.0-rc04 中：Fragment 現在可以在片段彈出時，正確取消延後的轉換。(b/138251858)
  • 在 Fragment 1.1.0-rc03 中：修正多次呼叫有逾時的 postponeEnterTransition()。並不會取消先前逾時設定的問題。(b/137797118)
  • 在 Fragment 1.1.0-rc02 中：修正移除目前項目時，FragmentPagerAdapter 和 FragmentStatePagerAdapter 中發生的當機問題 (b/137209870)
  • 片段現在會等待動畫結束後再分派 onDestroyView() (b/136110528)
  • 從子項片段及其子系的片段動畫，目前在父項片段中製作動畫時已正確處理。(b/116675313)
  • 修正使用共用元素轉換作業，並結合彈出與新增作業時的 NullPointerException 問題 (b/120507394)
  • 新增在 Robolectric 測試中使用 FragmentPagerAdapter 和 FragmentStatePagerAdapter 時 IllegalStateException 的解決方法。(b/137201343)

1.2.0-alpha01 版本

2019 年 7 月 2 日

發布 androidx.fragment:fragment:1.2.0-alpha01、androidx.fragment:fragment-ktx:1.2.0-alpha01 和 androidx.fragment:fragment-testing:1.2.0-alpha01。您可以前往這裡查看這個版本包含的修訂項目。

新功能

  • FragmentManager 現在會在連結片段的檢視畫面，及直接在呼叫 onViewCreated() 前呼叫 requestApplyInsets()，藉此確保檢視畫面總是會有正確的插邊。(b/135945162)

修正錯誤

  • 修正在 replace() 之前使用 setPrimaryNavigationFragment() 彈出 FragmentTransaction 的 NullPointerException 問題 (b/134673465)

1.1.0 版本

1.1.0 版本

2019 年 9 月 5 日

發布 androidx.fragment:fragment:1.1.0、androidx.fragment:fragment-ktx:1.1.0 和 androidx.fragment:fragment-testing:1.1.0。您可以前往這裡查看這個版本包含的修訂項目。

自 1.0.0 版以來的重要異動

  • fragment-testing：fragment-testing 構件會提供 FragmentScenario 類別，以測試隔離中的片段。詳情請參閱測試應用程式的片段說明文件。
  • FragmentFactory：您現在可在 FragmentManager 上設定 FragmentFactory，藉此管理片段建立例項，並移除不需使用引數的建構函式。
  • ViewModels 的 Kotlin 屬性委派項目：fragment-ktx 構件現在包含兩個 Kotlin 屬性委派項目：by viewModels() 用於存取與個別片段相關聯的 ViewModel，以及 by activityViewModels() 用於存取限定為活動範圍的 ViewModels。
  • 生命週期上限：您現在可以對 FragmentTransaction 呼叫 setMaxLifecycle()，設定 Fragment 的 Lifecycle 狀態上限。這會取代現已淘汰的 setUserVisibleHint()。FragmentPagerAdapter 和 FragmentStatePagerAdapter 提供新的建構函式，可讓您切換至新行為。
  • FragmentActivity LayoutId 建構函式：FragmentActivity 的子類別現在可選擇呼叫 FragmentActivity 上採用 R.layout ID 的建構函式，指出應設為內容檢視畫面的版面配置，做為在 onCreate() 中呼叫 setContentView() 的替代選項。這個動作不會改變子類別採用無引數建構函式的要求。
  • Fragment LayoutId 建構函式：Fragment 的子類別現在可選擇呼叫 Fragment 上採用 R.layout ID 的建構函式，指出應用於此片段的版面配置，做為覆寫 onCreateView() 的替代選項。加載的版面配置可在 onViewCreated() 中設定。
  • 以逾時延後：新增需要逾時的 postponeEnterTransition() 超載。

1.1.0-rc04 版本

2019 年 8 月 7 日

發布 androidx.fragment:fragment:1.1.0-rc04、androidx.fragment:fragment-ktx:1.1.0-rc04 和 androidx.fragment:fragment-testing:1.1.0-rc04。您可以前往這裡查看這個版本包含的修訂項目。

修正錯誤

  • Fragment 現在可以在片段彈出時，正確取消延後的轉換。(b/138251858)

1.1.0-rc03 版本

2019 年 7 月 19 日

發布 androidx.fragment:fragment:1.1.0-rc03、androidx.fragment:fragment-ktx:1.1.0-rc03 和 androidx.fragment:fragment-testing:1.1.0-rc03。您可以前往這裡查看這個版本包含的修訂項目。

修正錯誤

  • 修正多次呼叫有逾時的 postponeEnterTransition() 時不會取消前一個逾時的問題。(b/137797118)

1.1.0-rc02 版本

2019 年 7 月 17 日

發布 androidx.fragment:fragment:1.1.0-rc02、androidx.fragment:fragment-ktx:1.1.0-rc02 和 androidx.fragment-testing:fragment:1.1.0-rc02。您可以前往這裡查看這個版本包含的修訂項目。

修正錯誤

  • 修正在移除目前項目時，FragmentPagerAdapter 和 FragmentStatePagerAdapter 中發生的當機問題 (b/137209870)

1.1.0-rc01 版本

2019 年 7 月 2 日

發布 androidx.fragment:fragment:1.1.0-rc01、androidx.fragment:fragment-ktx:1.1.0-rc01 和 androidx.fragment:fragment-testing:1.1.0-rc01。您可以前往這裡查看這個版本包含的修訂項目。

修正錯誤

  • 執行轉換時，片段現在會於使用 show() 或 hide() 運算時正確地更新其瀏覽權限。(b/133385058)
  • 修正在 replace() 之前使用 setPrimaryNavigationFragment() 彈出 FragmentTransaction 的 NullPointerException 問題 (b/134673465)

1.1.0-beta01 版本

2019 年 6 月 5 日

發布 androidx.fragment:fragment:1.1.0-beta01、androidx.fragment:fragment-ktx:1.1.0-beta01 和 androidx.fragment:fragment-testing:1.1.0-beta01。您可以前往這裡查看這個版本包含的修訂項目。

修正錯誤

  • 巢狀片段的 androidx.lifecycle.Lifecycle 回呼 (尤其是 STARTED、RESUMED、PAUSED、STOPPED 和 DESTROYED) 現已正確建立。(b/133497591)
  • 在 Fragment 的 onCreate() 中註冊的 OnBackPressedCallback 例項，現在可以比子項 FragmentManager 優先執行 (b/133175997)
  • 取代父項片段後，子項片段就不再以動畫呈現。(b/121017790)
  • 使用 animateLayoutChanges="true" 時，系統會忽略片段動畫和轉場效果，修正無法正確刪除片段的問題。(b/116257087)

1.1.0-alpha09 版本

2019 年 5 月 16 日

發布 androidx.fragment:fragment:1.1.0-alpha09、androidx.fragment:fragment-ktx:1.1.0-alpha09 和 androidx.fragment:fragment-testing:1.1.0-alpha09。您可以前往這裡查看這個版本包含的修訂項目。

API 變更

  • 當主要導覽片段發生變更時，現在片段會接收新的 onPrimaryNavigationFragmentChanged(boolean) 方法回呼。aosp/960857

修正錯誤

  • 現在移除父項片段後，由子項片段加載的選單項目也會正確移除。b/131581013

1.1.0-alpha08 版本

2019 年 5 月 7 日

發布 androidx.fragment:fragment:1.1.0-alpha08、androidx.fragment:fragment-ktx:1.1.0-alpha08 和 androidx.fragment:fragment-testing:1.1.0-alpha08。您可以前往這裡查看這個版本包含的修訂項目。

這個版本與 Preferences 1.1.0-alpha01 到 1.1.0-alpha04 不相容。使用此版本 Fragment 時，請升級至 1.1.0-alpha05 版本。

新功能

  • 新增會採用逾時的 postponeEnterTransition() 新超載，此後 Fragment 將自動呼叫 startPostponedEnterTransition() b/120803208

API 變更

  • 破壞性變更：先前淘汰的 FragmentFactory instantiate 方法採用 Bundle 已移除。aosp/953856
  • 破壞性變更：FragmentPagerAdapter 和 FragmentStatePagerAdapter 中的 RESUME_ONLY_CURRENT_FRAGMENT 和 USE_SET_USER_VISIBLE_HINT 常數已分別重新命名為 BEHAVIOR_RESUME_ONLY_CURRENT_FRAGMENT 和 BEHAVIOR_SET_USER_VISIBLE_HINT。aosp/954782

修正錯誤

  • 透過 setMaxLifecycle() 設定生命週期上限的片段，已無法在達到最終狀態前繼續。b/131557151
  • 使用 setMaxLifecycle(Lifecycle.State.CREATED) 時，片段會正確顯示檢視畫面。aosp/954180

1.1.0-alpha07 版本

2019 年 4 月 25 日

發布 androidx.fragment:fragment:1.1.0-alpha07、androidx.fragment:fragment-ktx:1.1.0-alpha07 和 androidx.fragment:fragment-testing:1.1.0-alpha07。您可以前往這裡查看這個版本包含的修訂項目。

新功能

  • 您現在可以對 FragmentTransaction 呼叫 setMaxLifecycle()，藉此設定 Fragment 的 Lifecycle 狀態上限。這會取代現已淘汰的 setUserVisibleHint()。FragmentPagerAdapter 和 FragmentStatePagerAdapter 提供新的建構函式，可讓您切換至新行為。(b/129780800)

API 變更

  • FragmentScenario 的 moveToState(STARTED) 目前只能在搭載 API 24 以上版本的裝置上呼叫 (b/129880016)

行為變更

  • 基於 (b/129907905) 的結果，當代管活動重新建立時，返回堆疊的片段不會傳回 onCreateView() 的回呼。只有當片段顯示時 (即返回堆疊彈出)，系統才會呼叫 onCreateView()。

修正錯誤

  • 修正在 XML 中使用 <fragment> 標記以及 FragmentActivity 或 AppCompatActivity 的 contentLayoutId 建構函式的問題。(b/129907905)
  • 修正問題：在設定變更後，返回堆疊片段不會移至至少 CREATED，導致 ViewModel 和子項保留片段無法正確處理 (b/129593351)
  • 修正問題：在例項狀態儲存後，因已保留片段不同步導致 restoreSaveState 當機 (b/130433793) (aosp/947824)
  • 修正問題：如果 FragmentManager 有返回堆疊，新增的 OnBackPressedCallback 片段將具有片段生命週期。詳情請參閱 androidx.activity 1.0.0-alpha07。(aosp/948209)
  • 片段將不再針對動畫強制執行 LAYER_TYPE_HARDWARE。如果您特別需要硬體圖層動畫，請將此設為動畫的一部分。(b/129486478)

1.1.0-alpha06 版本

2019 年 4 月 3 日

發布 androidx.fragment:fragment:1.1.0-alpha06、androidx.fragment:fragment-ktx:1.1.0-alpha06 和 androidx.fragment:fragment-testing:1.1.0-alpha06。您可以前往這裡查看這個版本包含的修訂項目。

新功能

  • FragmentManager 擲回的例外狀況現在會於訊息中加入片段的名稱。(b/67759402)

API 變更

  • Fragment 和 FragmentActivity 現在包含第二種建構函式；該函式可使用 @LayoutRes int 取代先前以 @ContentView 為類別加上註解的行為。這個方法適用於應用程式和程式庫模組。(b/128352521)
  • FragmentActivity 的 onActivityResult() 現已正確標示為 @CallSuper。(b/127971684)
  • 採用引數套件的 FragmentFactory instantiate 方法已淘汰，應用程式應使用不採用套件的新 instantiate 超載 (b/128836103)
  • FragmentScenario 方法現已使用 @StyleRes 正確加註。(aosp/924193)
  • 淘汰了 FragmentTabHost。(b/127971835)
  • 已移除 FragmentActivity 的 getThemedContext()。(aosp/934078)

修正錯誤

  • 修正 1.1.0-alpha05 中導致收到的項目片段在螢幕上閃爍的迴歸。(b/129405432)
  • 修正 popBackStack+replace+popBackStack 運算系列後，主要導覽片段會遺失的問題。(b/124332597)
  • 修正還原 Fragment 狀態時，在 Activity 中使用 @ContentView 建構函式的問題 (b/127313094)
  • 修正 setTargetFragment() 的邏輯，也就是以尚未附加至 FragmentManager 的片段取代現有的目標片段。(aosp/932156)

1.1.0-alpha05 版本

2019 年 3 月 13 日

發布 androidx.fragment:fragment:1.1.0-alpha05、androidx.fragment:fragment-ktx:1.1.0-alpha05 和 androidx.fragment:fragment-testing:1.1.0-alpha05。您可以前往這裡查看這個版本包含的修訂項目完整清單。

新功能

  • 已對 @ContentView 註解查詢加入快取處理。(b/123709449)

行為變更

  • 使用連結到不同 FragmentManager 的 Fragment 呼叫 remove()、hide()、show()、detach() 和 setPrimaryNavigationFragment() 時，現在會傳送 IllegalStateException，而非直接失敗 (aosp) /904301)

修正錯誤

  • FragmentActivity 的 onNewIntent 現已正確加上 @CallSuper 標記 (b/124120586)
  • 修正使用 getDialog().dismiss() 或 getDialog().cancel() 時可能會呼叫 DialogFragment onDismiss() 的問題 (b/126563750)

1.1.0-alpha04 版本

2019 年 2 月 7 日

發布 androidx.fragment:fragment 1.1.0-alpha04、androidx.fragment:fragment-ktx 1.1.0-alpha04 和 androidx.fragment:fragment-testing 1.1.0-alpha04。

新功能

  • 現已支援 @ContentView 類別註解，可讓您指示應擴展哪個版面配置 XML 檔案以加載替代覆寫 onCreateView()。建議您在 onViewCreated() 中執行檢視畫面相關操作。(aosp/837619)
  • fragment-testing 現在依附於 androidx.test:core-ktx 1.1.0 穩定版 (b/121209673)
  • 您現在可以透過 openActionBarOverflowOrOptionsMenu 使用 FragmentScenario，測試片段代管選項選單 (b/121126668)

API 變更

  • 新增可傳回 @NonNull Bundle 或擲回 IllegalStateException 的 requireArguments() 方法 (b/121196360)
  • 新增附註，說明 getLifecycle()、getViewLifecycleOwner() 和 getViewLifecycleOwnerLiveData() 不應遭到覆寫，並將在日後版本中進行最終確定。如果您目前正在覆寫這個方法，請提交功能要求。(aosp/880714)
  • 新增附註，說明 getViewModelStore() 不應遭到覆寫，並將在日後版本中進行最終確定。如果您目前正在覆寫這個方法，請提交功能要求。(aosp/880713)
  • 修正舊版 Fragments 的二進位檔相容性問題。(aosp/887877) (aosp/889834)

修正錯誤

  • 傳遞 null 至 setTargetFragment() 時，系統會正確地清除目標片段。(aosp/849969)
  • 修正 onDestroy() 中或之後有時無法顯示目標片段的問題。(b/122312935)
  • DialogFragment 的 ondismiss() 現會在 onDestroy() 之前呼叫。(aosp/874133) (aosp/890734)

1.1.0-alpha03 版本

2018 年 12 月 17 日

新功能

  • 片段現已導入 BundleSavedStateRegistryOwner，取決於新推出的 SavedState 程式庫 [aosp/824380]
  • 新增 by activityViewModels Kotlin 屬性委派項目，以擷取與內含活動相關的 ViewModels [b/119050253]
  • by viewModels Kotlin 屬性委派項目已擴大採用選擇性的 Lambda 方式來取得 ViewModelStoreOwner，可讓您將 val viewModel: MyViewModel by viewModels(::requireParentFragment) 等程式碼傳入父項 Fragment 或其他自訂 ViewModelStoreOwner 中 [b/119050253]

API 變更

  • FragmentScenario 現在可讓您指定主題，例如 Theme.AppCompat [b/119054431]。這是一項破壞性變更。
  • 新增可傳回 @NonNull View 或擲回 IllegalStateException 的 requireView() 方法 [b/120241368]
  • 新增可傳回 @NonNull Fragment 或擲回 IllegalStateException 的 requireParentFragment() 方法 [b/112103783]

修正錯誤

  • 修正 InvalidStateException：失敗儲存狀態 (b/120814739)
  • 從儲存的例項狀態還原的片段，現在一律會接收非空值 Bundle [b/119794496]
  • 重新加入已移除的片段時，不會再重複使用片段的 Lifecycle 物件 [b/118880674]

1.1.0-alpha02 版本

2018 年 12 月 3 日

新功能

  • FragmentScenario 的 Kotlin 擴充功能現在可讓您將 lambda 用於 Fragment 建構，做為傳遞 FragmentFactory 執行個體的替代選項。(aosp/812913)

修正錯誤

  • 修正在返回堆疊中使用巢狀 Fragment 所產生的 IllegalStateException 錯誤 (b/119256498)
  • 修正搭配 FragmentFactory 使用 FragmentScenario.recreate() 會當機的問題 (aosp/820540)
  • 修正移除 Fragment 後即無法存取目標 Fragment 的問題 (aosp/807634)

1.1.0-alpha01 版本

2018 年 11 月 5 日

這是 fragment-testing 構件和 FragmentScenario 的第一個版本，以 androidx.test:core API 為基礎建構而成。詳情請參閱片段測試說明文件。

新功能

  • 用於測試個別片段的全新 FragmentCase 類別。
  • 您現在可以在任何 FragmentManager 上設定 FragmentFactory，以控制新的片段執行個體執行個體化的方式。
  • 新增 by viewModels() Kotlin 屬性委派，以從片段擷取 ViewModels。
  • Fragment onStop() 中的待處理輸入事件 (例如點擊) 現已取消。

API 變更

  • 大幅展開 Fragment API 途徑的空值註解。

修正錯誤

  • 修正導致 LiveData 中 Fragment 運算失敗的問題 (b/77944637)

已知問題

  • 從 FragmentManager 移除某個片段後，就無法存取目標片段。
  • fragment-testing 取決於 androidx.test:core:1.0.0-beta01，而不是正確的 androidx.test:core:1.0.0。