AS3.0升级埋坑之路

10月26日，谷歌在经过大半年的磨练后终于发布了Android studio 3.0 正式版，给广大Android 开发人员一份满意的答卷，如同往常一样，大多数人担心版本稳定性，是否存在坑等问题选择隔岸关火，等过段时间在选择升级，我也是犹豫很久，经过仔细查看官方文档后选择了升级，以下将自己在升级过程中遇到的问题分享给大家。

AS3.0的版本特性

---

Kotlin Support

正如Google I / O 2017所宣布的那样，Kotlin编程语言现在在Android上正式得到支持。所以在这个版本中，Android Studio包含了Android开发的Kotlin语言支持。

选择工具栏 Code -> Convert Java File To Kotlin File，或者使用快捷键的形式，你可以一键实现 Java 文件到 Kotlin 文件的转换。

具体查看 官网add Kotlin to your project。

Java 8 language features support

3.0 对 Java 8 语言特性的默认支持使你不用在 build.gradle 配置文件中添加 jackOptions 一项。如果你有使用到的话，记得删除：

android {
    ...
    defaultConfig {
        ...
        // Remove this block.
        jackOptions {
            enabled true
            ...
        }
    }
}

选择工具栏 File->Project Structure，修改 Source Compatibility 和 Target Compatibility 选项到 1.8 即可使我们的项目支持 Java 8 语言特性。

Android Profiler

新的Android Profiler 取代了Android Monitor工具，并提供了一套新的工具来实时测量您的应用程序的CPU，内存和网络使用情况。您可以执行基于样本的方法跟踪来定时执行代码，捕获堆转储，查看内存分配以及检查网络传输文件的详细信息。
如下图所示，点击图标即可打开
详细内容查看官方文档
- CPU Profiler guide
- Memory Profiler guide
- Network Profiler guide

Device File Explorer

新版开发工具带来的资源管理器允许我们访问连接设备的文件系统，实现 PC 端到手机或模拟器端的便捷文件传输。有了这个工具，从此就可以告别之前使用的「文件传输助手」等第三方工具啦

打开方式为 ：View > Tool Windows > Device File Explorer.
具体详情看官网 Device File Explorer guide

Adaptive Icons wizard

选择 File -> New -> Image Asset，利用 Android Studio 提供的工具创建图片资源一直以来也是开发利器之一。现在，这个工具开始支持
vector drawables 格式，并且能够创建用于适配 Android 8.0 系统上各种形状的桌面图标。

其他功能

大家可以参考官方文档 Android Studio Release Notes

---

旧项目迁移遇到的坑

---

在Android studio 3.0发布的同时，Android Plugin for Gradle 3.0.0 也同时发布了 ，编译速度得到巨大提升，因为Android Plugin for Gradle 3.0.0 对添加依赖的方法有很大的变化，会导致旧项目不能被编译通过。所以需要对旧项目做必要的修改才能通过Gradle 编译。下面我根据一个工程来记录一下埋坑之路。

gradle 升级错误

因为Android Plugin for Gradle 3.0.0需要Gradle版本4.1或更高版本，所以需要将gradle升级
由于国内限制访问的原因，不能在线更新，*除外，所以给大家上离线更新方法。

• windows系统
  查看所需gradle版本：打开C:\Users\用户名.gradle\wrapper\dists\gradle-x.xx-all\xxxxxxxxxxxx，如果里面的 gradle-xx-all.zip不完整（如0KB），则说明下载不成功，需要下载离线包放置到该目录下。如下所示 那么，则需要下载gradle-2.8-all.zip。gradle各个版本离线包下载地址：http://download.csdn.net/album/detail/2265
  导入完成后，运行AS之后会自动解压，如下。重新打开项目就可以了~~

• mac系统
  1.找到.gradle目录，一般在/User/<用户名>/下;需要执行defaults write com.apple.finder AppleShowAllFiles Yes && killall Finder命令显示隐藏的文件即可看到.gradle文件夹
  2.进入.gradle/wrapper/dists/gradle-4.1-all/xxxxxxxxxxxxxxx文件夹下，删除.part文件
  3.去gradle网站下载对应的gradle-4.1-all.zi文件，下载完成后不解压放入xxxxxxxxxxxxx文件夹下
  4.重新打开android studio问题已经解决

新版 Android Studio 工具默认使用 Google’s Maven Repository 用于下载依赖 Android Support Library，替代了 Android SDK Manager 的本地依赖方式。所以，需要在工程根目录下的 build.gradle 文件中添加 google() 一行代码：

allprojects {
    repositories {
        google()
    }
}

将project下的build.gradle修改为

接下来是这三个error，我们一个个解决
Android Plugin For Gradle 3.0.0 默认自动添加插件所需要用到的最小版本的编译工具。所以，我们不需要再手动在 build.gradle 添加一行 buildToolsVersion 属性的代码。对于旧的项目，可以去掉这行配置，比如：

android {
     compileSdkVersion 26
    //remove buildToolsVersion
    //buildToolsVersion '26.0.2'
    ...
}

Error:android-apt plugin is incompatible with the Android Gradle plugin. Please use ‘annotationProcessor’ configuration instead.，以为plugin开始，第三方android-adt不在受支持，所以这个问题根据建议，我们将项目中的adt 替换成 annotationProcessor，以butterknife为例

将根目录下的build.gradle 中的依赖移除

buildscript {
    ...
    dependencies {
        classpath 'com.android.tools.build:gradle:3.0.0'
        //移除
        //classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'

    }
}

将 app下的adt依赖替换成 annotationProcessor，然后将apply plugin: ‘android-apt’去除，例如：

Error:All flavors must now belong to a named flavor dimension. Learn more at https://d.android.com/r/tools/flavorDimensions-missing-error-message.html

对于这个错误，Plugin 3.0.0 开始，如果 build.gradle 自定义有 productFlavors 配置的话，需要添加定义 flavorDimensions（风味维度）。否则，编译报错。
flavorDimensions 的出现使得构建变种类型更加多样化，详细可参阅 配置构建变体。
在这里我们为了旧项目的顺利编译 加一个默认值

flavorDimensions "default"

productFlavors {
    beta {
      ...
    }

    production {
        ...
    }
}

接下来会遇到样式找不到的问题

这是因为在 Plugin 3.0.0开始，AAPT2 默认被开启，我们关掉它就好了，在gradle.properties中加一行

android.enableAapt2=false

最后是这个问题

因为在3.0.0开始，compile被弃用，将不适合本地库和库依赖，例如

 implementation project(':library')

如果主项目有多个buildTypes,相应的本地库也应该添加对应的buildTypes。例如
主项目

buildTypes {
  release {}
  debug{}
}

library里也应该添加
buildTypes {
  release {}
  debug{}
}

对于旧的工程，上面就是我遇到的问题，如果你还遇到别的问题，别紧张，静下心来仔细看看官网，一切问题会迎刃而解。