Build Tools & Platform Tools & Tools & platform & Gradle 貌似复杂的依赖关系

忘是亡心i 2022-06-02 11:25 152阅读 0赞

# 写在前面 #

这篇博客的主题不是很明显，但是等你看完，可以明白两个问题：

*  Build Tools & Platform Tools & Tools 的区别。
 *  Build Tools & Platform Tools & Tools & Platform & Gradle 这几个货版本到底是怎么相互依赖对应的。

# 开篇 #

在安装和配置 Android Studio 的时候，有一个很重要的步骤，就是配置 SDK 路径，那么 SDK 是什么呢？

SDK（Soft Develop Kit），按照我硬翻的风格是是软件开发工具箱，其实，正确的理解是一整套开发工具。例如 Android SDK，就是 Google 提供的和 Android 开发相关的一整套开发工具，不仅包括编译，运行，打包这些必须的，还有很多其他小工具。了解和学习它们，对开发工作很有帮助。

然后就说到这三个文件夹，tools,build-tools,platform tools,首先它们仨都是 Android SDK 提供的文件夹，名字都像，常常傻傻分不清楚。

![7fc73e431d6c24cae5aa4d7126c26679.png][]

其实我也不知道弄懂它们有什么意义，但是我不想每次都一脸懵逼，于是就有了这篇博客。

# Build Tools #

Build-Tools 的内部结构如图。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMyNDUyNjIz_size_16_color_FFFFFF_t_70]

没想到的是，我目前使用的 SDK 中有这么多版本的 Build-Tools。那么问题就来了，

*  Build-Tools 是干嘛的？为什么要专门放一个文件夹？
 *  Build-Tools 为什么需要这么多版本的？只有一个行不行？

这个时候，就要去看谷爹的官方介绍说明了，我认为那里是最准确的描述。

![93a01d3410da23e5d10ccca934e8984c.png][]

上面说，Build-Tools 是 Android 应用编译和创建过程中所必须的一套工具集合。

开发的时候，我们应该时刻保证我们的 Build-Tools 是最新版的。而且从 Android Studio 3.0.0 开始，创建项目的时候，会根据 Gradle 插件的版本，默认使用版本支持范围中最低版本的 Build-Tools。当然，如果需要更改的话，通过 build.gradle 中修改 buildToolsVersion 参数可以修改。

android {
        buildToolsVersion "26.0.2"
        ...
    }

以上是官方说明。从中，我们可以找到之前问题的答案：

*  *build Tools 是干嘛的？为什么要专门放一个文件夹？*  
    build tools 是 Android 应用编译和创建过程中所必须的一套工具集合，放一个文件夹的意义，就是我猜是为了好分类吧。
 *  *build Tools 为什么会有这么多版本的？只有一个行不行？*  
    官方建议是最好及时更新，保持最新版本。从这句话可以看出，build tools 只需要保持一个最新版本就好。从 Android 系统整体都是向后兼容的特性考虑，一个最新版本也是足够的。
    
    至于问什么会有这么多版本，是因为我使用的时候，不是最新版，然后用了不同的版本的 SDK，每个 SDK 有对应的 Build-Tools 版本范围，所以下了很多。

#### Gradle plugin & Build Tools ####

而且 从我们谷爹说的话中，可以知道 Gradle plugin 和 Build-Tools 版本之间有着不同寻常的关系。

Gradle 是目前比较流行的构建工具之一，Android Studio 中集成的就是 Gradle,并针对 Android 应用开发了插件 Gradle plugin 。在我看来，编译和构建环节本就密不可分，由此猜测二者之间会不会有版本兼容的考虑，查看文档果然如此。

Gradle Plugin 的版本说明中，对 Gradle 和 Build Tools 的版本都要最低要求。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMyNDUyNjIz_size_16_color_FFFFFF_t_70 1]

把最新的几个版本总结了如下表格：

<table> 
 <thead> 
  <tr> 
   <th align="left">Android Gradle Plugin</th> 
   <th align="left">Gradle</th> 
   <th align="left">Build Tools</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">3.0.0</td> 
   <td align="left">4.1+</td> 
   <td align="left">26.0.2+</td> 
  </tr> 
  <tr> 
   <td align="left">2.3.0+</td> 
   <td align="left">3.3+</td> 
   <td align="left">25.0.0+</td> 
  </tr> 
  <tr> 
   <td align="left">2.2.0+</td> 
   <td align="left">2.14.1+</td> 
   <td align="left">23.0.2+</td> 
  </tr> 
 </tbody> 
</table>

[Android Plugin for Gradle Release Notes  
][Android Plugin for Gradle Release Notes]

# Platform Tools #

Platform Tools 的内部结构如图。

![61cb7e1d51ec731e3868ac09ed5c33cf.png][]

本来我以为会像 Build-Tools 一样有很多版本，然而并不是，只有一个。

看一下谷爹的说明：

![3f0c1d79bf492fdca7439abb9342ce04.png][]

Platform-Tools 是 Android SDK 的一个组件 。内容主要包含与 Android 移动平台交互的工具，例如 adb(android 调试桥，用来和应用通信的),fastboot（线刷，一种刷机模式） 和 systrace(通过这个，可以查看分析系统运行中的所有数据)等。 这些工具堪称 Android 应用开发之必备工具。如果想解锁手机开机程序或者刷机的话，也需要它们。

尽管这些工具中的一些新功能仅适用于最新版本的 Android，但是因为这些工具也是向后兼容的，然后只需要一个版本 Platform-Tools 的就好了。

我们应该尽量保证是最新版本，前几天我的 adb 总是连接出错，升级了版本就好了，应该是新版本已经发现问题并修复了。

### Platform-Tools & Platform ###

博客最上面的图片中，可以看到 sdk 文件夹内部组成中，有这样两个文件夹，platform tools 和 platform 。从名字上看，就感觉俩货之间肯定是有事。  
Platform 内部结构如图。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMyNDUyNjIz_size_16_color_FFFFFF_t_70 2]

很明显，这就是不同版本 Android 系统们，以 API 为序号。用户下载了几个版本，里面就有几个版本。build.gradle 中 `compileSdkVersion` 参数对应的就是这其中的版本。

android {
        compileSdkVersion 26
        ...
    }

查看 Platform 的官方介绍，发现 Platform 的每个版本都对 Platform tools 有最低版本要求。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMyNDUyNjIz_size_16_color_FFFFFF_t_70 3]

从版本号看，基本保持一致，还是比较好记。例如 platform 25 就要求 platform tools 25.0.1+。

同时，我们也可以看到对 Build-Tools 的版本也要求，列出表格如下：

<table> 
 <thead> 
  <tr> 
   <th align="left">Android Version</th> 
   <th align="left">API Level</th> 
   <th align="left">Platform-tools</th> 
   <th align="left">Build tools</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">Android 6.0</td> 
   <td align="left">23</td> 
   <td align="left">23+</td> 
   <td align="left">24.3.4+</td> 
  </tr> 
  <tr> 
   <td align="left">Android 5.1</td> 
   <td align="left">22</td> 
   <td align="left">22+</td> 
   <td align="left">23.0.5+</td> 
  </tr> 
  <tr> 
   <td align="left">Android 5.0</td> 
   <td align="left">21</td> 
   <td align="left">21+</td> 
   <td align="left">23.0.5+</td> 
  </tr> 
 </tbody> 
</table>

[SDK Platform Release Notes  
][SDK Platform Release Notes]

# Tools #

Tools 的内部结构如图。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMyNDUyNjIz_size_16_color_FFFFFF_t_70 4][]

Tools 在我的环境中只有一个版本，所以按照这种规律，很明显，开发环境中应该也只需要一个版本的就足够的。

以下是我们的谷爹对它的一句话介绍：

![在这里插入图片描述][2021051001052564.png]

Tools 也是 Android SDK 的一个组件，包括一套完整的 Android 开发和调试工具，Tools 也包含在 Android Studio 中。

### Tools & Platform-Tools ###

翻翻 Tools 的版本记录，发现 Tools 和 Platform 之间也有对应关系。例如下图，26.0.0 的 Tools 就依赖 Platform-Tools 24+ 。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMyNDUyNjIz_size_16_color_FFFFFF_t_70 5]

总结如下：

<table> 
 <thead> 
  <tr> 
   <th align="left">Build Tools</th> 
   <th align="left">Platform-tools</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">24.4.0</td> 
   <td align="left">24+</td> 
  </tr> 
  <tr> 
   <td align="left">24.3.4</td> 
   <td align="left">23+</td> 
  </tr> 
  <tr> 
   <td align="left">24.3.3</td> 
   <td align="left">19+</td> 
  </tr> 
 </tbody> 
</table>

[SDK Tools Release Notes  
][SDK Tools Release Notes]

# 总结 #

写到这里，上面已经出现 Tools,Build-Tools,Platform -Tools,Platform,Gradle,Gradle Plugin，名字大多相似，关系也有点交错，很容易晕，总结如下：

1.Gradle Plugin 基于 Gradle,Build-Tools 生成的。  
2.Platform 基于 Platform-Tools,Build-Tools 生成的。  
3.Tools 基于 Platform-Tools 生成的。

看图更清晰一点：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMyNDUyNjIz_size_16_color_FFFFFF_t_70 6]

# 写在最后： #

这篇博客的初衷是上篇博客中受启发，想特意学习一下 Tools 文件夹想法的开始的，然而没想到牵扯出来这么多，想来还是因为会的太少了。

写完后，我突然明白了，之前遇到导入一个 Github 上拉取的新项目，然后就各种报错各种需要下载的情况，版本不兼容报错，解决方法是下载对应版本或者改成兼容的版本。

为了避免出现这种情况，要定期更新 Build-Tools ,Platform-Tools 和 Tools,保持较新的版本。

然后，下篇博客见。

--------------------

欢迎关注个人微信公众号「浅浅同学的开发笔记」，最新的博客，好玩的事情，都会在上面分享，期待与你共同成长。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMyNDUyNjIz_size_16_color_FFFFFF_t_70_pic_center]

[7fc73e431d6c24cae5aa4d7126c26679.png]: /images/20220602/0020ea949518490bb72a716e79c4bb99.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMyNDUyNjIz_size_16_color_FFFFFF_t_70]: /images/20220602/85a8ce979c4743b09d7280a914b1fd54.png
[93a01d3410da23e5d10ccca934e8984c.png]: /images/20220602/3b64c5c93fe04bc991c6058d3a18230d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMyNDUyNjIz_size_16_color_FFFFFF_t_70 1]: /images/20220602/6ec8e453f6f34f5ba7fa40e53fb9c4b3.png
[Android Plugin for Gradle Release Notes]: https://developer.android.com/studio/releases/gradle-plugin.html
[61cb7e1d51ec731e3868ac09ed5c33cf.png]: /images/20220602/a77ae8bc6b4a4c4f842edb8e09232a33.png
[3f0c1d79bf492fdca7439abb9342ce04.png]: /images/20220602/9872767903114c2b9c04a9aa6a4fbad7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMyNDUyNjIz_size_16_color_FFFFFF_t_70 2]: /images/20220602/855bbe9441974c1ea33e54a725b80422.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMyNDUyNjIz_size_16_color_FFFFFF_t_70 3]: /images/20220602/5747f0f4d61542eb83930986a16658a0.png
[SDK Platform Release Notes]: https://developer.android.com/studio/releases/platforms.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMyNDUyNjIz_size_16_color_FFFFFF_t_70 4]: /images/20220602/e5392fb7af3b4da9baca462006acfede.png
[2021051001052564.png]: /images/20220602/104e458677614b3ba04336e2ea04c81f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMyNDUyNjIz_size_16_color_FFFFFF_t_70 5]: /images/20220602/923ca6a1e16646a3bdf75be05925b4c3.png
[SDK Tools Release Notes]: https://developer.android.com/studio/releases/sdk-tools.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMyNDUyNjIz_size_16_color_FFFFFF_t_70 6]: /images/20220602/fd817a7a56f94f2a830f84f1acee21f0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzMyNDUyNjIz_size_16_color_FFFFFF_t_70_pic_center]: /images/20220602/a58eeb5390674253b8417c855d300693.png