Android 实现RecyclerView跳转详情Activity共享过渡动画无效果

核心问题点梳理 #

从现有代码来看，过渡完全不生效主要来自四个硬配置错误，按影响优先级从高到低排列：

• 共享元素名称不匹配（最核心原因）
  列表项、启动动画时传入的匹配名、详情页视图的transitionName三者必须完全一致才能被系统识别为共享元素：
  • 列表item_layout.xml中ImageView的transitionName值为"imageTransition"
  • activity_video_detail.xml中ImageView的transitionName值为"imageTransition"
  • 但ActivityOptionsCompat.makeSceneTransitionAnimation方法传入的第三个匹配名写的是"transition"，和xml配置完全对不上，系统无法找到对应元素执行动画。
• 异步加载图片导致动画启动时无内容
  详情页的ImageView是通过Intent传递的URL加载网络图片，属于异步加载过程。如果不做延迟处理，过渡动画会在图片还未加载完成时直接触发，此时详情页的ImageView是空白状态，视觉上完全看不到从列表小图到大图的放大过程，表现为“没有任何过渡效果”。
• 主题缺少共享元素动画的默认配置
  现有主题仅开启了android:windowContentTransitions，没有显式指定共享元素的入/出场动画，在部分系统版本上会出现动画不生效的问题。
• 上下文强转的潜在异常
  直接将Adapter传入的context强转为Activity，如果context实例不是宿主Activity，会抛出类型转换异常，导致跳转逻辑中断，无法触发过渡。

具体调整步骤 #

1. 统一所有共享元素的匹配名称 #

三个位置的字符串值必须完全相同，不能有任何拼写差异，以"imageTransition"为例：

• 保留两个xml布局中ImageView的android:transitionName="imageTransition"配置不变
• 修正Adapter中启动动画的传参错误：

  // 修正前的错误写法
  ActivityOptionsCompat options = ActivityOptionsCompat.makeSceneTransitionAnimation(
      (Activity) context,
      holder.trackImg,
      "transition" // 错误：和xml配置的名称不匹配
  );
  
  // 修正后的正确写法
  Activity hostActivity = (Activity) holder.itemView.getContext();
  ActivityOptionsCompat options = ActivityOptionsCompat.makeSceneTransitionAnimation(
      hostActivity,
      holder.trackImg,
      "imageTransition" // 和两个xml中的配置完全一致
  );
  context.startActivity(i, options.toBundle());
  

2. 补充详情页的延迟过渡逻辑 #

避免动画在图片加载完成前启动，确保动画过程能完整呈现图片从列表到详情页的放大效果：
在VideoDetail的onCreate方法中，setContentView之后添加延迟启动逻辑，等待图片加载完成再触发动画：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_video_detail);
    ImageView detailImg = findViewById(R.id.imgDetail);

    // 延迟过渡启动，直到图片加载完成
    postponeEnterTransition();

    // 按项目实际使用的图片加载框架，在加载完成回调中启动过渡
    // 以Glide为例：
    Glide.with(this)
        .load(getIntent().getStringExtra("image"))
        .listener(new RequestListener<Drawable>() {
            @Override
            public boolean onLoadFailed(@Nullable GlideException e, Object model, Target<Drawable<Drawable>> target, boolean isFirstResource) {
                startPostponedEnterTransition();
                return false;
            }

            @Override
            public boolean onResourceReady(Drawable resource, Object model, Target<Drawable<Drawable>> target, DataSource dataSource, boolean isFirstResource) {
                startPostponedEnterTransition();
                return false;
            }
        })
        .into(detailImg);
}

3. 补全主题的过渡动画配置 #

在themes.xml的样式块中，新增共享元素动画的显式配置，避免系统默认动画缺失：

<style name="Theme.ITunes" parent="Theme.MaterialComponents.DayNight.DarkActionBar">
    <!-- 原有配置全部保留 -->
    <item name="android:windowContentTransitions">true</item>
    <!-- 新增共享元素动画配置 -->
    <item name="android:windowSharedElementEnterTransition">@android:transition/move</item>
    <item name="android:windowSharedElementExitTransition">@android:transition/move</item>
    <item name="android:windowSharedElementReturnTransition">@android:transition/move</item>
    <item name="android:windowSharedElementReenterTransition">@android:transition/move</item>
</style>

4. 保留详情页的返回过渡逻辑 #

现有代码中重写onBackPressed调用supportFinishAfterTransition()的逻辑是正确的，不需要改动，确保从详情页返回列表时也能触发平滑的缩小过渡。

内容的提问来源于stack exchange，提问作者Digvijay Singh Thakur