You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

添加Material Design依赖后出现AAPT2错误求助

解决Android项目添加Material Design依赖时的AAPT2错误

看起来你踩了Material Components库早期预览版本的坑了!我来帮你梳理下问题和解决办法:

你的操作与问题

你尝试添加了Material.io提供的早期预览版依赖:

compile 'com.google.android.material:material:1.0.0-alpha1'

并且之前已经配置了Jitpack仓库:

maven { url "https://jitpack.io" }

同步后遇到了这个模糊的错误:

AAPT2 error: check logs for details

错误及依赖截图

问题根源与解决方案

1.0.0-alpha1是Material Components库非常早期的测试版本,不仅存在大量未修复的bug,还和当时的AAPT2工具兼容性极差,而且它依赖的旧版support库现在也早已被AndroidX取代,这就是你遇到错误的核心原因。

正确的处理方式如下:

  • 放弃旧的alpha版本,使用稳定版依赖:现在Material Components库已经有成熟的稳定版本,推荐使用最新的稳定版(可在Google Maven仓库查看实时更新的版本号),示例依赖如下:
    implementation 'com.google.android.material:material:1.11.0'
    
  • 确保仓库配置正确:Material Components库托管在Google Maven仓库,不需要Jitpack,所以要保证项目根目录的build.gradle中包含Google仓库:
    repositories {
        google()
        mavenCentral()
    }
    
  • 确认项目使用AndroidX:从Material Components 1.0正式版开始,库完全基于AndroidX,如果你还在使用旧的support库,需要先迁移到AndroidX(可通过Android Studio的Refactor > Migrate to AndroidX工具一键完成)。

按照以上步骤配置后,重新同步项目,应该就能解决AAPT2的错误了。

内容的提问来源于stack exchange,提问作者Farzan Hosseini

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.27 07:16:38