Composing builds

参考地址

一、啥是 Composing builds ？？

https://docs.gradle.org/current/userguide/composite_builds.html

摘自 Gradle 文档：

复合构建只是包含其他构建的构建.

在许多方面，复合构建类似于 Gradle 多项目构建，不同之处在于，它包括完整的 builds ，而不是包含单个 projects

组合通常独立开发的构建，例如，在应用程序使用的库中尝试错误修复时
将大型的多项目构建分解为更小，更孤立的块，可以根据需要独立或一起工作

使用这种方式的优点有：

支持单向跟踪
自动补全
依赖更新时，不会重新构建整个项目

二、使用

环境：

Android Studio Chipmunk | 2021.2.1 Patch 2

Build #AI-212.5712.43.2112.8815526, built on July 10, 2022

Runtime version: 11.0.12+7-b1504.28-7817840 amd64

插件Moudle全部代码结构如下：

在这里插入图片描述

简洁一下：

.gradle
是系统编译出来的；
libs
啥也没，可以删
Config
写依赖的位置
VersionPlugin
实现插件接口
.gitignore
啥也没，可以删
build.gradle
需要配置插件
setting.gradle
空实现，Moudle需要此文件

1、于项目中新建 Moudle，取名 VersionPlugin

在这里插入图片描述

2、重写 VersionPlugin 的 build.gradle (区分Moudle语言)

原gradle内的内容，全部删除

有两种写法，对应上面的语言，如果你使用的是

Java ，配置 build.gradle 如下：


apply plugin: 'java-gradle-plugin'

buildscript {
    repositories {
        google()
        maven { url 'https://jitpack.io' }
        maven { url 'https://maven.aliyun.com/nexus/content/groups/public/' }
        maven { url 'https://maven.aliyun.com/nexus/content/repositories/jcenter' }
        gradlePluginPortal()
        mavenCentral()
    }
}

repositories {
    google()
    maven { url 'https://jitpack.io' }
    maven {url 'https://maven.aliyun.com/nexus/content/repositories/releases/'}
    maven { url 'https://maven.aliyun.com/nexus/content/groups/public/' }
    maven { url 'https://maven.aliyun.com/nexus/content/repositories/jcenter' }
    mavenCentral()
}

dependencies {
    implementation gradleApi()
}

gradlePlugin {
    plugins {
        version {
            id = 'com.yoshin.versionplugin'
            implementationClass = 'com.yoshin.versionplugin.VersionPlugin'
        }
    }
}

Kotlin，配置 build.gradle 如下：

apply plugin: 'kotlin'
apply plugin: 'java-gradle-plugin'

buildscript {
    repositories {
        google()
        maven { url 'https://jitpack.io' }
        maven { url 'https://maven.aliyun.com/nexus/content/groups/public/' }
        maven { url 'https://maven.aliyun.com/nexus/content/repositories/jcenter' }
        gradlePluginPortal()
        mavenCentral()
    }

    dependencies {
        // 因为使用的 Kotlin 需要需要添加 Kotlin 插件,需要和主工程对应，不然就出现两个版本了
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.7.10"
    }

}

repositories {
    google()
    maven { url 'https://jitpack.io' }
    maven {url 'https://maven.aliyun.com/nexus/content/repositories/releases/'}
    maven { url 'https://maven.aliyun.com/nexus/content/groups/public/' }
    maven { url 'https://maven.aliyun.com/nexus/content/repositories/jcenter' }
    mavenCentral()
}

dependencies {
    implementation gradleApi()
    implementation "org.jetbrains.kotlin:kotlin-gradle-plugin:1.7.10"
}

compileKotlin {
    kotlinOptions {
        jvmTarget = "1.8"
    }
}

compileTestKotlin {
    kotlinOptions {
        jvmTarget = "1.8"
    }
}

gradlePlugin {
    plugins {
        version {
            // 在 app 模块需要通过 id 引用这个插件
            id = 'com.yoshin.version'
            // 实现这个插件的类的路径
            implementationClass = 'com.yoshin.version.VersionPlugin'
        }
    }
}

3、需要在Moudle下添加setting.gradle文件

空文件即可，啥也不用写

4、修改项目的setting.gradle文件

....

    }
}
rootProject.name = "DemoComposingBuilds"
include ':app'
includeBuild('VersionPlugin')

添加：

includeBuild('VersionPlugin')

添加完这个，可以编译了。

5、实现VersionPlugin

import org.gradle.api.Plugin;
import org.gradle.api.Project;

public class VersionPlugin implements Plugin<Project> {

    @Override
    public void apply(Project project) {

    }
}

6、配置项目依赖和版本号 ==

public class Config {

    public static  String cardview = "androidx.cardview:cardview:1.0.0";
    public static  String  material = "com.google.android.material:material:1.4.0";

}

7、使用插件引用依赖

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
    //下面这行必须有，引用插件框架
    id "com.yoshin.versionplugin" 
}

//下面这行必须有，为了添加包下的类
import com.yoshin.versionplugin.* 

android {
	... 略
}

dependencies {

	... 略
	
	//下面这行是引用依赖
    implementation Config.material

}

注意：第二步使用的是Kotlin的时候，出现了在工程中引用 Config类引用不到的场景，还没找到原因。硬写也好使。整明白再更。

三、遇见的异常

1、引用不到类

详细记录上述问题：在使用Kotlin编写Plugin时发生，目前尚未解决

添加了代码：
id “com.yoshin.versionplugin”
和
import com.yoshin.versionplugin.*
后可以编译通过，但是
import com.yoshin.versionplugin.Config
这个就引用不到了，报红。

但是，
implementation Config.material
硬写也好用

2、kotlin-gradle-plugin 插件冲突

注意，插件中的build.gradle文件中的 kotlin-gradle-plugin 版本要和主工程对应。

如插件中的build.gradle:

"org.jetbrains.kotlin:kotlin-gradle-plugin:1.7.10"

项目中：

plugins {
    id 'com.android.application' version '7.2.2' apply false
    id 'com.android.library' version '7.2.2' apply false
    id 'org.jetbrains.kotlin.android' version '1.7.10' apply false
    id 'org.jetbrains.kotlin.jvm' version '1.7.10' apply false
}

参考地址

Android Studio统一依赖管理Composing builds：

https://blog.csdn.net/Json_Jerry/article/details/112860914

原文链接：https://blog.csdn.net/weixin_35691921/article/details/126381834