未为 Android 项目生成 Javadoc

编程问答 2022-04-29

问题描述

我正在处理一个 Android 项目并尝试使用以下任务生成 javadoc，但它没有生成任何内容。

我已尝试将问题追溯到项目中的更改。检查过去的提交并尝试创建 javadoc 失败，即使在过去它有效。

对我来说，唯一可以解释这种行为的变化是升级到更新版本的 macOs Big Sur 并更新 Android Studio。

有人知道可能是什么问题吗？

设置：

  • macOS Big Sur 11.4 版

  • Android Studio 4.2.1

  • Gradle 6.5

      task("generate${variant.name.capitalize()}Javadoc",type: Javadoc) {
      if (JavaVersion.current().isJava8Compatible()) {
          options.addStringOption('Xdoclint:none','-quiet')
      }
      options.memberLevel = JavadocmemberLevel.PUBLIC
      failOnError = false
      source = variant.javaCompiler.source
      def androidJar = "${android.sdkDirectory}/platforms/${android.compileSdkVersion}/android.jar"
      doFirst {
          classpath = files(variant.javaCompile.classpath.files) + files(androidJar)
      }
      options {
          links "http://docs.oracle.com/javase/7/docs/api/"
          linksOffline "http://d.android.com/reference","${android.sdkDirectory}/docs/reference"
      }
  }

解决方法

经过长时间的搜索，我找到了答案：这是从 AS 4.1.3 到 4.2.x 的更新，Google 决定用它打包 Java11 而不是 8。 构建和编译是可能的，但无论出于何种原因，javadoc 生成都被破坏了。

androidandroidgradlegradlejavadocjavadoc