从编程的角度理解gradle脚本﹘﹘Android Studio脚本构建和编程[魅族Degao]

原创 2016年03月17日 12:35:00

本篇文章由嵌入式企鹅圈原创团队、魅族资深工程师degao撰写!

随着Android 开发环境从Eclipse转向Android Studio,我们每个人都开始或多或少要接触gradle脚本,大多数人将gradle看做构建工具,出现问题不知如何着手分析,只能寄希望百度能找到解决方案,其实大可不必。

如果我们把gradle看做编程框架,并理清gradle脚本与gradle对象的关系,通过查阅文档,不但能清晰理解gradle脚本,而且出现问题再也不用百度,通过查阅文档就能轻松解决问题。

本文就通过一个最普通的gradle工程,告诉大家如何通过查阅api文档来看懂Android里面的gradle 脚本。

一、gradle介绍

gradle基于的语言是groovy,而groovy语言是基于java语言的一个扩展,它完全兼容java语言的类库,所以在gralde脚本中你完全可以使用你熟悉的java语言来编程。在本文最后我们会给出一个直接在gradle脚本中使用java编程的例子。

由于本文仅仅是让大家能看懂脚本,而不是自己去编写,所以groovy和gradle的细节不是本文的重点,有需要的同学自行百度。这里要提的一点是groovy语言的函数调用是虽然和java类似,但是它是可以省略括号的,特别是当它的最后一个参数是闭包的时候。

println(“aaa” )//这个是可以的,

println“aaa” //这个也没有问题。

是不是发现了一个秘密:我们在gradle脚本里全是各种函数调用!!

Gradle api文档路径:https://docs.gradle.org/current/dsl/

由于我们也用到了Android 插件,所以我们也需要插件的文档,这个文档比较特殊,它是一个git工程,在线浏览老是显示html的源码而非页面,所以我建议大家将它clone回本地,然后用浏览器打开,工程地址:https://github.com/google/android-gradle-dsl.git


二、gradle脚本和gradle 类对应关系

稍稍浏览下gradle的文档,我们会发现工程里面的gradle脚本,其实和gradle的对象是对应的:

1.Gradle:全局对象,一次gradle构建对应一个Gradle对象;

2.Project:每个工程都是一个Project对象,它对应一个build.gradle文件;

3.Settings:对应一个Setting.gradle文件;

4.Task:代表要执行的工作,一个Project会有一个或多个Task用于完成构建的工作,Project会通过合理设置Task之间的依赖来组织构建流程,完成最终的构建任务。


三、脚本执行流程与对象生成

1.每次调用gradle 执行时,会先生成一个Gradle对象,里面保存一些全局的信息;

2.然后会解析setting.gradle,生成Settings对象,一般在setting.gradle中主要是调用include方法,导入工程下的各个子模块;

3.接下来会执行导入的各个子工程的build.gradle,生成并配置Project对象;

一般在build.gradle中,会调用Project的apply方法,引入插件,在插件中完成定义各种属性以及创建所需的Task。


四、实例解析

我们以一个Android studio 默认app样例工程结构为例,工程包含的gradle脚本目录结构:

1. setting.gradle

setting.gradle只有一行语句:

include ':app'

这里的include其实是Setting的一个函数,‘:app' 是函数调用的参数。

那我们在setting.gradle里面还能写什么呢?因为setting.gradle对应的是gradle中的Settings对象,那查下Settings的文档(https://docs.gradle.org/current/dsl/org.gradle.api.initialization.Settings.html),看下它都有哪些方法,哪些属性,就知道在setting.gradle能写什么了:

比如:

include ':Common'

project(':Common').projectDir = new File(settingsDir,'../../SDK/Common/')//include 调用后,生成了一个名为:CommonProject对象,project(':Common')取出这个对象,设置ProjectprojectDir属性。

那projectDir哪里来的?请看Project类的文档。


2. build.gradle

接下来我们来看build.gradle,build.gradle对应一个Project对象,而Project本身是一个Build script

而BuildScript可以包含哪些东西呢?


是不是看到了很多老朋友?buildscript , dependencies 。。

看了这里我们应该就能明白在build.gradle里面可以写哪些东西了。


这里要说明的一个重要的点是buildscript任何一个build.gradle执行的时候,会优先处理buildscript,它是来给脚本建立运行环境的,什么是运行环境?

一般而言就是下载所需要的插件,举个例子,android工程都需要android插件,它们都是通过下面的方式引入的:

buildscript {

   repositories {//告诉如果本地没有缓存,去哪个远程仓库下载插件

        mavenCentral()

   }

   dependencies {

        //这就是我们在applyplugin:com.android.application时的插件jar

        classpath 'com.android.tools.build:gradle:1.3.0'

        // NOTE: Do not place your application dependencies here; theybelong

        //in the individual module build.gradle files

   }

}

repositories {//告诉如果本地没有缓存,去哪个远程仓库下载编译时依赖的库

        mavenCentral()

    }

上面的repositories, dependencies都是函数调用哦~~

看到上面的两个一模一样的repositories 了吗?他们的作用是不一样的,在buildscript里面的那个是插件初始化环境用的,用于设定插件的下载仓库,而外面的这个是设定工程依赖的一些远程library的下载仓库的。

在build.gradle中引入插件,是我们常见的动作:

apply plugin: 'com.android.application'

查阅Project的文档(https://docs.gradle.org/current/dsl/org.gradle.api.Project.html).apply是Project的一个方法,

3. android相关部分

查阅android插件的文档:(file:///home/test/android-gradle-dsl/1.5/index.html

上面就是我们在android{}里面能写的所有block的信息,然后在每个block里面能写什么继续点击进去察看有哪些属性和方法就可以了,

比如signingConfigs:

signingConfigs{

   release {

        storeFile file('../sign/release.jks')

        storePassword "5mall@ndro!d"

        keyAlias "small"

        keyPassword"5mall@ndro!d"

   }

}

本文至此可以告一段落,相信大家结合文档应该能弄明白gradle脚本里面的每个代码块的意义了。

五、Android工程间的父子关系

需要补充的是:上面例子工程的结构中,工程之间是存在父子关系的,比如RxJava-Android-Samples/build.gradle对应的Project是RxJava-Android-Samples/app/build.gradle对应的Project的父亲,而在父Project中做的操作是会被子Project继承的,比如如果在 父Project引入过了android 插件,则在子Project中可直接引用,不需要重写一个buildscript块。

1.   RxJava-Android-Samples/build.gradle

buildscript {

   repositories {

        mavenCentral()

   }

   dependencies {

        classpath 'com.android.tools.build:gradle:1.3.0'

        // NOTE: Do not place your application dependencies here; theybelong

        //in the individual module build.gradle files

   }

}

allprojects {

   repositories {

        mavenCentral()

   }

}

 

2.   RxJava-Android-Samples/app/build.gradle

//直接引用android插件,没有buildscript准备插件;

apply plugin:'com.android.application'

dependencies {

   compile 'com.android.support:support-v13:23.0.1'

   compile 'io.reactivex:rxandroid:1.0.1'

   // BecauseRxAndroid releases are few and far between, it is recommended you also

   // explicitly depend on RxJava'slatest version for bug fixes and new features.

   compile 'io.reactivex:rxjava:1.0.14'

   compile 'io.reactivex:rxjava-math:1.0.0'

   compile 'com.jakewharton.rxbinding:rxbinding:0.2.0'

   compile 'com.jakewharton:butterknife:5.1.1'

   compile 'com.jakewharton.timber:timber:2.4.2'

   compile 'com.squareup.retrofit:retrofit:1.6.1'

   compile 'com.squareup.okhttp:okhttp:2.0.0'

   compile 'com.squareup.okhttp:okhttp-urlconnection:2.0.0'

   compile 'com.alibaba:fastjson:1.2.4'

   debugCompile 'com.squareup.leakcanary:leakcanary-android:1.3'

   releaseCompile 'com.squareup.leakcanary:leakcanary-android-no-op:1.3'

}

android {

   compileSdkVersion 23

   buildToolsVersion '23.0.1'

   defaultConfig {

        applicationId "com.morihacky.android.rxjava"

        minSdkVersion14

        targetSdkVersion22

        versionCode1

        versionName"1.0"

   }

   buildTypes {

        release {

            minifyEnabled true

            proguardFilesgetDefaultProguardFile('proguard-android.txt'),'proguard-rules.pro'

        }

   }

}

六、在gradle中使用java语言编程的例子

       直接上代码,想学习的就劳心理解啦,编辑器对代码不太友好啊。

1. build.gradle

buildscript {

    repositories{

    maven {

        url 'http://artifactory.rnd.meizu.com/artifactory/all'

    }

}

    dependencies {

        classpath 'org.aspectj:aspectjtools:1.8.6'

    }

}

importorg.aspectj.bridge.IMessage

import org.aspectj.bridge.MessageHandler

importorg.aspectj.tools.ajc.Main

dependencies{

compile'org.aspectj:aspectjrt:1.8.6'

}

android.applicationVariants.all{ variant ->

    JavaCompile javaCompile = variant.javaCompile

    //println javaCompile.properties

    javaCompile.doLast {

        String[] args = [

                "-showWeaveInfo",

                "-1.5",

                "-inpath", javaCompile.destinationDir.toString(),

                "-aspectpath",javaCompile.classpath.asPath,

                "-d", javaCompile.destinationDir.toString(),

                "-classpath",javaCompile.classpath.asPath,

                "-bootclasspath",android.bootClasspath.join(File.pathSeparator)

        ]

        MessageHandler handler = newMessageHandler(true);

        new Main().run(args, handler)

        def log = project.logger

        for (IMessage message : handler.getMessages(null,true)) {

            switch (message.getKind()) {

                case IMessage.ABORT:

                case IMessage.ERROR:

                case IMessage.FAIL:

                    log.error message.message,message.thrown

                    break;

                case IMessage.WARNING:

                case IMessage.INFO:

                    log.info message.message,message.thrown

                    break;

                case IMessage.DEBUG:

                    log.debug message.message,message.thrown

                    break;

            }

        }

        println "aspect args : " +args.toString()

    }

}

2. groovy

下面这段代码展示了groovy中变量定义,函数定义,List,Map,Range,闭包。

1)变量定义

defvariable1 = 1   //可以不使用分号结尾 

2)函数定义;

StringtestFunction(arg1,arg2){//无需指定参数类型 

      ... 

3)List变量由[]定义,比如 

defaList = [5,'string',true] //List由[]定义,其元素可以是任何对象

4)List存取

aList[100]= 100 //设置第101个元素的值为10 

assertaList[100] == 100

5)Map变量由[:]定义,比如

defaMap = ['key1':'value1','key2':true] 

Map由[:]定义,注意其中的冒号。冒号左边是key,右边是Value。key必须是字符串,value可以是任何对象。另外,key可以用''或""包起来,也可以不用引号包起来。比如:

defaNewMap = [key1:"value",key2:true]//其中的key1和key2默认被处理成字符串"key1"和"key2" 

不过Key要是不使用引号包起来的话,也会带来一定混淆,比如 

defkey1="wowo" 

defaConfusedMap=[key1:"who am i?"] 

//aConfuseMap中的key1到底是"key1"还是变量key1的值“wowo”?显然,答案是字符串"key1"。如果要是"wowo"的话,则aConfusedMap的定义必须设置成: 

defaConfusedMap=[(key1):"who am i?"] 

6)Range类,Range类型的变量 由begin值+两个点+end值表示

def aRange =1..5 

//如果不想包含最后一个元素,则 

defaRangeWithoutEnd = 1..<5 

//包含1,2,3,4这4个元素

7)闭包

defxxx = {paramters -> code}  //或者 

defxxx = {无参数,纯code}

比如: 

defgreeting = { "Hello, $it!" } 

assertgreeting('Patrick') == 'Hello, Patrick!'

当函数的最后一个参数是闭包的话,可以省略圆括号;

public static<T> List<T>each(List<T> self, Closure closure) 

上面这个函数表示针对List的每一个元素都会调用closure做一些处理。这里的closure,就有点回调函数的感觉。但是,在使用这个each函数的时候,我们传递一个怎样的Closure进去呢?比如: 

def iamList =[1,2,3,4,5]  //定义一个List 

iamList.each{//调用它的each,这段代码的格式看不懂了吧?each是个函数,圆括号去哪了?

      println it 

上面代码有以下知识点: 

each函数调用的圆括号不见了!原来,Groovy中,当函数的最后一个参数是闭包的话,可以省略圆括号。比如 

deftestClosure(int a1,String b1, Closure closure){ 

      //dosomething 

     closure() //调用闭包 

那么调用的时候,就可以免括号! 

testClosure4, "test", { 

   println"i am in closure" 

}

 

开始你的Gradle构建和编程之旅吧~~


更多的嵌入式linux和android、物联网、汽车自动驾驶等领域原创技术分享请关注微信公众号:


 

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/yueqian_scut/article/details/50911803

Android Studio--Gradle脚本初识

其实很早之前也写了一篇Gradle的基础博客,但是时间很久了,现在Gradle已经更新了很多,所以暂且结合Stduio 1.0正式版与最新的Gradle语法来详细讲解下,小伙伴们直接跟我一步步来学习吧...
  • hanhailong726188
  • hanhailong726188
  • 2015年04月29日 19:44
  • 1739

android studio 除了用本身生成jar 还可以通过简单的脚本来生成

set opath=%~dp0\class11.jar     //这里不用动 cd c:\                                                 //也不...
  • qq_35581716
  • qq_35581716
  • 2017年07月03日 10:04
  • 157

Android Studio入门到精通

PS一句:最终还是选择CSDN来整理发表这几年的知识点,该文章平行迁移到CSDN。因为CSDN也支持MarkDown语法了,牛逼啊!目标:Android Studio新手–>下载安装配置–>零基础入门...
  • yanbober
  • yanbober
  • 2015年04月27日 09:59
  • 121466

使用 buck 打包 Android( 使用OkBuck给Android Studio+gradle生成 buck 脚本)

一、安装Buck 1、环境 Buck当前只支持 Mac OS X 和 Linux 本文以Mac OS X平台为例进行介绍 首先需要确保你的 OS X 满足以下条件: Oracle JDK 7 A...
  • u014077888
  • u014077888
  • 2015年10月10日 12:06
  • 4440

用Kotlin写Android Gradle脚本

Android应用开发中,离不开Gradle脚本的构建。大部分Android开发同学忽视了脚本的力量,甚至有很大一部分同学不知道Gradle脚本是什么,用什么语言编写的;当然,也有相当一部分同学知道G...
  • apple337008
  • apple337008
  • 2018年01月26日 13:20
  • 387

Android studio Gradle 编程

前言 近排看了一本书《Gradle for Android 中文版》,整理了一下gradle在项目中经常用到的地方。跟着大家一起入坑,另外欢迎加入Android 开发车群398910565,大家一边...
  • wangguan_9527
  • wangguan_9527
  • 2018年02月10日 19:30
  • 47

Android 使用Android Studio + Gradle 或 命令行 进行apk签名打包

官方文档:https://developer.android.com/tools/publishing/app-signing.html 1. 默认为debug mode,使用的签名文件在: $H...
  • jjwwmlp456
  • jjwwmlp456
  • 2015年04月08日 17:03
  • 41129

android cmake脚本

  • 2016年08月13日 14:28
  • 80KB
  • 下载

Android Studio Gradle实践之多渠道自动化打包+版本号管理

转: Android Studio Gradle实践之多渠道自动化打包+版本号管理 上次介绍了Android Studio的安装、配置和基本使用。这次讲一下Android...
  • wxx614817
  • wxx614817
  • 2016年09月20日 11:33
  • 1486

持续交付之六——构建与部署的脚本化

第六章 构建与部署的脚本化1. 引言要实现 自动构建 自动部署 构建和部署系统一直要保持活力,这个系统不仅要从项目开始就开发,而且一直持续到产品到上线维护阶段,细心设计和维护它,像对待项目源代码一样,...
  • RO_wsy
  • RO_wsy
  • 2016年05月01日 17:06
  • 876
收藏助手
不良信息举报
您举报文章:从编程的角度理解gradle脚本﹘﹘Android Studio脚本构建和编程[魅族Degao]
举报原因:
原因补充:

(最多只允许输入30个字)