从Android Studio 2.14迁移至3.0.1时遇问题，请求技术协助

嘿，我太懂把用顺手的老版本AS升级到新环境有多闹心了，尤其是你的应用已经有5000+下载，容不得半点差池。结合AS 3.0.1的核心变化，我整理了迁移时最容易踩的坑和对应的解决办法，你可以对照排查：

1. 依赖配置与Gradle版本不兼容 #

AS 3.0.1对应的Gradle插件版本是com.android.tools.build:gradle:3.0.1，Gradle wrapper版本至少要4.1，这和2.14的旧版本差异很大：

• 先修改根目录下的build.gradle，确保buildscript里的插件版本和仓库配置正确：

  buildscript {
      repositories {
          google() // AS 3.0开始推荐优先用google仓库，替换原来的旧仓库配置
          jcenter()
      }
      dependencies {
          classpath 'com.android.tools.build:gradle:3.0.1'
      }
  }
  

• 再修改gradle/wrapper/gradle-wrapper.properties里的distributionUrl：

  distributionUrl=https\://services.gradle.org/distributions/gradle-4.1-all.zip
  

• 另外，旧的compile依赖关键字要换成implementation或api，这是3.0开始的强制规范，compile会被标记为过时：

  // 旧写法
  compile 'com.squareup.okhttp3:okhttp:3.9.0'
  // 新写法
  implementation 'com.squareup.okhttp3:okhttp:3.9.0'
  

2. 编译工具（Build Tools）版本适配 #

AS 3.0.1要求Build Tools版本至少是26.0.2，打开模块的build.gradle修改：

android {
    buildToolsVersion "26.0.2"
    // 同时确保compileSdkVersion至少是26，和Build Tools版本匹配
    compileSdkVersion 26
}

如果找不到这个版本，点击AS右上角的Sync按钮，会自动提示下载对应版本，直接确认即可。

3. 第三方库兼容性问题 #

很多旧的第三方库可能没适配Gradle 3.0的新规范，遇到报错可以试试这些办法：

• 检查库的最新版本，通常主流库（比如Glide、Retrofit）都会在AS 3.0发布后更新适配版本；
• 如果某些库确实没有新版本，尝试在模块的build.gradle里添加android.enableAapt2=false（放在android{}块外），关闭AAPT2编译工具换回旧版本，但这只是临时方案，建议尽快找替代库或等官方更新；
• 遇到Manifest merger failed错误，打开AndroidManifest.xml，点击底部的Merged Manifest标签，查看冲突的权限或组件，手动用tools:replace属性解决，比如：

  <application
      android:name=".MyApplication"
      tools:replace="android:name">
  

4. 资源文件命名与格式问题 #

AS 3.0对资源文件的校验更严格，容易触发隐藏问题：

• 资源文件名不能有大写字母，必须全小写加下划线，比如MyIcon.png要改成my_icon.png；
• 矢量图（Vector Drawable）在低版本设备（API<21）使用时，要确保开启兼容：

  android {
      defaultConfig {
          vectorDrawables.useSupportLibrary = true
      }
  }
  

  同时布局里要用app:srcCompat代替android:src引用矢量图。

5. 构建缓存与清理问题 #

升级后容易出现缓存导致的奇怪报错，先做这些清理操作：

• 点击AS顶部菜单栏的File → Invalidate Caches / Restart，选择Invalidate and Restart；
• 手动删除项目根目录下的.gradle、build文件夹，以及模块下的build文件夹，然后重新Sync项目。

如果还有具体的报错信息，比如编译时的错误日志、运行时的Crash栈，你可以贴出来，我再帮你针对性解决！

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