Gradle引入本地jwebassembly-gradle插件报错的解决办法

问题根源 #

你使用plugins { id 'jwebassembly-gradle' }的方式引入插件，但Gradle的plugins块默认只会从官方插件仓库、专属插件配置仓库查找插件。你虽然在buildscript里配置了flatDir仓库，但该配置无法被plugins块识别，导致插件找不到。

修复步骤 #

1. 精简buildscript依赖

buildscript的classpath只需要插件的核心执行jar，源码包和javadoc包不需要加入，先精简依赖：

buildscript {
    repositories {
        flatDir {
            dirs 'libs'
        }
    }
    dependencies {
        // 仅保留插件核心jar，移除sources和javadoc包
        classpath files('libs/jwebassembly-gradle-0.4.jar')
    }
}

2. 替换插件引入方式

移除plugins块中的id 'jwebassembly-gradle'，改用apply plugin方式引入本地插件：

plugins {
    id 'java'
    id 'application'
    // 删除该行：id 'jwebassembly-gradle'
}

// 在plugins块后添加插件引入语句
apply plugin: 'jwebassembly-gradle'

3. 修正普通dependencies块的错误

你在普通dependencies块中错误使用了classpath配置（这是buildscript专属配置项），如果项目不需要将插件jar作为业务依赖，直接删除这部分内容：

dependencies {
    // 删除以下错误配置
    // classpath fileTree(include: ['*.jar'], dir: 'libs')
    // classpath files('libs/jwebassembly-gradle-0.4.jar')
    // classpath files('libs/jwebassembly-gradle-0.4-sources.jar')
    // classpath files('libs/jwebassembly-gradle-0.4-javadoc.jar')

    // 保留你的业务依赖
    // other dependencies ..
}

核心修改后的build.gradle示例 #

// this handles the actual build script (build.gradle) dependencies!
buildscript {
    repositories {
        flatDir {
            // to use local builds
            dirs 'libs'
        }
    }
    dependencies {
        classpath files('libs/jwebassembly-gradle-0.4.jar')
    }
}

plugins {
    id 'java'
    id 'application'
}

// 引入本地插件
apply plugin: 'jwebassembly-gradle'

repositories {
    flatDir {
        // to use local builds
        dirs 'libs'
    }
    mavenCentral()
}

// 其余配置保持不变...

额外说明 #

• 源码包和javadoc包仅用于IDE查看源码和文档，无需加入buildscript或业务依赖，可直接在IDE中添加为附件使用。
• 如果后续想继续用plugins块引入，可将编译好的插件安装到本地Maven仓库（比如通过maven-publish插件发布到~/.m2/repository），再在plugins块中配置mavenLocal()作为插件仓库。

内容的提问来源于stack exchange，提问作者Joe McCay