美文网首页
Android Gradle构建学习(一):基本定义

Android Gradle构建学习(一):基本定义

作者: zizi192 | 来源:发表于2017-07-24 22:46 被阅读0次

简介

Gradle是一个优秀的构建系统和构建工具,它允许通过插件创建自定义的构建逻辑。 我们基于Gradle以下的一些特点而选择了它:

  • 采用了Domain Specific Language(DSL语言)来描述和控制构建逻辑。
  • 构建文件基于Groovy,并且允许通过混合声明DSL元素和使用代码来控制DSL元素以控制自定义的构建逻辑。
  • 支持Maven或者Ivy的依赖管理。
  • 非常灵活。允许使用最好的实现,但是不会强制实现的方式。
  • 插件可以提供自己的DSL和API以供构建文件使用。
  • 良好的API工具供IDE集成。

注:Android Studio的Gradle文件路径:C:\Users\用户名\.gradle\wrapper\dists。通过工具下载 “http://services.gradle.org/distributions/gradle-版本号-all.zip” 文件后,直接把zip文件放到"C:\Users\用户名\.gradle\wrapper\dists\gradle-版本号-all\串号"路径即可。
关闭android studio 重新打开 或 直接单击android studio工具栏 Sync Project Gradle Files,即可解决android studio跟新gradle错误办法

Groovy

Groovy基于Java语言,运行在JVM之上。它是一种动态语言,既可以用于面向对象编程,又可以用作纯粹的脚本语言。
Groov具有像Python, Ruby 和 Smalltalk 语言特性的灵活动态语言, Groovy保证了这些特性像 Java语法一样被 Java开发者使用。
执行Groovy脚本时,Groovy会先将其编译成Java类字节码,然后通过Jvm来执行这个Java类

基本项目

一个Gradle项目的构建过程定义在build.gradle文件中,位于项目的根目录下。

一个最简单的Gradle纯Java项目的build.gradle文件包含以下内容:

apply plugin: 'java'

这里引入了Gradle的Java插件。这个插件提供了所有构建和测试Java应用程序所需要的东西。

最简单的Android项目的build.gradle文件包含以下内容

buildscript {
    repositories {
        mavenCentral()
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:0.11.1'
    }
}

apply plugin: 'android'

android {
    compileSdkVersion 19
    buildToolsVersion "19.0.0"
}

buildscrip{...}这里配置了驱动构建过程的代码。

在这个部分,它声明了使用Maven仓库,并且声明了一个maven文件的依赖路径。这个文件就是包含了0.11.1版本android gradle插件的库。

注意:这里的配置只影响控制构建过程的代码,不影响项目源代码。项目本身需要声明自己的仓库和依赖关系,稍后将会提到这部分。

接下来,跟前面提到的Java Plugin一样添加了android plugin。

最后,andorid{...}配置了所有android构建过程需要的参数。这里也是Android DSL的入口点。

默认情况下,只需要配置目标编译SDK版本和编译工具版本,即compileSdkVersion和buildToolsVersion属性。 这个complieSdkVersion属性相当于旧构建系统中project.properites文件中的target属性。这个新的属性可以跟旧的target属性一样指定一个int或者String类型的值。

重要:你只能添加android plugin。同时添加java plugin会导致构建错误。
注意:你同样需要在相同路径下添加一个local.properties文件,并使用sdk.dir属性来设置SDK路径。 另外,你也可以通过设置ANDROID_HOME环境变量,这两种方式没有什么不同,根据你自己的喜好选择其中一种设置。

工程中每个子模块(Library或者Application)都是一个单独的gradle编译的project。每个project在其根目录下都必须有一个build.gradle,该文件是project的编译脚本。

由于一个工程可能有多个子模块组成,gradle需要支持Multi-Projects Build,即同时编译多个project。在工程的根目录下添加一个build.gradle即可,该文件用来配置其他的子project。更重要的是在工程的根目录下添加settings.gradle,该文件记录了工程包含多少个子project。settings.gradle除了可以include外,还可以设置一些函数。这些函数会在gradle构建整个工程任务的时候执行,所以,可以在settings做一些初始化的工作。

//settings.gradle示例
include ':app', ':commonmodule', ':moudlea', ':moudlec'

Android Studio的Terminal,可以执行gradle命令。e.g. gradlew projects, gradlew <project-path>:tasks,gradlew tasks --all等

多project示例

项目结构

基本的项目开始于两个名为“source sets”的组件,即main source code和test code。它们分别位于:

  • src/main/
  • src/androidTest/
    里面每一个存在的文件夹对应相应的源组件。
    对于Android plugin来说,常见的文件和文件夹结构如下:


    项目结构.png

构建任务

General Tasks(通用任务)

添加一个插件到构建文件中将会自动创建一系列构建任务(build tasks)去执行(注:gradle属于任务驱动型构建工具,它的构建过程是基于Task的)。Java plugin和Android plugin都会创建以下task:

  • assemble 这个task将会组合项目的所有输出。
  • check 这个task将会执行所有检查。
  • build 这个task将会执行assemble和check两个task的所有工作
  • clean 这个task将会清空项目的输出。

实际上assemble,check,build这三个task不做任何事情。它们只是一个Task标志,用来告诉android plugin添加实际需要执行的task去完成这些工作。

这就允许你去调用相同的task,而不需要考虑当前是什么类型的项目,或者当前项目添加了什么plugin。 例如,添加了findbugs plugin将会创建一个新的task并且让check task依赖于这个新的task。当check task被调用的时候,这个新的task将会先被调用。

注意:Gradle会自动监视一个task声明的所有输入和输出。 两次执行build task并且期间项目没有任何改动,gradle将会使用UP-TO-DATE通知所有task。这意味着第二次build执行的时候不会请求任何task执行。这允许task之间互相依赖,而不会导致不需要的构建请求被执行。

Android tasks

Android plugin使用相同的约定以兼容其他插件,并且附加了自己的标识性task,包括:

  • assemble 这个task将会组合项目的所有输出。
  • check 这个task将会执行所有检查。
  • build 这个task将会执行assemble和check两个task的所有工作
  • clean 这个task将会清空项目的输出。
  • connectedCheck 这个task将会在一个指定的设备或者模拟器上执行检查,它们可以同时在所有连接的设备上执行。
  • deviceCheck 通过APIs连接远程设备来执行检查,这是在CL服务器上使用的。

这些新的标识性task是必须的,以保证能够在没有设备连接的情况下执行定期检查。 注意build task不依赖于deviceCheck或者connectedCheck。

一个Android项目至少拥有两个输出:debug APK(调试版APK)和release APK(发布版APK)。每一个输出都拥有自己的标识性task以便能够单独构建它们。

  • assemble
    • assembleDebug
    • assembleRelease

它们都依赖于其它一些tasks以完成构建一个APK需要多个步骤。其中assemble task依赖于这两个task,所以执行assemble将会同时构建出两个APK

gradle在命令行终端上支持骆驼命名法的task简称,例如,执行gradle aR命令等同于执行gradle assembleRelease。

check task也拥有自己的依赖:

  • check
  • lint
  • connectedCheck
  • connectedAndroidTest
  • connectedUiAutomatorTest(目前还没有应用到)
  • deviceCheck
  • 这个test依赖于test创建时,其它实现测试扩展点的插件。

参考文章:
http://blog.csdn.net/innost/article/details/48228651
http://www.groovy-lang.org/api.html groovy语法

相关文章

网友评论

      本文标题:Android Gradle构建学习(一):基本定义

      本文链接:https://www.haomeiwen.com/subject/crnbkxtx.html