android的gradle

资料：

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

Gradle User Manual    gradle官网

讲的挺好的博客

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

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 的主要功能

1. 统一 Gradle 版本：

   • Gradle Wrapper 可以确保所有开发者使用项目指定的 Gradle 版本，避免版本不一致导致的问题。
   • Wrapper 会根据 gradle/wrapper/gradle-wrapper.properties 中配置的版本自动下载所需的 Gradle。

2. 自动下载 Gradle：

   • 如果本地没有所需的 Gradle 版本，Wrapper 会自动从官方仓库下载指定版本的 Gradle。
   • 下载的 Gradle 存储在本地缓存目录（默认在 ~/.gradle/wrapper/dists）。

3. 无需手动安装 Gradle：

   • 开发者无需手动安装 Gradle，只需运行项目中的 Wrapper 脚本即可。

4. 跨平台支持：

   • 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_ACCOUNT
        password = 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 = name
        println("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,这个Task是针对所有模块的