Transition

使用开始和结束布局为界面中的动作添加动画效果。

最近更新时间	稳定版	候选版本	Beta 版	Alpha 版
2021 年 4 月 21 日	1.4.1	-	-	-

声明依赖项

如需添加 Transition 的依赖项，您必须将 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")
}

如需详细了解依赖项，请参阅添加 build 依赖项。

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对此库的改进有自己的见解，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

版本 1.4.1

2021 年 4 月 21 日

发布了 androidx.transition:transition:1.4.1 和 androidx.transition:transition-ktx:1.4.1。版本 1.4.1 中包含这些提交内容。

bug 修复

修复了以下问题：在一个容器中启动 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 中包含这些提交内容。

bug 修复

修复了当使用 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 的集成，以确保 Fragment 的视图在转换完成之前不会被销毁，并且会在适当的时间取消转换

版本 1.3.0-rc02

2019 年 12 月 4 日

发布了 androidx.transition:transition:1.3.0-rc02。版本 1.3.0-rc02 中包含这些提交内容。

bug 修复

修复了在弹出隐藏的 Fragment 之后会将视图错误地标记为 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 的集成，以确保 Fragment 的视图在转换完成之前不会被销毁，并且在适当的时间取消转换。(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。点击此处可查看此版本中包含的提交内容。

新功能

如果您指定 API 级别 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。点击此处可查看此版本中包含的提交内容。

bug 修复

修复了 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。点击此处可查看此版本中包含的提交内容。

bug 修复

修复了 API 级别 17 及更低版本中出现的 Visibility 中的 ViewGroupOverlay 缓存错误 (aosp/937350)

版本 1.1.0-alpha02

2019 年 3 月 13 日

发布了 androidx.transition:transition:1.1.0-alpha02。点击此处可查看此版本中包含的完整提交内容列表。

API 变更

方法参数的 Scene.getCurrentScene() 类型已从 View 更改为 ViewGroup。

bug 修复

通过 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) 方法已公开。您可以使用此方法根据当前场景编写自定义条件逻辑。

bug 修复

修复了使用 TransitionManager 收起/展开 RecyclerView 中的项时出现的崩溃问题 (b/37129527)。
修复了应用 Visibility 转换时动画不正确的问题 (b/62629600)。
允许替换 TransitionSet 子级的时长和插值类型等值 (b/64644617)。
修复了其他一些小错误。