Gradle构建报错：JetifyTransform转换vebase.aar匹配android-res失败求助

错误信息 #

Execution failed for task ':app:preBuild'.
> Could not resolve all artifacts for configuration ':app:debugRuntimeClasspath'.
   > Failed to transform artifact 'vebase.aar (com.bytedance.ugc.framework.libs:vebase:19.1.0.242_73fe611ad_alpha.1-mt)' to match attributes {artifactType=android-res}.
      > Execution failed for JetifyTransform: /Users/bytedance/.gradle/caches/modules-2/files-2.1/com.bytedance.ugc.framework.libs/vebase/19.1.0.242_73fe611ad_alpha.1-mt/ebd52bb7342c55997058c1f498fff9fb687a98c/vebase-19.1.0.242_73fe611ad_alpha.1-mt.aar.
         > Failed to transform '/Users/bytedance/.gradle/caches/modules-2/files-2.1/com.bytedance.ugc.framework.libs/vebase/19.1.0.242_73fe611ad_alpha.1-mt/ebd52bb7342c55997058c1f498fff9fb687a98c/vebase-19.1.0.242_73fe611ad_alpha.1-mt.aar' using Jetifier. Reason: null. (Run with --stacktrace for more details.)

vebase.aar结构 #

├── AndroidManifest.xml
├── META-INF
│	└── com
│	    └── android
│	        └── build
│	            └── gradle
│	                └── aar-metadata.properties
├── R.txt
├── annotations.zip
├── classes.jar
├── jni
│	└── arm64-v8a
│	    ├── libNLEEditorJni.so
│	    ├── libNLEMediaJni.so
│	    ├── libNLEMediaPublicJni.so
│	    ├── libNLEMediaRemoteJni.so
│	    ├── libNLEResourcesDAVJni.so
│	    ├── libNLETemplateModelJni.so
│	    └── libttvesdk.so
├── proguard.txt
└── res
    └── values
        └── values.xml

解决步骤 #

1. 获取详细错误栈追踪 #

执行构建命令时添加--stacktrace参数，获取Jetify失败的真实原因（替代当前模糊的Reason: null）：

./gradlew clean assembleDebug --stacktrace

栈信息会暴露具体异常，比如资源文件语法错误、依赖冲突、缓存损坏等。

2. 清理Gradle缓存 #

缓存损坏是常见诱因，执行以下命令清理后重新构建：

# 清理项目构建缓存
./gradlew cleanBuildCache
# 删除本地Gradle全局缓存
rm -rf ~/.gradle/caches/

3. 调整Jetifier配置 #

如果vebase.aar本身已兼容AndroidX，无需Jetify转换，可单独排除该依赖的Jetify处理：

• 在模块级build.gradle的依赖声明中添加忽略配置：

  implementation('com.bytedance.ugc.framework.libs:vebase:19.1.0.242_73fe611ad_alpha.1-mt') {
      android.jetifier.ignore = true
  }
  

• 或者在项目根目录的gradle.properties中添加黑名单：

  android.jetifier.blacklist=vebase-*.aar
  

4. 检查资源文件合法性 #

解压vebase.aar，打开res/values/values.xml，排查以下问题：

• 未闭合的XML标签、非法特殊字符
• 重复的资源ID或名称
• 颜色、尺寸等资源的格式错误（比如颜色值缺少#前缀，尺寸未加单位）

5. 对齐Gradle与AGP版本 #

Jetify的兼容性与Android Gradle Plugin（AGP）版本强相关，确保AGP和Gradle版本匹配，尝试升级到稳定版：

• 根目录build.gradle中更新AGP版本：

  dependencies {
      classpath 'com.android.tools.build:gradle:7.4.2' // 替换为当前稳定版
  }
  

• 根目录gradle/wrapper/gradle-wrapper.properties中更新Gradle版本：

  distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
  

6. 确认ABI架构配置 #

检查模块级build.gradle中是否包含aar支持的arm64-v8a架构：

android {
    defaultConfig {
        ndk {
            abiFilters 'arm64-v8a', 'armeabi-v7a' // 根据项目需求调整
        }
    }
}

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