忽略依赖项中的Javadoc错误

编程问答 2022-06-05

问题描述

我有一个Java project用Gradle构建的（这是minecraft Forge mod）。它依赖于另一个名为HWYLA的项目，该项目具有一个包含已编译类及其源代码的API JAR。不幸的是，此代码中似乎存在一些Javadoc错误，这阻止了我自己的代码生成Javadoc。

Gradle输出看起来像这样（来自this CI运行）：

> Task :processResources
> Task :classes
> Task :makeLibraryMetas UP-TO-DATE
> Task :jar
> Task :downloadMcpConfig
> Task :extractSrg
> Task :createMcpToSrg
> Task :reobfJar
/home/runner/.gradle/caches/forge_gradle/deobf_dependencies/mcp/mobius/waila/Hwyla/1.10.11-B78_1.16.2_mapped_snapshot_20200916-1.16.2/Hwyla-1.10.11-B78_1.16.2_mapped_snapshot_20200916-1.16.2-api.jar(mcp/mobius/waila/api/IComponentProvider.java):56: error: invalid end tag: </br>

     * Callback used to add lines to one of the three sections of the tooltip (Head,Body,Tail).</br>
                                                                                                 ^
/home/runner/.gradle/caches/forge_gradle/deobf_dependencies/mcp/mobius/waila/Hwyla/1.10.11-B78_1.16.2_mapped_snapshot_20200916-1.16.2/Hwyla-1.10.11-B78_1.16.2_mapped_snapshot_20200916-1.16.2-api.jar(mcp/mobius/waila/api/IComponentProvider.java):57: error: invalid end tag: </br>
     * Will only be called if the implementing class is registered via {@link IRegistrar#registerComponentProvider(IComponentProvider,TooltipPosition,Class)}.</br>
> Task :javadoc
                                                                                                                                                                ^
/home/runner/.gradle/caches/forge_gradle/deobf_dependencies/mcp/mobius/waila/Hwyla/1.10.11-B78_1.16.2_mapped_snapshot_20200916-1.16.2/Hwyla-1.10.11-B78_1.16.2_mapped_snapshot_20200916-1.16.2-api.jar(mcp/mobius/waila/api/IComponentProvider.java):58: error: invalid end tag: </br>
     * You are supposed to always return the modified input tooltip.</br>
                                                                    ^
/home/runner/.gradle/caches/forge_gradle/deobf_dependencies/mcp/mobius/waila/Hwyla/1.10.11-B78_1.16.2_mapped_snapshot_20200916-1.16.2/Hwyla-1.10.11-B78_1.16.2_mapped_snapshot_20200916-1.16.2-api.jar(mcp/mobius/waila/api/RenderableTextComponent.java):5: error: package mcp.mobius.waila.api.impl does not exist
import mcp.mobius.waila.api.impl.WailaRegistrar;
                                ^
4 errors

> Task :javadoc Failed

FAILURE: Build Failed with an exception.

* What went wrong:
Execution Failed for task ':javadoc'.
> Javadoc generation Failed. Generated Javadoc options file (useful for troubleshooting): '/home/runner/work/TestMod3/TestMod3/build/tmp/javadoc/javadoc.options'

如何告诉Gradle / Javadoc忽略这些错误，而只为自己的代码生成文档？我可能可以关闭doclint，但我宁愿避免这样做。

我尝试检查tasks.javadoc.source属性，并在任务中添加排除过滤器；但是这些仅包含我自己的代码的路径，而不包含HWYLA JAR或源文件的路径。

解决方法

暂无找到可以解决该程序问题的有效方法，小编努力寻找整理中！

如果你已经找到好的解决方法，欢迎将解决方案带上本链接一起发送给小编。

小编邮箱:dio#foxmail.com (将#修改为@）

gradlegradlejavajavajavadocjavadocminecraftminecraft-forge