本文探讨了在gradle多模块项目中构建和消费自定义插件时遇到的“插件未找到”问题及其解决方案。核心在于利用gradle的复合构建（composite builds）功能，通过在根项目的`settings.gradle.kts`中使用`includebuild()`指令，并为插件模块提供独立的`settings.gradle.kts`文件，确保插件在被其他模块消费前得到正确构建和解析。这使得插件能够无缝集成到同一项目结构中，简化了开发工作流。
在大型多模块项目中，为了统一和简化特定模块的构建配置，开发自定义Gradle插件是一种常见且高效的实践。例如，一个库可能需要针对其依赖项目配置特定的测试套件，此时一个自定义插件就能自动化这些配置。然而，当尝试在同一个多模块项目内部构建并消费这个插件时，开发者可能会遇到“插件未找到”的问题。
通常，一个Gradle多模块项目的结构可能如下所示：
+ root
+ my-api/ // 接口模块
+ my-implementation/ // 实现模块，依赖my-api并尝试消费自定义插件
+ my-gradle-plugin/ // 自定义Gradle插件模块
+ build.gradle.kts
+ build.gradle.kts // 根项目构建脚本
+ settings.gradle.kts // 根项目设置脚本
+ gradle.properties其中，my-gradle-plugin模块负责定义和实现自定义插件。其build.gradle.kts可能包含如下配置：
// my-gradle-plugin/build.gradle.kts
plugins {
`java-gradle-plugin`
`maven-publish`
}
gradlePlugin {
plugins {
create("org.my.gradle.plugin") {
id = "org.my.gradle.plugin"
group = "org.my.gradle.plugin"
implementationClass = "org.my.gradle.plugin.MyGradlePlugin"
version = project.version
}
}
}当my-implementation模块尝试通过plugins { id("org.my.gradle.plugin") version "internal" }来应用这个插件时，Gradle可能会报告以下错误：
* What went wrong:
Plugin [id: 'org.my.gradle.plugin', version: '0.0.3-SNAPSHOT'] was not found in any of the following sources:
- Gradle Core Plugins (plugin is not in 'org.gradle' namespace)
- Plugin Repositories (could not resolve plugin artifact 'org.my.gradle.plugin:org.my.gradle.plugin.gradle.plugin:0.0.3-SNAPSHOT')
Searched in the following repositories:
MavenLocal(...)
maven(...)
Gradle Central Plugin Repository
MavenRepo这个错误表明Gradle在解析my-implementation模块时，无法在配置的插件仓库中找到org.my.gradle.plugin。问题在于，Gradle默认并不知道my-gradle-plugin模块需要先被构建成一个可用的插件，才能在同一个构建过程中被其他模块消费。它会将插件视为外部依赖，尝试从远程或本地Maven仓库中查找。
解决这个问题的关键在于利用Gradle的复合构建（Composite Builds）功能。复合构建允许将多个独立的Gradle构建（包括插件项目）组合成一个单一的构建。这样，主构建就可以在本地解析和使用“包含”的构建所提供的插件或项目。
具体步骤如下：
为插件模块创建独立的settings.gradle.kts: 在my-gradle-plugin模块的根目录下创建一个空的settings.gradle.kts文件。这个文件将把my-gradle-plugin标记为一个独立的Gradle构建，使其能够被主项目作为复合构建的一部分来“包含”。即使是空文件，它的存在也是必要的。
+ root
+ my-gradle-plugin/
+ build.gradle.kts
+ settings.gradle.kts // 新增文件在根项目的settings.gradle.kts中声明includeBuild(): 在主项目的settings.gradle.kts中，使用includeBuild()指令将my-gradle-plugin模块作为复合构建包含进来。这会告诉Gradle，在构建主项目之前，需要先构建my-gradle-plugin。
// ./root/settings.gradle.kts
rootProject.name = "root-project"
// 包含其他子模块
include("my-api", "my-implementation")
// 关键：将插件模块作为复合构建包含进来
pluginManagement {
includeBuild("my-gradle-plugin") // 指向插件模块的路径
repositories {
mavenLocal()
maven { url = uri("https://xyz") } // 你的私有仓库
gradlePluginPortal()
mavenCentral()
}
resolutionStrategy {
val version: String by settings
eachPlugin {
// 确保自定义插件使用根项目定义的版本
if (requested.id.id == "org.my.gradle.plugin") {
useVersion(version)
}
}
}
}消费插件: 完成上述配置后，my-implementation模块就可以像消费任何其他插件一样，直接应用自定义插件了。
// my-implementation/build.gradle.kts
plugins {
id("org.my.gradle.plugin") version "internal" // "internal" 或具体的版本号，取决于resolutionStrategy
}这里使用"internal"作为版本号，是因为pluginManagement中的resolutionStrategy会强制使用根项目定义的版本。如果你的resolutionStrategy配置不同，你可能需要指定实际的版本号。
通过采用复合构建和includeBuild()机制，开发者可以在一个统一的多模块项目中无缝地构建和消费自定义Gradle插件，极大地简化了开发和维护工作流，提升了项目的模块化和可配置性。
以上就是在Gradle多模块项目中构建与消费自定义插件的指南的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
广告Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
459
收藏
