转场

使用开始和结束布局为界面中的动作添加动画效果。
最近更新时间 稳定版 候选版 Beta 版 Alpha 版
2024 年 4 月 3 日 1.4.1 1.5.0-rc01 - -

声明依赖项

如需添加 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.5

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

2024 年 3 月 20 日

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

bug 修复

  • 修复了 Fragment 中的一个问题:使用预测性返回手势中断传入转换会破坏进入的视图,从而可能留下空白屏幕。(Id3f22b/319531491

版本 1.5.0-alpha06

2024 年 1 月 10 日

发布了 androidx.transition:transition:1.5.0-alpha06androidx.transition:transition-ktx:1.5.0-alpha06版本 1.5.0-alpha06 中包含这些提交内容

bug 修复

  • 使用 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-alpha05版本 1.5.0-alpha05 中包含这些提交内容

bug 修复

  • 修复了因设置共享元素过渡和未能也设置 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-alpha03版本 1.5.0-alpha03 中包含这些提交内容

新功能

  • Fragment 1.7.0-alpha05 搭配使用时,Transition 现在支持 Android 14 设备上的应用内预测性返回动画。

bug 修复

  • 修复了幻灯片切换中断 bug。当幻灯片切换中断进入过渡以移除视图时,视图会跳到错误的位置。(I946f8b/297427333

版本 1.5.0-alpha02

2023 年 9 月 6 日

发布了 androidx.transition:transition:1.5.0-alpha02androidx.transition:transition-ktx:1.5.0-alpha02版本 1.5.0-alpha02 中包含这些提交内容

新功能

  • TransitionSeekController 现在允许您通过 setCurrentFragment() 将进度设置为总时长的一定比例。(aosp/2647607)
  • TransitionSeekController 现在允许在使用 animateToStart()animateToEnd() 时通过调用 addOnProgressChangedListener 观察进度。(aosp/2647607)
  • 添加了 TransitionManager.seekTo(),以允许使用场景进行过渡。(aosp/2647607)
  • 为搜寻转场效果添加了基于物理特性的动画。它使用一维速度跟踪器来跟踪 setCurrentFraction()setCurrentPlayTimeMillis() 的进度变化,并将其用于初始速度 animateToStartanimateToEnd。(aosp/2647607)

bug 修复

依赖项更新

  • Transition 现在使用 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 及更高版本上的转场支持跳转。TransitionManager 中添加了 controlDelayedTransition() 这一新 API,它会返回一个允许跳转至 Transition 的 TransisionSeekController

API 变更

  • TransitionManager 包含一个新的 controlDelayedTransition() 方法,该方法可让应用在 API 34 及更高级别上控制过渡动画的进度。返回的 TransitionSeekController 可让开发者了解过渡效果何时可以进行跳转,以及动画的时长,并允许设置动画的当前时间。controlDelayedTransition() 仅支持替换 isSeekable() 以返回 true 的转换。
  • Transition 新增了 getRootTransition() 方法,该方法会返回包含当前 Transition 或当前 Transition(如果不包含在任何其他 Transition 中)的 Transition。如果开发者需要针对整个过渡的开始或结束时间设置监听器,此方法将非常有用。
  • TransitionListeners 现在具有新的 onTransitionStart()onTransitionEnd() 监听器,可让开发者了解转换是开始还是结束反向。这对于开发具有 TransitionListeners 的可查找转场而言非常重要。

bug 修复

  • 现在,转换会在克隆时复制其 TransitionListeners。这意味着,在 createAnimator() 期间添加新的监听器不会影响根 Transition。

版本 1.4.1

版本 1.4.1

2021 年 4 月 21 日

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

bug 修复

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

bug 修复

  • 修复了当使用 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 的集成,以确保 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

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

版本 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/807055Scene.getCurrentScene(View) 方法已公开。您可以使用此方法根据当前场景编写自定义条件逻辑。

bug 修复

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