轉場

為開始和結束版面配置的 UI 動作製作動畫。

最近更新時間	穩定版	候選版	Beta 版	Alpha 版
2021 年 4 月 21 日	1.4.1	-	-	-

宣告依附元件

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

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

Groovy

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

Kotlin

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

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

意見回饋

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

建立新問題

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

1.4.1 版本

2021 年 4 月 21 日

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

修正錯誤

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

1.4.0 版本

2021 年 1 月 27 日

androidx.transition:transition:1.4.0 和 androidx.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-rc01 和 androidx.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-beta01 和 androidx.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-alpha01 和 androidx.transition:transition-ktx:1.4.0-alpha01 發布。1.4.0-alpha01 版本包含這些修訂版本。

新功能

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

1.3.1 版本

2020 年 2 月 19 日

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

修正錯誤

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

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 版本

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 版本

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)。
修正其他多項小錯誤。