android - Dokka 失败：com.intellij.psi.impl.source.PsiClassImpl 无法转换为 com.intellij.psi.PsiJavaFile

Question

我有一个生成 Android 人工制品（主要.aar是dokka.

随着最近的一些更改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存在一些问题。

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

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

1. 为注解类的实现切换到 Kotlin，然后在文件的根范围（而不是作为类的内部项）定义注解类。

2. 在 Dokka 的配置中抑制注解的包，即 -

dokka {
  ...

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

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