【MacOS High Sierra】Android Studio 3.0.1 构建Android-22版本ApiDemos项目

参考文档

序号	名称	链接地址	备注
1	Android Gradle Plugin Release Notes	https://developer.android.com/studio/releases/gradle-plugin.html#updating-gradle	详细描述了Android Gradle Plugin的版本变更，以及每个版本对Gradle版本和Build Tools Version的依赖关系
2	SDK Build Tools Release Notes	https://developer.android.com/studio/releases/build-tools.html	记录了Build Tools 各个版本信息，包括版本号等
3	Support v4 library Revision archive	https://developer.android.com/topic/libraries/support-library/rev-archive.html	记录了Support v4包的修改进化过程，版本信息等修改升级档案
4	Migrate to Android Plugin for Gradle 3.0.0	https://developer.android.com/studio/build/gradle-plugin-3-0-0-migration.html#new_configurations	详细介绍了如何升级Android Gradle plugin到3.0.0版本，解决遇到的问题，版本冲突等

一、环境准备

操作系统 = MacOS High Sierra 10.13.2

JDK 版本 = 1.8.0_40

Android Studio = 3.0.1

ApiDemos源代码 = 你的Android SDK目录下/samples/android-22/legacy/ApiDemos
（如果没有，请使用SDKmanager下载）

二、关键概念

1. Android Studio
2. Gradle
3. Gradle Wrapper
4. Gradle distributionUrl
5. Gradle DSL method
6. Android Gradle Plugin
7. buildToolsVersion
8. compileSdkVersion

三、Android Studio 3.0.1中创建新项目(或者转化Eclipse项目)采用的默认配置

1. 由于AndroidStudio3.0.1默认使用Android Gradle plugin 3.0.0+版本，而Android Gradle 
   plugin 3.0.0+需要依赖于Gradle 4.1+版本,并且要求Build Tools 26.0.2 or higher.
   
2. Gradle plugin 3.0.0+中会自带一个最低可使用版本的Build Tools，只要使用Gradle 
   plugin 3.0.0+版本就不再需要手动指定Build Tools(buildToolsVersion)了。

四、Android Studio 3.0.1 导入Android-22中的ApiDemos项目

步骤	类型	示例
1	操作	Android Studio中导入eclipse项目，自动生成gradle配置文件。 import eclipse project from android studio
2	操作	选择我们准备好的Android-22 ApiDemos源码目录。 select apiDemos project
3	操作	设置Project要导入的目标目录 select project import directory
4	操作	保持默认导入设置不变 keep the import settings default
5	错误	项目导入之后，编译项目，开始解决编译错误。编译错误1：为preference_switch文件增加.xml后缀 first build apiDemos and resolve first error
6	错误&操作	编译错误2:缺少support v4 包，需要导入正确版本的support v4 包，默认通过module settings 导入的都是最新的版本，有可能不兼容。需要导入和buildToolsVersion 相匹配的v4 包。 need support v4 package 添加V4包：项目右键-->open module settings-->选择modules中的app-->选择Dependencies-->点击左下角 "+"号-->选择support v4包-->点击OK-->OK关闭module settings界面。导入Support v4包 add support v4 package
7	错误	编译错误2:缺少support v4 包，需要导入正确版本的support v4 包，默认通过module settings 导入的都是最新的版本，有可能不兼容。需要导入和buildToolsVersion 相匹配的v4 包。 need support v4 package
8	操作	添加V4包：项目右键-->open module settings-->选择modules中的app-->选择Dependencies-->点击左下角 "+"号-->选择support v4包-->点击OK-->OK关闭module settings界面。 add support v4 package 最新support v4被放置在了google()仓库中，需要添加google()仓库支持,点击图中错误Add GoogleMaven repository and sync project之后会添加google()仓库到项目中最新support v4被放置在了google()仓库中，需要添加google()仓库支持
8	错误	点击上图中错误Add GoogleMaven repository and sync project之后会添加google()仓库到项目中，再编译点击上图中错误Add GoogleMaven repository and sync project之后会添加google()仓库到项目中，再编译
9	操作	修改minSdkVersion为14，再编译修改minSdkVersion为14
10	操作	[注释掉mms相关代码，因为mms编译需要内核。注释掉所有错误地方注释掉mms相关代码，因为mms编译需要内核注释代码2，注释掉所有错误地方注释掉mms相关代码，因为mms编译需要内核2
11	错误&操作	查看android-22和android-23源码得知：Notification.setLatestEventInfo方法在android-23以上被删除了，所以需要修改compileSdkVersion=22 Notification.setLatestEventInfo方法在android-23以上被删除了，所以需要修改compileSdkVersion=22 适合compileSdkVersion=22的BuildToolsVersion列表，从中得知22.0.0和22.0.1适合，我们选择22.0.1 适合compileSdkVersion=22的BuildToolsVersion列表适合buildTools 22.0.1 的Support library 版本，我们选择22.2.1 适合buildTools 22.0.1 的Support library 版本修改build.gradle文件：compileSdkVersion=22 buildToolsVersion=22.0.1 support v4 版本为 22.2.1
12	错误	Android Gradle Plugin 版本3.0.1要求buildToolsVersion至少26.0.1，所而这里buildToolsVersion已经不能升高，所以只能奖励gradle plugin 版本来匹配buildToolsVersion = 22.0.1 gradle plugin 版本对于buildToolsVersion=22.0.1来说太高了，必须降低修改gradle plugin版本适合buildToolsVersion=22.0.1的gradle plugin版本修改Gradle版本来匹配gradle plugin版本修改Gradle版本来适合Gradle plugin 版本 Gradle plugin降级之后删除不支持的google（）仓库 Gradle plugin版本降低之后，需要移除google()仓库，因为低版本不支持 Gradle plugin降级之后修改implementation为compile 替换implementation为旧版本complie方法
13	错误&操作	注释掉错误行代码,api 23 才加入的方法,方然也可以继续修改编译环境来匹配api 23. 注释掉错误行代码，api 23 加入的方法 api 23加入的方法
14	错误	可能出现的错误，如果出现，按照错误提示修改成res-auto名称空间即可。 Gradle项目中自定义View都使用res-auto名称空间