Gradle构建生命周期简介和通用Maven打包脚本

Gradle构建生命周期简介和通用Maven打包脚本

Gradle构建生命周期

Gradle构建过程分为三个大的步骤:初始化、配置和执行。

初始化

初始化阶段的任务是根据settings.gradle创建项目的层次结构,为每一个module创建一个Project实例。并且在初始化之前会构造一个Settings对象,主要包含以下方法,可以直接在settings.gradle中访问。

- findProject(File): ProjectDescriptor
- findProject(String): ProjectDescriptor
- getGradle(): Gradle
- getRootDir():File
- getRootProject(): ProjectDescriptor
- getSettings(): Settings
- project(File): ProjectDescriptor
- project(String): ProjectDescriptor

比如可以通过如下代码向Gradle的构建过程添加监听:

gradle.addBuildListener(new BuildListener() {
  void buildStarted(Gradle var1) {
    println '开始构建'
  }
  void settingsEvaluated(Settings var1) {
    println 'settings评估完成(settins.gradle中代码执行完毕)'
    // var1.gradle.rootProject 这里访问Project对象时会报错,还未完成Project的初始化
  }
  void projectsLoaded(Gradle var1) {
    println '项目结构加载完成(初始化阶段结束)'
    println '初始化结束,可访问根项目:' + var1.gradle.rootProject
  }
  void projectsEvaluated(Gradle var1) {
    println '所有项目评估完成(配置阶段结束)'
  }
  void buildFinished(BuildResult var1) {
    println '构建结束 '
  }
})

执行结果如下:

settings评估完成(settins.gradle中代码执行完毕)
项目结构加载完成(初始化阶段结束)
初始化结束,可访问根项目:root project 'GradleTest'
所有项目评估完成(配置阶段结束)
:buildEnvironment

------------------------------------------------------------
Root project
------------------------------------------------------------

classpath
No dependencies

BUILD SUCCESSFUL

Total time: 0.959 secs
构建结束 

配置

配置阶段的任务是执行各项目下的build.gradle脚本,完成Project的配置,并且构造Task任务依赖关系图以便在执行阶段按照依赖关系执行Task。该阶段也是我们最常接触到的构建阶段,比如应用外部构建插件apply plugin: 'com.android.application',配置插件的属性android{...}等。每个build.gralde脚本文件对应一个Project对象,在初始化阶段创建,Project的接口文档。配置阶段执行的代码包括build.gralde中的各种语句、闭包以及Task中的配置段语句。

println 'build.gradle的配置阶段'

// 调用Project的dependencies(Closure c)声明项目依赖
dependencies {
    // 闭包中执行的代码
    println 'dependencies中执行的代码'
}

// 创建一个Task
task test() {
  println 'Task中的配置代码'
  // 定义一个闭包
  def a = {
    println 'Task中的配置代码2'
  }
  // 执行闭包
  a()
  doFirst {
    println '这段代码配置阶段不执行'
  }
}

println '我是顺序执行的'

调用gradle build,得到如下结果:

build.gradle的配置阶段
dependencies中执行的代码
Task中的配置代码
Task中的配置代码2
我是顺序执行的
:buildEnvironment

------------------------------------------------------------
Root project
------------------------------------------------------------

classpath
No dependencies

BUILD SUCCESSFUL

Total time: 1.144 secs

一定要注意,配置阶段不仅执行build.gradle中的语句,还包括了Task中的配置语句。**从上面执行结果中可以看到,在执行了dependencies的闭包后,直接执行的是任务test中的配置段代码(Task中除了Action外的代码段都在配置阶段执行)。
另外一点,无论执行Gradle的任何命令,初始化阶段和配置阶段的代码都会被执行。
同样是上面那段Gradle脚本,我们执行帮助任务gradle help,任然会打印出上面的执行结果。我们在排查构建速度问题的时候可以留意,是否部分代码可以写成任务Task,从而减少配置阶段消耗的时间。

执行

在配置阶段结束后,Gradle会根据任务Task的依赖关系创建一个有向无环图,可以通过Gradle对象的getTaskGraph方法访问,对应的类为TaskExecutionGraph,然后通过调用gradle <任务名>执行对应任务。

通用Maven打包上传脚本

通常我们在开发中遇到的情况是lib模块开发阶段和需要打包阶段的脚本配置方面有很大差别,所以一般的做法多为开发阶段的lib模块在需要上传到Maven仓库的时候,会有另外一个专用的项目来打包目标模块和上传,这个专用的模块一般情况下是一个壳子,而且可能因为lib模块在改动manifest文件或者BuildConfig参数的时候,需要对应要做出修改

但是这样做,往往意味着修改起来很麻烦,而且容易忘。所以我们需要一个通用的打包脚本来处理这些情况。

所以思路就是不使用壳module,直接使用开发的lib模块上传到maven库。而且考虑到历史原因及其兼容,不能直接在lib模块修改,那么就只能在rootProject这个层级考虑做一些事情。

上面有讲到Gradle在各个阶段的任务,同时,Gradle也提供了非常多的钩子给开发者自定义构建行为

gradle_hook.png

由此可以看到,我们的目标很明确,就是在lib模块配置阶段为我们注入一些我们需要的操作:移除开发阶段的本地依赖、移除maven配置文件的本地依赖、添加本地依赖的maven版本依赖。

//跟项目.gradle
allprojects {
    repositories {
        jcenter()
        google()
        afterEvaluate { project ->
            if (project.name == 'gisdk') {
                println '依赖maven插件:apply plugin maven for ' + project
                project.apply from: "${rootProject.projectDir}/maven.gradle"
                println "取消发布时debug版本的编译"
                project.android.publishNonDefault false
                project.dependencies {
                    println '依赖现网模块'
                    compile "xxx.xxx:xxx:${version}"
                }
                project.configurations {
                    println '排除本地依赖'
                    all*.exclude group: '${root_project_name}'
                }
                project.tasks.create(name: 'deleteKeepProguardRules') {
                    doFirst {
                        def path = "${project.projectDir}/build/intermediates/exploded-aar/com.xxx/xxx/${rootProject.ext.gtc.version}/proguard.txt"
                        def bFile = new File(path)
                        if (bFile.exists()) {
                            bFile.delete()
                            println '删除keep文件成功'
                        } else {
                            println '文件不存在:' + path
                        }
                    }
                }
                project.tasks.whenTaskAdded { task ->
                    if (task.name == 'transformClassesAndResourcesWithProguardForRelease') {
                        task.dependsOn deleteKeepProguardRules
                    }
                }
            }
        }
    }

}
//maven.gradle

apply plugin: 'maven'

def mavenProps = rootProject.ext.maven // 配置

def getProjectVersion() {
    def sdkProps = rootProject.ext.sdk // 配置
    return sdkProps.version
}

uploadArchives {
    repositories {
        mavenDeployer {
            repository(url: mavenProps.url) {
                authentication(userName: mavenProps.userName, password: mavenProps.pwd)
            }

            pom.groupId = mavenProps.groupId
            pom.artifactId = project.name
            pom.version = getProjectVersion() + mavenProps.snapshot
            println '上传的包:' + "${pom.groupId}:${pom.artifactId}:${pom.version}"

            pom.whenConfigured { pom ->
                def dependencies = []
                pom.dependencies.each { dep ->
                    if (dep.version == 'unspecified') {
                        println "无效的依赖:${dep.groupId}:${dep.artifactId}:${dep.version}"
                    } else {
                        dependencies.add(dep)
                    }
                }
                pom.dependencies = dependencies
                pom.dependencies.each { dep ->
                    println "最终的依赖:${dep.groupId}:${dep.artifactId}:${dep.version}"
                }
            }
        }
    }
}

至此,lib模块就可以实现无侵入式的maven打包上传能力

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,980评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,178评论 2 380
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,868评论 0 336
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,498评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,492评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,521评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,910评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,569评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,793评论 1 296
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,559评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,639评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,342评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,931评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,904评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,144评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,833评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,350评论 2 342

推荐阅读更多精彩内容