为何org.apache.xmlgraphics:batik:1.16依赖未在Gradle项目中下载？

原因 #

org.apache.xmlgraphics:batik:1.16 是一个POM聚合模块，它本身不包含可执行的class文件，仅用于统一管理Batik生态下的各个子模块依赖。直接添加该聚合模块依赖时，Gradle不会自动引入任何实际的功能jar包。

解决方法 #

你需要根据项目需求，明确引入Batik的具体子模块：

方式1：直接指定所需子模块 #

如果只需要核心的SVG解析、渲染功能，可以添加以下依赖（按需选择）：

dependencies {
    // SVG DOM处理
    implementation 'org.apache.xmlgraphics:batik-svg-dom:1.16'
    // SVG解析器
    implementation 'org.apache.xmlgraphics:batik-parser:1.16'
    // SVG转图片工具
    implementation 'org.apache.xmlgraphics:batik-rasterizer:1.16'
    // 其他子模块如batik-anim、batik-codec等按需添加
}

方式2：通过BOM统一管理版本 #

如果需要引入多个Batik子模块，可先引入BOM来统一版本，再添加子模块：

dependencies {
    // 引入Batik BOM，统一管理所有子模块版本
    implementation platform('org.apache.xmlgraphics:batik:1.16')
    // 按需添加子模块，无需再写版本号
    implementation 'org.apache.xmlgraphics:batik-svg-dom'
    implementation 'org.apache.xmlgraphics:batik-parser'
    implementation 'org.apache.xmlgraphics:batik-rasterizer'
}

额外排查步骤 #

若添加子模块后仍有问题，可执行Gradle命令强制刷新依赖缓存：

./gradlew clean build --refresh-dependencies

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