参考文档
| 序号 | 名称 | 链接地址 | 备注 |
|---|---|---|---|
| 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 版本 = <font color="red">1.8.0_40</font>
- Android Studio = <font color="red">3.0.1</font>
- ApiDemos源代码 = 你的Android SDK目录下/samples/<font color="red">android-22</font>/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 | 错误 | 项目导入之后，编译项目，开始解决编译错误。<font color="red">编译错误1：为preference_switch文件增加.xml后缀</font> first build apiDemos and resolve first error
|
| 6 | 错误&操作 | <font color="red">编译错误2:缺少support v4 包，需要导入正确版本的support v4 包，默认通过module settings 导入的都是最新的版本，有可能不兼容。需要导入和buildToolsVersion 相匹配的v4 包。</font> need support v4 package
 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()仓库支持
|
| 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编译需要内核
 注释掉mms相关代码，因为mms编译需要内核2
|
| 11 | 错误&操作 | 查看android-22和android-23源码得知：Notification.setLatestEventInfo方法在android-23以上被删除了，所以需要修改compileSdkVersion=22 Notification.setLatestEventInfo方法在android-23以上被删除了，所以需要修改compileSdkVersion=22
 适合compileSdkVersion=22的BuildToolsVersion列表
 适合buildTools 22.0.1 的Support library 版本
|
| 12 | 错误 | Android Gradle Plugin 版本3.0.1要求buildToolsVersion至少26.0.1，所而这里buildToolsVersion已经不能升高，所以只能奖励gradle plugin 版本来匹配buildToolsVersion = 22.0.1 gradle plugin 版本对于buildToolsVersion=22.0.1来说太高了，必须降低
 适合buildToolsVersion=22.0.1的gradle plugin版本
 修改Gradle版本来适合Gradle plugin 版本
 Gradle plugin版本降低之后，需要移除google()仓库，因为低版本不支持
 替换implementation为旧版本complie方法
|
| 13 | 错误&操作 | 注释掉错误行代码,api 23 才加入的方法,方然也可以继续修改编译环境来匹配api 23. 注释掉错误行代码，api 23 加入的方法
 api 23加入的方法
|
| 14 | 错误 | 可能出现的错误，如果出现，按照错误提示修改成res-auto名称空间即可。 Gradle项目中自定义View都使用res-auto名称空间
|
<font color="red">至此，ApiDemos已经可以运行成功了。</br>
代码已经上传至Github：https://github.com/Farubaba/ApiDemos
</font>
