android - Dokka错误:com.intellij.psi.impl.source.PsiClassImpl无法转换为com.intellij.psi.PsiJavaFile

Question

我有一个生成Android人工制品(主要是.aar)并将其 bundle 在dokka生成的文档(代码库为Kotlin + Java)中的构建。

随着最近的一些更改，dokka开始因此神秘错误而失败:

> Task :mylib:dokka FAILED

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':mylib:dokka'.
> com.intellij.psi.impl.source.PsiClassImpl cannot be cast to com.intellij.psi.PsiJavaFile

任何帮助，将不胜感激。我目前似乎无法追踪到这个来源。

Answer 1

我无法指出问题的根源，但是我可以肯定地说Dokka与annotation classes有关。

在我的更改中，我最初在用Java编写的抽象类(以及相关的辅助方法)内引入了一个基于Android的 @IntDef 的新注释类。

这两个步骤似乎有所帮助:

切换到Kotlin进行注释类的实现，然后在文件的根范围(而不是作为类的内部项目)中定义注释类。

禁止在Dokka的配置中添加注释包，即-

dokka {
  ...

  packageOptions {
    prefix = "com.mylib.myannotation"
    suppress = true
  }
}

最终结果是文档无法引用带注释的类(这并不奇怪，因为它被取消了)，但是javadoc生成完全成功。