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

问题描述 投票:0回答:3

我正在尝试通过内置工具使用最新的 Android Studio 生成 Javadoc: 工具=>生成 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 版本。有人遇到过同样的问题吗?我究竟做错了什么? 预先感谢。

java android javadoc dalvik
3个回答
5
投票

首先,抱歉我的英语(我使用谷歌翻译)。 我刚刚花了 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 ndroid-32 ndroid.jar 检查用户文件夹中是否存在此文件(将 xxx 替换为用户名):它可能不是 android-32,而是 android-30 或其他。一旦找到正确的路径,必须将其添加到类路径中的第一个位置,就在引号之后,并且不要忘记添加“;”最后将其与下一条路径分开。请注意,“”也必须替换为“/”。

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

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

Emds


0
投票

Emds 解决方案在这里帮了很大的忙,使用它我们可以更轻松地解决这个问题。

正如他们所说,主要问题是 android.jar 文件未以某种方式包含在类路径中。因此,为了解决这个问题,我们可以简单地复制 android.jar 的路径(也带有名称),然后在项目中为其生成依赖项。

  • 为此,请转到文件 -> 项目结构 -> 依赖项

  • 单击“所有依赖项”部分中的+号,然后选择“Jar/AAR 依赖项”。

  • 然后为模块选择“app”,并在下一个屏幕中输入 android.jar 路径(您之前复制的路径),然后单击“确定”。

  • 再次构建gradle并生成Javadoc。应该可以解决问题。


0
投票

我在这里回答了我自己的问题无法在最新的 Android Studio Giraffe 中生成 Android Javadoc 文档

它是否可以帮助您或其他正在寻找答案的人

© www.soinside.com 2019 - 2024. All rights reserved.