java - Android - 无法使用 Android Studio Bumblebee 生成 Javadoc

Question

我正在尝试通过内置工具使用最新的 Android Studio 生成 Javadoc:工具=>生成 Javadoc...无论我从工具的参数窗口中选择什么，都会抛出很多错误，就我选择的范围而言，它的范围从 50 到 100 不等，并且所有错误都与 Android 操作系统或 Dalvik VM 相关。以下是其中一些:

错误:包 android.util 不存在

错误:找不到符号...符号:类上下文

错误:包 android.app 不存在

error: package dalvik.system does not exist

目标 Android SDK 是 31。安装了最新的 Java 版本。有人遇到过同样的问题吗？我究竟做错了什么？提前致谢。

Answer 1

首先，对不起我的英语(我使用谷歌翻译)。我刚刚花了 5 天的时间来解决这个错误，并找到了一个有效的解决方案(对我来说......)。

最新版本的 Android Studio(包括 Bumblebee)无法正确生成技术文档。这是正确生成它的过程。

在 Android Studio 中，打开项目。首先，识别所有 R 导入并将 R 替换为 *(例如:import com.example.coah.*)。首先遵循经典的 javadoc 生成过程:

• 工具 > 生成 JavaDoc
• 范围:模块
• 取消选中“在 -sourcepath 中包含 JDK 和库源”
• 输出目录:给出将接收文档的文件夹的路径(在项目文件夹之外预先创建此文件夹)
• 其他命令行参数:-encoding utf8 -docencoding utf8 -charset utf8

确定。通常文档生成失败并显示“退出代码 4”。在输出窗口的最顶部和最右侧(拖动水平滚动条)，单击“@C:\Users\xxx\AppData\Local\Temp\javadoc_args”:

您可以预览文件的内容。

复制内容并将其粘贴到文本文件中。打开文件。它以“-classpath”开头，后跟引号和文件路径列表。问题来自于这个列表中缺少 android.jar 文件，该文件通常位于:C:\Users\xxx\AppData\Local\Android\Sdk\platforms\android-32\android.jar检查用户文件夹中是否存在此文件(将 xxx 替换为用户名):它可能不是 android-32，而是 android-30 或其他。一旦找到正确的路径，就必须将其添加到类路径中的第一个位置，就在引号之后，并且不要忘记添加“;”最后将其与下一条路径分开。请注意，“”也必须替换为“/”。

保存文件。在管理模式下打开命令窗口，然后转到项目文件夹 src\app\main\java 文件夹。仍然在 Android Studio 的 javadoc 输出窗口中，复制第一个完整的命令行(生成文档)并将其粘贴到命令窗口中，将 @ 后面的内容替换为刚刚创建的文件文本的路径(其中其中包含类路径)。

可能存在错误和警告，但仍会生成文档。

Emds