在不使用maven的情况下应用本地jar-plugin

Question

我想从本地的jar加载我的自定义插件。jar文件编译良好，当我检查它时，清单和插件类就在那里。

gradlePlugin {
    plugins {
        create("asdf") { // <-- I really call it "asdf" in the kts script
            id = "asdf"
            implementationClass = "pluginTest.TestPlugin"
            version = "1.4.0"
        }
    }
}

这个插件还没有做任何有用的事情，因为它应该是一个概念验证，以确保它能够正常工作：

class TestPlugin : Plugin<Project> {
    override fun apply(project: Project) {
        println("Hallo TestPlugin!")
    }
}

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath(files("..\\..\\path\\to\\pluginTest.jar"))
    }
}

plugins {
    id("asdf") version "1.4.0"
}

在以下任何源中都找不到插件[ID:“asdf”,版本：“1.4.0”]:

我错过了什么？我使用Gradlev6.5。

Answer 1

当您在类路径上有插件jar时，您就不能在插件应用程序中有版本号。我想这是因为首先在类路径上不能有多个不同版本的JAR，所以在这里指定一个版本没有任何意义（可能除了验证您使用的是正确的版本之外）。这不会解决问题，但这是一个开始。

老实说，我不知道为什么你的方法还是行不通。buildscript块应该为该特定脚本设置依赖项，这应该使插件对它可见。不是因为某种原因。

也许这是一个bug，也许这只是对plugin{}块使用的一个未记录的限制。也许你可以在Gradle论坛上询问一下，或者为它制造一个问题。但是，也有不涉及发布到（本地）Maven存储库的变通方法，我同意这可能有点烦人。

// build.gradle (Groovy DSL)
buildscript {
    dependencies {
        classpath(files("..\\..\\path\\to\\pluginTest.jar"))
    }
}

apply from: "asdf"

或者，将buildscript插件从build.gradle文件移动到settings.gradle文件。这使得对整个构建类路径可用，并将使其与插件块一起工作：

// settings.gradle (Groovy DSL):
buildscript {
    dependencies {
        classpath(files("..\\..\\path\\to\\pluginTest.jar"))
    }
}

// build.gradle (Groovy DSL)
plugins {
    id("asdf")
}

最后，以防万一您还没有考虑过它，您可以将插件添加为一个复合构建。这将创建一个对插件的源依赖关系，并且具有这样的优点：可传递依赖关系将被转移（您放在插件自己的依赖关系块中的那些依赖关系），并且如果不是最新的，它将被自动构建。我使用这种方法来集成测试我的插件，有时也会将它们应用到我的其他实际项目中，在发布新版本之前在更大的环境中测试它们。

使用以下任一项执行此操作：

// settings.gradle (Groovy DSL):
includeBuild("..\\..\\path\\to\\plugin")

// build.gradle (Groovy DSL):
plugins {
    id("asdf")
}

或者不在构建中对其进行硬编码（这样您就可以在本地版本和发布版本之间动态切换）：

// build.gradle (Groovy DSL):
plugins {
    id("asdf") version "1.4.0" // Version is optional (will be ignored when the command line switch below)
}

// Run with:
./gradlew --include-build "..\\..\\path\\to\\plugin" build