[Gradle] 编译任意位置的文件

我正在参加「启航计划」

自己一切文件禁止任何形式的转载

gradle 对于参与编译的文件的方位没有约束，不用发布到maven repository 或许编译成aar、jar。

SourceSet（增加代码）

在没有特殊处理的场景下，会经过咱们增加的插件辨认默认的sourceSet。

咱们创建一个全新的kotlin 项目，查看他的sourceSet。

//build.gradle.kts
kotlin.sourceSets.forEach {
    println(it.name)
}

输出内容

> Configure project :

main

/Users/storytellerF/IdeaProjects/test/src/main/kotlin

/Users/storytellerF/IdeaProjects/test/src/main/java

test

/Users/storytellerF/IdeaProjects/test/src/test/kotlin

/Users/storytellerF/IdeaProjects/test/src/test/java

此办法用于导入annotation processor，kotlin symbols processor 生成的代码。从前也用来复用gradle plugin 的代码，代码要放到buildSrc 用于调试，可是buildSrc 不能将gradle plugin 发布出去，所以还需要另一个module 用于发布，就将buildSrc 中的代码导入到了module 中，这种办法还导致一个警告⚠️，不过现在有了更好的办法， 后边会讲。

include （增加模块）

一般来说咱们增加一个module，会在settings.gradle 中增加这个module

include 'module'

增加的module 默认目录就是当前项目的根目录，不过咱们可以覆盖掉指定一个新的途径，这个途径几乎可以是任意方位。

// include two projects, 'foo' and 'foo:bar'
// directories are inferred by replacing ':' with '/'
include 'foo:bar'
// include one project whose project dir does not match the logical project path
include 'baz'
project(':baz').projectDir = file('foo/baz')
// include many projects whose project dirs do not match the logical project paths
file('subprojects').eachDir { dir ->
    include dir.name
    project(":${dir.name}").projectDir = dir
}

我一般用这个办法导入本地项目或许submodule 的代码。本地项目没有发布，还有很多问题，发布出去在导入调试起来非常不方便。或许是submodule，自身就不希望发布成一个库，用这种方法非常适合。而且settings.gradle.kts或许settings.gradle 应该是图灵齐备的，支持条件判断，循环，读取外部数据。比如这样：

def baoFolder = ext.baoFolder
def home = System.getProperty("user.home")
def debugBaoFolder
if (baoFolder == "local")
    debugBaoFolder = file("$home/AndroidStudioProjects/Bao/")
else
    debugBaoFolder = null
if (debugBaoFolder != null && debugBaoFolder.exists()) {
    def l = new String[]{
            "startup", "bao-library"
    }
    for (sub in l) {
        include("bao:$sub")
        project(":bao:$sub").projectDir = file("${debugBaoFolder.absolutePath}/$sub")
    }
}

Bao 是一个用于兜底thread exception的。经过上面的代码，就可以经过gradle.properties 决定是导入maven 还是导入本地代码。

includeBuild （增加项目）

构建次序早已其他模块，本质是另一个项目，可以文件体系中任意的方位。

可以经过设置gradle 的方法引进gradle。

pluginManagement {
    includeBuild("../../common-ui-list/version-manager")
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}

上面的includeBuild 传入的参数是相对途径，相同的途径也被导入到了另一个项目，然后在当前项目（不是上述的version-manager）中当作一个gradle plugin引进。

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("kotlin-parcelize")
    id("androidx.navigation.safeargs.kotlin")
    id("com.storyteller_f.version_manager")
}

和你猜想的一样，经过includeBuild 引进的项目只能在build.gradle 中运用。假如想要经过implementation 引进，需要知道这个插件的classpath，上面咱们指定的com.storyteller_f.version_manager 其实是这个插件的pluginId。我现在还不知道应该怎么获取这个classpath。