Maven打包含Jitpack依赖的Javadoc报错,除上传Maven外有何解法?
可行解决方案
报错核心原因是maven-javadoc-plugin执行打包时,默认仅从Maven中央仓库拉取依赖构件信息,未匹配到Jitpack源的Dream-Yaml组件。除了上传依赖到中央仓库外,可选择以下适配方案:
方案1:排除无法拉取的非中央库依赖
不需要将Jitpack来源依赖的Javadoc打入公共库Javadoc包时,直接在插件配置中添加排除规则即可,配置示例如下:<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <version>3.6.3</version> <configuration> <includeDependencySources>true</includeDependencySources> <!-- 排除指定依赖,格式为groupId:artifactId --> <excludeDependencyNames>com.github.Osiris-Team:Dream-Yaml</excludeDependencyNames> </configuration> </plugin>如有多个需排除的依赖,用英文逗号分隔即可。
方案2:为Maven添加Jitpack仓库配置
需要将Jitpack来源依赖的Javadoc一同打包时,在公共库的pom.xml中添加Jitpack仓库配置,让Maven可以从Jitpack拉取对应构件信息,配置示例如下:<repositories> <repository> <id>jitpack.io</id> <url>https://jitpack.io</url> </repository> </repositories> <!-- 插件仓库也需要同步添加,否则插件拉取依赖时仍无法找到Jitpack源 --> <pluginRepositories> <pluginRepository> <id>jitpack.io</id> <url>https://jitpack.io</url> </pluginRepository> </pluginRepositories>配置完成后重新执行打包命令即可正常拉取Dream-Yaml的构件信息。
方案3:本地预存依赖构件
仅本地开发打包场景适用,可手动下载Dream-Yaml的pom、sources、javadoc包到本地Maven仓库对应的目录下,打包时Maven优先读取本地缓存,不会触发远程仓库查询。方案4:手动嵌入所需Javadoc资源
可提前下载好需要包含的第三方依赖Javadoc资源,通过maven-resources-plugin将资源文件复制到Javadoc打包的输出目录,无需通过插件自动拉取依赖生成,适合需要自定义Javadoc内容的场景。
内容的提问来源于stack exchange,提问作者Osiris Team
相关产品推荐
相关产品推荐

