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

Question

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

error: package android.util does not exist

error: cannot find symbol ... symbol:class Context

error: package android.app does not exist

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 输出窗口中，复制第一个完整的命令行（生成文档）并将其粘贴到命令窗口中，将 @ 后面的内容替换为刚刚创建的文件文本的路径（其中其中包含类路径）。

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

埃姆兹