Android4.4下CardView结合ConstraintLayout的TransitionManager动画失效问题

折叠动画在Android 4.4失效问题 #

根因 #

系统框架层自带的android.transition.TransitionManager虽然在API19首次加入，但初始实现存在缺陷，无法正确捕获ConstraintLayout的约束变更、View显隐属性变化，且后续官方没有对4.4版本的框架类做bug修复，因此会直接跳过动画渲染到终态。

修复步骤 #

• 替换依赖为AndroidX兼容版Transition库，该库对API14+全版本做了适配，修复了低版本系统Transition实现的所有已知bug，模块build.gradle添加依赖：

dependencies {
    // 保证ConstraintLayout版本≥2.0.4，低版本存在Transition适配bug
    implementation "androidx.constraintlayout:constraintlayout:2.1.4"
    implementation "androidx.transition:transition:1.4.1"
}

• 替换代码导包，删除所有框架层Transition相关导包，替换为AndroidX版本：

import androidx.transition.AutoTransition;
import androidx.transition.TransitionManager;

• 封装通用折叠切换方法，支持单卡片多组折叠区域复用：

/**
 * 切换折叠区域显隐
 * @param toggleBtn 点击触发的箭头按钮
 * @param contentView 要折叠/展开的内容区域
 */
private void toggleFoldArea(View toggleBtn, View contentView) {
    // 箭头旋转动画，4.4原生属性动画完全支持
    float targetRotation = contentView.getVisibility() == View.VISIBLE ? 0f : 180f;
    toggleBtn.animate().rotation(targetRotation).setDuration(300).start();
    // 取当前卡片根布局作为Transition场景根，避免多区域动画冲突
    ViewGroup sceneRoot = (ViewGroup) toggleBtn.getRootView().findViewById(R.id.card_root);
    TransitionManager.beginDelayedTransition(sceneRoot, new AutoTransition().setDuration(300));
    // 切换内容显隐
    contentView.setVisibility(contentView.getVisibility() == View.VISIBLE ? View.GONE : View.VISIBLE);
}

后续新增3组同类型可展开区域时，只需在点击事件中传入对应区域的按钮和内容View，调用该方法即可，无需重复编写动画逻辑。

偶现Could not find class 'androidx.core.view.ViewCompat$1'报错修复 #

根因 #

该问题是AndroidX Core 1.5.0~1.7.0版本在API19上的类加载时序bug，首次冷启动时ViewCompat内部匿名类未被正确加载，重启后类完成预加载就不再报错，和业务代码逻辑无关。

修复步骤 #

• 在模块build.gradle中强制指定稳定版Core依赖，避开存在bug的版本：

configurations.all {
    resolutionStrategy.force 'androidx.core:core:1.9.0'
}

• 若开启了代码混淆，在混淆规则中添加如下配置，避免ViewCompat内部类被错误裁剪：

-keep class androidx.core.view.ViewCompat$* { *; }

• 补充4.4矢量图兼容配置，避免上下箭头资源加载异常：
  1. 在build.gradle的defaultConfig块中添加：

  vectorDrawables.useSupportLibrary = true
  

  2. 代码中加载箭头矢量图时使用AppCompatResources.getDrawable()替代直接调用setImageResource()，防止低版本系统解析矢量图失败。

验证注意事项 #

注意：测试4.4机型时先确认开发者选项中「窗口动画缩放」「过渡动画缩放」「动画程序时长缩放」未被设置为0，否则系统会全局禁用所有动画，表现为内容直接显隐。
注意：同一卡片内多组折叠区域的布局约束需和对应折叠头绑定，不要依赖其他折叠区域的控件定位，避免动画过程中布局出现跳变。

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