轉場

為開始和結束版面配置的 UI 動作製作動畫。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2024 年 7 月 24 日 1.5.1 - - -

宣告依附元件

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

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

Groovy

dependencies {
    // Java language implementation
    implementation "androidx.transition:transition:1.5.1"
    // Kotlin
    implementation "androidx.transition:transition-ktx:1.5.1"
}

Kotlin

dependencies {
    // Java language implementation
    implementation("androidx.transition:transition:1.5.1")
    // Kotlin
    implementation("androidx.transition:transition-ktx:1.5.1")
}

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

意見回饋

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

建立新問題

詳情請參閱 Issue Tracker 說明文件

1.5 版本

1.5.1 版本

2024 年 7 月 24 日

發布 androidx.transition:transition:1.5.1androidx.transition:transition-ktx:1.5.1。1.5.1 版包含這些修訂版本

修正錯誤

  • 修正問題:如未啟動轉場效果,系統會忽略可搜尋轉場的 animateToStart()animateToEnd() 呼叫(I44d96b/338624457)

1.5.0 版本

2024 年 5 月 1 日

發布 androidx.transition:transition:1.5.0androidx.transition:transition-ktx:1.5.0。1.5.0 版包含這些修訂版本

自 1.4.0 版以來的重要異動

  • 轉場支援跳轉至 API 34 以上版本。已將新的 API 新增至 TransitionManagercontrolDelayedTransition(),此 API 會傳回允許尋找 TransitionTransitionSeekControllerFragment 1.7.0 會使用這項功能,在使用預測返回手勢時自動跳轉轉場效果。
  • 轉場效果有一種新方法 getRootTransition(),可在沒有其他「Transition」的範圍內傳回含有目前「Transition」的 Transition。如果開發人員需要在整個「轉場」開始或結束時擁有事件監聽器,這項功能就能派上用場。
  • TransitionListeners 現在提供新的 onTransitionStart()onTransitionEnd() 事件監聽器,可讓開發人員知道轉換開始還是結束,這對於開發具有 TransitionListeners 的可搜尋轉場效果至關重要。

1.5.0-rc02 版

2024 年 4 月 17 日

發布 androidx.transition:transition:1.5.0-rc02androidx.transition:transition-ktx:1.5.0-rc02。1.5.0-rc02 版包含這些修訂版本

依附元件更新

  • 將 Fragment 依附元件更新為 1.7.0-rc02 版,修正了在交易中加入無法瀏覽的共用元素時,如果交易加入所有其他轉換皆可搜尋,會導致系統當機的錯誤。

1.5.0-rc01 版

2024 年 4 月 3 日

發布 androidx.transition:transition:1.5.0-rc01androidx.transition:transition-ktx:1.5.0-rc01。1.5.0-rc01 版包含這些修訂版本

1.5.0-beta01 版

March 20, 2024

發布 androidx.transition:transition:1.5.0-beta01androidx.transition:transition-ktx:1.5.0-beta01。1.5.0-beta01 版包含這些修訂版本

修正錯誤

  • 修正 Fragment 中以預測返回手勢中斷傳入轉換時,會導致進入檢視畫面,進而可能讓空白畫面消失的一個問題。(Id3f22b/319531491)

1.5.0-alpha06 版

2024 年 1 月 10 日

發布 androidx.transition:transition:1.5.0-alpha06androidx.transition:transition-ktx:1.5.0-alpha061.5.0-alpha06 版包含以下修訂項目。

修正錯誤

  • 使用 TransitionSeekController.animateToStart() 時,新增的 TransitionListeners 現在會在 animateToStart() 的指定 Runnable 之後呼叫 onTransitionEnd()。(Ic6a55b/307624554)

依附元件更新

  • Fragment 依附元件已更新為 1.7.0-alpha08

1.5.0-alpha05 版

2023 年 11 月 29 日

發布 androidx.transition:transition:1.5.0-alpha05androidx.transition:transition-ktx:1.5.0-alpha051.5.0-alpha05 版包含以下修訂項目。

修正錯誤

  • 修正因設定共用元素轉換而無法設定 enter/exitTransition 而導致的 NullPointerException。(I8472b)。
  • 修正問題:搭配 Slide()animateToStart() 無法將檢視畫面移回起始位置 (I698f4b/300157785)
  • 修正了 Transition 中造成取消的重複性問題。(Iddcceb/308379201)

1.5.0-alpha04 版

2023 年 10 月 4 日

發布了 androidx.transition:transition:1.5.0-alpha04 和「androidx.transition:transition-ktx:1.5.0-alpha04」。1.5.0-alpha04 版包含以下修訂項目。

API 變更

  • 破壞性變更 - animateToStart() 方法現在會使用 Runnable,將轉換檢視畫面傳回原始狀態。

1.5.0-alpha03 版

2023 年 9 月 20 日

發布 androidx.transition:transition:1.5.0-alpha03androidx.transition:transition-ktx:1.5.0-alpha031.5.0-alpha03 版包含以下修訂項目。

新功能

  • Fragment 1.7.0-alpha05 搭配使用時,轉換現在支援 Android 14 裝置的應用程式內預測返回動畫。

修正錯誤

  • 修正投影片轉換中斷錯誤。當「投影片轉場」中斷進入轉換以移除檢視畫面時,會跳到錯誤的位置。(I946f8b/297427333)

1.5.0-alpha02 版

2023 年 9 月 6 日

發布 androidx.transition:transition:1.5.0-alpha02androidx.transition:transition-ktx:1.5.0-alpha021.5.0-alpha02 版包含以下修訂項目。

新功能

  • TransitionSeekController 現在可讓您透過 setCurrentFragment() 將進度設為總時間長度的一小部分。(aosp/2647607)。
  • TransitionSeekController 現在允許透過呼叫 addOnProgressChangedListener 觀察使用 animateToStart()animateToEnd() 時的狀態。(aosp/2647607)。
  • 新增了 TransitionManager.seekTo(),允許使用場景尋找轉場效果。(aosp/2647607)。
  • 新增物理動畫,方便跳轉轉場。這個 API 使用 1-D 速率追蹤程式,透過 setCurrentFraction()setCurrentPlayTimeMillis() 追蹤進度變化,並用於 animateToStartanimateToEnd 的初始速度。(aosp/2647607)。

修正錯誤

依附元件更新

  • 轉場效果現在可以使用 API 34 編譯。

1.5.0-alpha01 版本

2023 年 5 月 10 日

發布 androidx.transition:transition:1.5.0-alpha01androidx.transition:transition-ktx:1.5.0-alpha01。這個版本是在內部分支版本中開發。

新功能

  • 轉場支援跳轉至 API 34 以上版本。已將新的 API 新增至 TransitionManagercontrolDelayedTransition(),此方法會傳回 TransisionSeekController,以便尋找 Transition。

API 變更

  • TransitionManager 採用新方法 controlDelayedTransition(),可讓應用程式控制 API 34 以上級別的轉換動畫進度。傳回的 TransitionSeekController 可讓開發人員知道轉場效果何時可跳轉、動畫持續時間,並可設定動畫的目前時間。controlDelayedTransition() 僅支援覆寫 isSeekable() 以傳回 true 的轉場效果。
  • 轉場效果有一種新方法 getRootTransition(),可在沒有其他「Transition」的範圍內傳回含有目前「Transition」的 Transition。如果開發人員需要在整個「轉場」開始或結束時擁有事件監聽器,這項功能就能派上用場。
  • TransitionListeners 現在提供新的 onTransitionStart()onTransitionEnd() 事件監聽器,可讓開發人員知道轉換開始還是結束,這對於開發具有 TransitionListeners 的可搜尋轉場效果至關重要。

修正錯誤

  • 轉場效果現在會在複製時複製其 TransitionListeners。這表示在 createAnimator() 期間新增事件監聽器不會影響根層級轉換。

1.4.1 版本

1.4.1 版本

2021 年 4 月 21 日

androidx.transition:transition:1.4.1androidx.transition:transition-ktx:1.4.1 發布。1.4.1 版包含以下修訂項目。

修正錯誤

  • 修正以下問題:在一個容器中啟動 Transition 時會意外暫停其他在獨立容器中運作的轉場,造成這些轉場永遠無法完成 (aosp/1664439b/182845041)

1.4.0 版本

1.4.0 版本

2021 年 1 月 27 日

androidx.transition:transition:1.4.0androidx.transition:transition-ktx:1.4.0 發布。1.4.0 版本包含這些修訂版本。

自 1.3.0 版以來的重大異動

  • transition-ktx 構件推出 Kotlin 擴充功能,可為 AndroidX Transition 執行個體新增事件監聽器 (b/138870873)。

1.4.0-rc01 版本

2020 年 12 月 2 日

androidx.transition:transition:1.4.0-rc01androidx.transition:transition-ktx:1.4.0-rc01 發布,沒有變更 1.4.0-beta01 的內容。1.4.0-rc01 版本包含這些修訂版本。

1.4.0-beta01 版本

2020 年 7 月 22 日

androidx.transition:transition:1.4.0-beta01androidx.transition:transition-ktx:1.4.0-beta01 發布,且自 1.4.0-alpha01 版以來皆無異動。1.4.0-beta01 版本包含這些修訂版本。

1.4.0-alpha01 版本

2020 年 6 月 24 日

androidx.transition:transition:1.4.0-alpha01androidx.transition:transition-ktx:1.4.0-alpha01 發布。1.4.0-alpha01 版本包含這些修訂版本。

新功能

  • transition-ktx 構件推出 Kotlin 擴充功能,可為 AndroidX Transition 執行個體新增事件監聽器 (b/138870873)。

1.3.1 版本

1.3.1 版本

2020 年 2 月 19 日

androidx.transition:transition:1.3.1 發布。查看 1.3.1 版的修訂項

修正錯誤

  • 修正以下錯誤:使用 ChangeTransform 時,部分動畫檢視畫面會發生不正確的裁剪 (b/148798452)

1.3.0 版本

1.3.0 版本

2020 年 1 月 22 日

androidx.transition:transition:1.3.0 發布。1.3.0 版本包含這些修訂版本

自 1.2.0 版以來的重要異動

  • 針對 Fragment 1.2.0 的改善項目:改善整合 Fragment 1.2.0 的狀況,確保「片段」的檢視畫面在轉場完成前不會刪除,而轉場在適當時間點會取消

1.3.0-rc02 版本

2019 年 12 月 4 日

androidx.transition:transition:1.3.0-rc02 發布。1.3.0-rc02 版本包含這些修訂版本

修正錯誤

  • 修正以下問題:在彈出隱藏的「片段」之後,檢視畫面會錯誤地標記為 INVISIBLE (b/70793925)。

1.3.0-rc01 版本

2019 年 10 月 23 日

androidx.transition:transition:1.3.0-rc01 發布,且自 1.3.0-beta01 版以來皆無異動。1.3.0-rc01 版本包含這些修訂版本

1.3.0-beta01 版本

2019 年 10 月 9 日

androidx.transition:transition:1.3.0-beta01 發布。1.3.0-beta01 版本包含這些修訂版本

新功能

  • 改善與 Fragment 1.2.0-beta01 的整合狀況,確保「片段」的檢視畫面在轉場完成前不會刪除,而轉場在適當時間點會取消 (aosp/1119841)。

1.2.0 版本

1.2.0 版本

2019 年 10 月 9 日

androidx.transition:transition:1.2.0 發布,且自 1.2.0-rc01 版以來皆無異動。1.2.0 版本包含這些修訂版本

1.1.0 版本以來的重要異動

如果您指定的 API 級別為 29,請使用這個版本。否則某些轉場作業將無法正常運作。這個版本不再使用反射呼叫,而是改用 API 級別 29 中添加的新公用方法。這是我們針對非 SDK 介面施加的限制的一部分。

1.2.0-rc01 版本

2019 年 9 月 5 日

androidx.transition:transition:1.2.0-rc01 發布,且自 1.2.0-beta01 版以來皆無異動。您可以前往這裡查看這個版本包含的修訂版本。

1.2.0-beta01 版本

2019 年 7 月 2 日

發布 androidx.transition:transition:1.2.0-beta01。您可以前往這裡查看這個版本包含的修訂版本。

新功能

  • 如果您指定 29 為 targetSdkVersion,就必須使用這個版本。否則某些轉場作業將無法正常運作。這個版本不再使用反射呼叫,而是改用 API 級別 29 中添加的新公用方法。這是我們針對非 SDK 介面施加的限制的一部分。

1.2.0-alpha01 版本

2019 年 5 月 7 日

androidx.transition:transition:1.2.0-alpha01 發布。

新功能

  • 如果您指定 Q 為 targetSdkVersion,就必須使用這個版本。否則某些轉場作業將無法正常運作。這個版本不再使用反射呼叫,而是改用 Q 中添加的新公用方法。這是我們針對非 SDK 介面施加的限制的一部分。

1.1.0 版本

1.1.0 版本

2019 年 7 月 2 日

發布了 androidx.transition:transition:1.1.0,且自 1.1.0-rc02 版以來皆無異動。您可以前往這裡查看這個版本包含的修訂版本。

1.1.0-rc02 版本

2019 年 6 月 5 日

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

修正錯誤

  • 修正 TransitionManager.endTransitions() 以正確處理依附轉場 (aosp/946400)。

1.1.0-rc01 版本

2019 年 5 月 7 日

發布了 androidx.transition:transition:1.1.0-rc01。您可以前往這裡查看這個版本包含的修訂版本。

1.1.0-beta01 版本

2019 年 4 月 3 日

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

修正錯誤

  • 修正 Visibility 中的 ViewGroupOverlay 快取錯誤,這發生於 API 級別 17 以下 (aosp/937350)

1.1.0-alpha02 版本

2019 年 3 月 13 日

發布了 androidx.transition:transition:1.1.0-alpha02。您可以前往這裡查看這個版本包含的修訂項目完整清單。

API 相關異動

  • 方法參數的 Scene.getCurrentScene() 類型已從 View 變更為 ViewGroup

修正錯誤

  • 如果透過 setStartDelay() 提供額外延遲,SidePropagation 就無法運作 (b/119839526)。
  • 如果在 API 21 之前遭到中斷,ChangeImageTransform 會套用錯誤的矩陣 (b/123226255)。
  • 在 API 21 之前某些情況下 ChangeTransform 會運作不正常 (b/125777978)。

1.1.0-alpha01 版本

2018 年 12 月 3 日

API 相關異動

  • aosp/807055:公開 Scene.getCurrentScene(View) 方法。允許您根據目前的情境撰寫自訂條件邏輯。

修正錯誤

  • 修正使用 TransitionManager 收合/展開 RecyclerView 中的項目時會當機的問題 (b/37129527)。
  • 修正套用兩種顯示轉場時造成動畫錯誤的問題 (b/62629600)。
  • 允許針對 TransitionSet 的子項覆寫時間長度和內插器等資料值 (b/64644617)。
  • 修正其他多項小錯誤。