Gradle for Android 系列： Gradle 文件你真的了解吗？

   <p>读完本文你将了解到：</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/9c1a00002543cca41ccef4a573eb380c.png"></p>    <p>我们用 Android Studio 新创建一个项目时，会自动生成 3 个 Gradle 文件：</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/15ac73a8fc800f6e6a7e1a11e0b50c31.jpg"></p>    <p>接下来介绍这三个文件的作用。</p>    <h3>1. setting.gradle</h3>    <p>一个 Gradle 构建通常包括三个阶段：初始化，配置，和执行。</p>    <p>setting.gradle 文件在 <strong>初始化过程中</strong> 被执行，构建器通过 setting.gradle 文件中的内容了解哪些模块将被 build，下面的内容表明当前项目中除了 app 模块还有另外一个叫做 “shixinlibrary” 的依赖模块：</p>    <p>include ‘:app’, ‘:shixinlibrary’</p>    <p>注意：单模块项目不一定需要有 setting 文件，但一旦有多个模块，必须要有 setting 文件，同时也要写明所有要构建的模块，否则 gradle 不会 build 不包括的模块。</p>    <h3>2.主目录下的 build.gradle</h3>    <p>看 gradle 文件中的注释：</p>    <p>Top-level build file where you can configuration options common to all sub-projects/modules.</p>    <p>主目录下的 build.gradle 文件是最顶层的构建文件，这里配置所有模块通用的配置信息。</p>    <p>默认的顶层 build.gradle 文件中包括两个代码块 (buildscript 和 allprojects):</p>    <p><img src="https://simg.open-open.com/show/c3ed8471ed4a8832cd12243ef21c132a.jpg"></p>    <p>buildscript从名字就可以看出来，buildscript 是所有项目的构建脚本配置，主要包括依赖的仓库和依赖的 gradle 版本。</p>    <p>上图中 repositories 代码块将 jcenter 配置为一个仓库，JCenter 是一个很有名的 Maven 仓库。确定了依赖的仓库后，我们就可以在 dependencies 代码块中添加依赖的、在 jcenter 仓库中的包了。</p>    <p>dependencies 代码块用于配置构建过程中的依赖包，注意，这里是用于 <strong>构建过程</strong> ，因此你不能讲你的应用模块中需要依赖的库添加到这里。</p>    <p>默认情况下唯一被用于构建过程中的依赖包是 Gradle for Android 的插件。我们还可以添加一些其他用于构建的插件，比如 retrolambda, apt, freeline 等等。</p>    <p>allprojectsallprojects 代码块用来声明将被用于所有模块的属性，注意是 <strong>所有模块</strong> 。常见的就是配置仓库地址（jcenter, 自定义 maven 仓库等），你还可以在 allprojects 中创建 tasks，这些 tasks 最终会运用到所有模块中，</p>    <p>官方建议尽量少添加用于所有模块的属性，因为这意味着强耦合，一旦没有构建主项目，你的子模块很有可能因为缺少所有模块的属性导致构建失败。</p>    <h3>3.模块下的 build.gradle</h3>    <p>模块下的 build.gradle 文件只应用于当前模块，你可以覆盖主目录下的 build.gradle 的内容。</p>    <p>以我的练习项目为例介绍：</p>    <p><img src="https://simg.open-open.com/show/2467c0eef40aabdc00a4ac53c5181f76.jpg"></p>    <p>上图中主要分三个模块：apply plugin , android, dependencies。</p>    <p>apply pluginapply plugin 声明了接下来要用到哪些插件的内容，上图表明使用了 androd 插件，这里之所以能用 android 插件，是因为主目录中声明了 Gradle for Android 的依赖，这里才能使用。</p>    <p>因此当我们需要使用其他插件，比如 retrolambda 时，首先需要在主目录 build.gradle 文件中添加依赖，然后在模块 build.gradle 中声明使用 retrolambda 插件。</p>    <p>备注：默认的 android 插件是由 Google 官方维护的，为我们提供了构建、测试、打包 Android 应用的能力。除此之外我们还可以自定义插件。在逐渐加深对 Gradle 的了解后，我们将尝试自己写个 Gradle 插件。</p>    <p>android在声明了 android 插件后，我们就可以使用 android 插件提供的内容进行构建配置。</p>    <p>android 构建配置中必须要有的是两个版本：</p>    <ul>     <li>compileSdkVersion : 编译应用的 Android API 版本</li>     <li>buildToolsVersion : 构建工具版本      <ul>       <li>构建工具包括 aapt, zipalign, renderscript 等</li>       <li>用于在打包时生成各种中间产物，可以从 SDK Manager 中下载构建工具</li>      </ul> </li>    </ul>    <p>defaultConfig 代码块用于配置应用的默认属性，可以覆盖 AndroidManifest.xml 中的属性，比如：</p>    <ul>     <li>applicationId : 覆盖了 AndroidManifest 中的 package name</li>     <li>minSdkVersion : 覆盖了 AndroidManifest 中的属性，配置运行应用的最小 API</li>     <li>targetSdkVersion : 一样，用于通知系统当前应用已经被这个版本测试过，和之前的 compileSdkVersion 没有关系</li>     <li>versionCode : 一样，应用的版本号</li>     <li>versionName : 版本名称</li>    </ul>    <p>defaultConfig 还可以添加签名，占位符等等，这里只列这些。</p>    <p>buildTypes 用来定义如何构建和打包不同类型的应用，常见的就是测试和生产。具体内容后序介绍。</p>    <p>android 中还可以配置其他信息，比如 签名、渠道等，你可以在 Project Structure 面板中直观的查看，添加，也可以使用代码添加，这些内容我们后续详细介绍：</p>    <p style="text-align: center;"><img src="https://simg.open-open.com/show/9bb50386adde9560d2c72381eca1af42.jpg"></p>    <p>dependencies上图中可以看到 依赖配置 在 android 代码块的外边，事实上依赖配置是 Gradle 配置的基础功能，也就是说除了 Android，其他类型的项目（比如 JavaEE ）也可以这么用。</p>    <p>我们可以在依赖配置中，添加要使用的库，当然也可以添加本地的 jar 包。具体依赖配置内容我们后续深入介绍。</p>    <h2>备注</h2>    <p>注意：applicationId 和 package name 其实不是一个东西。</p>    <p>在使用 Gradle 构建以前，package name 其实有两个作用：</p>    <ul>     <li>在 R 文件中用作报名</li>     <li>应用的唯一标示</li>    </ul>    <p>我们知道，一个安卓手机上相同包名的 app 只能有一个。但是当我们想要同时安装一个应用的不同的版本，比如一种测试一种生产，这时，就需要修改 package name 了，但是资源代码和 R 文件要求使用的包名不能改变，否则你的所有源文件都会随着构建版本而改变。怎么办呢？</p>    <p>Gradle 出现后，Android 工具团队解耦了 package name 的两种不同用法，提出了 applicationId 的概念：</p>    <ul>     <li>定义在 Manifest 文件中的 package，继续用于源代码和 R 文件的标示</li>     <li>而 applicationId 则用作设备和 Google Play 的唯一标识</li>    </ul>    <p>也就是说 applicationId 覆盖了 package name 的一部分职责。</p>    <h2>总结</h2>    <p>这篇文章概览了一个 Android 项目中的 Gradle 文件作用及内容，引申出许多细节，比如 自定义构建、依赖管理、多种类型构建的配置等等。接下来我们将深入学习这些内容。</p>    <p> </p>    <p>来自：http://blog.csdn.net/u011240877/article/details/53798052</p>    <p> </p>