美文网首页
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