如何结合Fragment返回栈实现共享元素转场？

场景回顾 #

主Activity包含MainFragment（负责Tab布局），每个Tab对应带RecyclerView的Fragment；点击RecyclerView元素时，需通过共享元素转场跳转到详情Fragment，目前遇到三类兼容问题：

1. 用add方式添加Fragment，无转场动画
2. 用replace+addToBackStack，进入转场正常但详情Fragment为空
3. 替换为新MainFragment加入返回栈，退出时转场失效

逐个问题解决 #

问题1：add方式无转场动画 #

原因：add操作会保留原Fragment的视图层级，系统不会触发原Fragment的exit/return转场，新Fragment的enter转场也无法正常触发。

解决方案：
改用hide(currentFragment) + add(newFragment)的组合，配合共享元素和转场设置：

fragmentManager.beginTransaction()
    .hide(current)
    .add(R.id.fragmentHolder, newFragment, tag)
    .addToBackStack(tag)
    .addSharedElement(sharedView, sharedElementName)
    .commit();

同时确保原Fragment（被hide的）设置setExitTransition和setSharedElementReturnTransition，新Fragment设置setEnterTransition和setSharedElementEnterTransition。

问题2：replace+addToBackStack时详情Fragment为空 #

原因：要么详情Fragment未正确从Arguments取数据渲染，要么replace操作的容器ID错误，或是返回栈标签设置不当导致状态丢失。

排查&解决步骤：

1. 检查详情Fragment的视图初始化逻辑，确保正确读取Arguments并设置共享元素名称：

@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
    View view = inflater.inflate(R.layout.fragment_show_element, container, false);
    if (getArguments() != null) {
        AddElement element = (AddElement) getArguments().getSerializable("element");
        String transitionName = getArguments().getString("transitionName");
        // 给详情页的共享View设置完全匹配的transitionName
        ImageView detailImage = view.findViewById(R.id.detail_image);
        detailImage.setTransitionName(transitionName);
        // 渲染数据到视图
        // Glide.with(this).load(element.getImageUrl()).into(detailImage);
        // ...其他UI渲染逻辑
    }
    return view;
}

2. 确认replace操作的容器ID为MainActivity中承载Fragment的正确容器（比如R.id.fragmentHolder），不要误替换Tab内部的容器。
3. 修改返回栈标签设置，不要传null，用指定tag精准管理：

fragmentManager.beginTransaction()
    .replace(R.id.fragmentHolder, newFragment, tag)
    .addToBackStack(tag) // 传入tag而非null
    .addSharedElement(sharedView, sharedElementName)
    .commit();

问题3：替换新MainFragment入栈后退出转场失效 #

原因：重新创建MainFragment会导致原Tab Fragment、RecyclerView的视图完全销毁，返回时找不到匹配transitionName的源View，共享元素转场无法触发。

解决方案：

• 复用原有MainFragment实例，不要重新创建。跳转详情Fragment时，用replace或hide+add将详情页加入返回栈，返回时popBackStack会自动恢复原MainFragment的状态。
• 保存原Fragment的状态：通过ViewModel保存Tab选中状态、RecyclerView滚动位置等数据，在onViewCreated中恢复；避免滥用setRetainInstance(true)（可能引发内存泄漏）。

通用注意事项 #

• transitionName严格匹配：源View和目标View的transitionName必须完全一致，转场过程中不可修改。
• 转场设置时机：必须在Fragment事务commit前设置转场，不要在Fragment生命周期方法中重复设置，避免冲突。
• 版本兼容：仅在API 21+启用转场动画，低版本直接跳过。
• 避免视图销毁：原Fragment视图销毁会导致返回时共享元素转场失效，通过addToBackStack()保留Fragment状态是关键。

修改后的完整showFragmentWithTransition方法 #

public void showFragmentWithTransition(Fragment current, Fragment newFragment, String tag, View sharedView, String sharedElementName) {
    FragmentManager fragmentManager = getSupportFragmentManager();
    boolean fragmentPopped = fragmentManager.popBackStackImmediate(tag, 0);
    if (fragmentPopped) {
        return;
    }
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
        // 设置当前Fragment的返回转场
        current.setSharedElementReturnTransition(TransitionInflater.from(this).inflateTransition(R.transition.default_transition));
        current.setExitTransition(TransitionInflater.from(this).inflateTransition(R.transition.default_transition));
        
        // 设置新Fragment的进入转场
        newFragment.setSharedElementEnterTransition(TransitionInflater.from(this).inflateTransition(R.transition.default_transition));
        newFragment.setEnterTransition(TransitionInflater.from(this).inflateTransition(R.transition.default_transition));
    }
    
    fragmentManager.beginTransaction()
        .replace(R.id.fragmentHolder, newFragment, tag)
        .addToBackStack(tag)
        .addSharedElement(sharedView, sharedElementName)
        .commit();
}

内容的提问来源于stack exchange，提问作者shybaka