当前位置：首页 > news >正文

android的gradle

news 来源：原创 2025/5/15 4:08:10

资料：

GitHub - ChenSWD/CopyGradleInAction: 备份《Gradle IN Action》书中的源码，添加了部分注释 //github上一个开源项目，外加pdf书

Gradle User Manual gradle官网

讲的挺好的博客

Gradle之重新认识Gradle(项目结构、命令行、task、构建Java项目、包装器)_gradle no-source-CSDN博客

Kotlin DSL 是基于 Kotlin 语言 的一种 领域特定语言（DSL），用来更方便地在 Gradle 中编写构建脚本。为了让 Kotlin 能够适配 Gradle，Kotlin DSL 对 Gradle 的一些功能做了特定的调整和封装，使其能够以更自然、更 Kotlin 风格的方式使用。

goovy DSL是一个意思

所以gradle不是一个脚本而是一个构建工具，他是用java写的，运行的jvm上，所以有gradle和jdkc冲突的情况。Android是ART虚拟机，解释的是dex文件

脚本语言（Scripting Language）是一种用于编写脚本（脚本是一系列按照特定顺序执行的命令或指令）的计算机编程语言。与编译型语言不同，脚本语言的代码不需要事先通过编译生成机器码，而是在运行时由解释器逐行解释执行。比如python，就是脚本语言，不需要编译就可以运行，只需要解释器

这里有个gradlew很有用，因为这个可以在窗口中运行gradlew脚本

gradlew 和 gradlew.bat 都是 Gradle Wrapper（Gradle 包装器） 的一部分，它们的作用是让项目可以使用 Gradle 而无需提前在系统中安装 Gradle。两者的主要区别在于 操作系统环境 和 文件格式，如下所示：

什么是Gradle Wrapper?

Gradle Wrapper Basics. 官网地址

Gradle Wrapper 的主要功能

统一 Gradle 版本：
- Gradle Wrapper 可以确保所有开发者使用项目指定的 Gradle 版本，避免版本不一致导致的问题。
- Wrapper 会根据 gradle/wrapper/gradle-wrapper.properties 中配置的版本自动下载所需的 Gradle。
自动下载 Gradle：
- 如果本地没有所需的 Gradle 版本，Wrapper 会自动从官方仓库下载指定版本的 Gradle。
- 下载的 Gradle 存储在本地缓存目录（默认在 ~/.gradle/wrapper/dists）。
无需手动安装 Gradle：
- 开发者无需手动安装 Gradle，只需运行项目中的 Wrapper 脚本即可。
跨平台支持：
- gradlew 和 gradlew.bat 分别支持类 Unix 和 Windows 系统，让项目可以在不同操作系统中无缝构建。

环境依赖：

gradlew 依赖于系统的 Shell 环境（如 Bash）。
gradlew.bat 依赖于 Windows 的批处理执行环境（如 CMD）。

如我在mac环境中执行：

./gradlew -v ---查看当前的gradle版本信息

这里请注意：在这里使用的gradle是我们项目的wrap中配置的gradle

gradle是由一系列构建任务组成的

我们查看下gradle一共有提供多少任务：

在窗口中输入：./gradlew -v ，可以看到有很多任务

Android tasks
-------------
androidDependencies - Displays the Android dependencies of the project.
signingReport - Displays the signing info for the base and test modules
sourceSets - Prints out all the source sets defined in this project.Build tasks
-----------
assemble - Assemble main outputs for all the variants.
assembleAndroidTest - Assembles all the Test applications.
assembleUnitTest - Assembles all the unit test applications.
build - Assembles and tests this project.
buildDependents - Assembles and tests this project and all projects that depend on it.
buildKotlinToolingMetadata - Build metadata json file containing information about the used Kotlin tooling
buildNeeded - Assembles and tests this project and all projects it depends on.
bundle - Assemble bundles for all the variants.
clean - Deletes the build directory.
compileDebugAndroidTestSources
compileDebugSources
compileDebugUnitTestSources
compilePreSources
compilePreUnitTestSources
compileReleaseSources
compileReleaseUnitTestSources
debugSourcesJar - Assembles a jar archive containing the sources of target 'debug'.
extractDebugAnnotations - Extracts Android annotations for the debug variant into the archive file
extractReleaseAnnotations - Extracts Android annotations for the release variant into the archive file
releaseSourcesJar - Assembles a jar archive containing the sources of target 'release'.

比如：

./gradlew clean
清楚app的build下的缓存

如果嫌弃敲命令可以点击图形化的

gradle的一个配置流程

最开始读取setting.gradle，就知道一共有多少模块了

build.gradel是每个模块的构建脚本，可以读取这个模块依赖了哪些插件，支持哪些任务等，最为核心的东西

讲解几个方法，其实gradle中写的全是方法，比如：plugins

点击plugins,发现就是一个fun,因为kotlin中如果最后一个参数是方法的话，lamd表达式可以放在（）后面，因为只有一个参数，所以（）可以省略

    public final fun plugins(block: org.gradle.kotlin.dsl.PluginDependenciesSpecScope.() -> kotlin.Unit): kotlin.Unit { /* compiled code */ }

那alias函数呢？其实是PluginDependenciesSpecScope类中的，因为你传入的函数，给你弄成了

PluginDependenciesSpecScope的扩展函数he

gradle虽然是用java写的，运行在虚拟机上，但是他不支持用 java写脚本，只是支持kotin和goovy,因为java太繁琐了

这种都是gradle的脚本

编写设置文件_哔哩哔哩_bilibili

pluginManagement {repositories {google {content {includeGroupByRegex("com\\.android.*")includeGroupByRegex("com\\.google.*")includeGroupByRegex("androidx.*")}}mavenCentral()gradlePluginPortal()}
}
dependencyResolutionManagement {repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)repositories {google()mavenCentral()}
}rootProject.name = "My Application"
include(":app")
include(":suAssert")
include(":mylibrary")这些方法其实都是settings对象对象提供的
eg:
settings.include(":mylibrary")
只是为了方便，把settings去掉了

setting.gradle中也可以配置插件，但是这里配置了的都是全局的，一般都在module中配置

记得是一行一行往下执行

pluginManagement {       //这个是指定插件的仓库地址repositories {google {content {includeGroupByRegex("com\\.android.*")includeGroupByRegex("com\\.google.*")includeGroupByRegex("androidx.*")}}mavenCentral()gradlePluginPortal()}
}
dependencyResolutionManagement {     //这是第三方依赖库的仓库地址repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)repositories {google()mavenCentral()}
}

指定自定义的maven仓库：

maven{setUrl("")credentials {username = SCOPE_ACCOUNTpassword = SCOPE_PWD}
}

settings.gradle.kts，其实作用域是

SettingsScriptApi,他是继承setting的，所以返回的是setting对象

自定义任务：

tasks有两种注册方式：register和creat 。register是懒加载的意思

tasks.register("sujinbiao"){doLast{println("结束")}doFirst{println("开始")}
}

这样后：gradle的task ->others->sujinbiao

双击就可以执行或者命令行执行./gradlew sujinbiao

新创建的task的组别是在other中，那么如何切换呢？

tasks.create("sujinbiao"){group = "build"description = "新建的task" //会出现在打印的日志中doLast{println("结束")}doFirst{println("开始")}
}

tasks.create("sujin"){group = "build"description = "新建的task"doLast{println("sujin")}doFirst{println("sujin")}
}tasks.create("sujinbiao"){group = "build"description = "新建的task"dependsOn("sujin")   //依赖别的任务，别人任务执行完再执行这个任务doLast{println("结束")}doFirst{println("开始")}
}

作用：

如何修改现有的task 任务的配置的呢？比如在现有的任务的基础上依赖我的任务呢

tasks.named("build"){      //执行指定你要修改任务的名字就行dependsOn("sujin")
}

如何自定义一个Task,其实 register方法有一个扩展函数支持传入一个泛行的

public inline fun <reified T : org.gradle.api.Task> org.gradle.api.tasks.TaskContainer.register(name: kotlin.String, noinline configuration: T.() -> kotlin.Unit): org.gradle.api.tasks.TaskProvider<T> { /* compiled code */ }

open class myTask: DefaultTask(){private var name = ""@TaskAction           //标记了这个就是在最后默认调用fun taskAction(){    println("执行了")}fun taskName(name: String){this.name = nameprintln("name=${name}")}}tasks.register<myTask>("haha"){taskName("苏金标")println("name=${}")}

其实gradle也给我们提供一个内置的Task类型给我们使用：

gradle的几大重要信息，首先是加在顺序

最开始是加载电脑中国的全局配置文件gradle.properties,这个是所有的项目都可以用的，这个默认是没有的，得自己放置进去 .gradle/gradle.properties

再加载项目中的gradle.properties -> setting.gradle (setting对象)-> 项目的build.gradle(rootproject和project ，发现这两个没什么区别) ->模块的 gradle.properties ->模块的 build.gradle（生成project对象）注意一点，配置信息的等级是 .gradle/gradle.properties > 模块的 >项目中的

gradle/gradle.properties等级是最高的，会覆盖其他的。

如何在build.gradle中读取配置信息呢？

goovy DSL

project.属性或者 project.findProperty("属性")

kotlin DSL

project.findProperty("属性")

gradle的生命周期钩子

Gradle Wrapper 的主要功能

gradle的一个配置流程

相关文章：