如何查看Android SDK中注释的javadoc?

发布于 2024-09-15 08:24:34 字数 701 浏览 8 评论 0原文

在“Android SDK,API 8 的文档”中,android.test.InstrumentationTestRunner 类的 javadoc 提到了“小型”、“中型”和“大型”测试的命令行选项,但没有解释如何将测试定义为这些测试尺寸。稍后在描述中会以注释 android.test.suitebuilder.annotation.LargeTest 链接的形式出现一条线索。

此后我注意到 Android 定义了 SDK javadoc 隐藏在视图之外的注释。例如,android.test.suitebuilder javadoc页面根本没有提到adroid.test.suitebuilder.annotation包。

我是否遗漏了一些关于如何使用 SDK 的基本假设?例如,How to get eclipse to show 的问题javax 注释的 javadoc 建议下载源代码并让 eclipse 从中生成(可能更完整)javadoc。 Android 开发人员是否已经从源代码查看 javadoc 太久了,以至于没有注意到 SDK 中不完整的 javadoc?

是的,我注意到一些源 javadoc 包含 @hide 标记,这可能会导致生成器忽略它。这似乎是故意的,这引起了我的疑问。

In "Documentation for Android SDK, API 8", the javadoc for class android.test.InstrumentationTestRunner mentions command-line options for "small", "medium", and "large" tests without explaining how one would define tests as being of those sizes. A clue arrives later in the description in the form of a link to the annotation android.test.suitebuilder.annotation.LargeTest.

I have since noticed that Android defines annotations that the SDK javadoc hides from view. For example, the android.test.suitebuilder javadoc page does not mention the adroid.test.suitebuilder.annotation package at all.

Am I missing some base assumption about how one should use the SDK? For example, the question at How to get eclipse to show javadoc for javax annotations suggests downloading the source and letting eclipse generate (presumably more complete) javadoc from it. Have Android developers been viewing javadoc from source for so long that they haven't noticed the incomplete javadoc in the SDK?

And yes, I've noticed that some of the source javadoc includes a @hide tag, which presumably causes the generator to ignore it. It appears deliberate, which begged my question.

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

评论(1

不乱于心 2024-09-22 08:24:34
  1. Android SDK 是一项正在进行中的 JavaDoc 工作,有时并不完整。幸运的是,我们可以在必要时直接查看开源代码。
  2. Stackoverflow 经常提供填补 JavaDoc 中空白的答案。

这似乎已经是最好的了。

  1. Android SDK is a work in progress with JavaDoc that is sometimes incomplete. Luckily we can look directly at the open source when necessary.
  2. Stackoverflow often has answers that fill the gaps in the JavaDoc.

That appears to be as good as it gets.

~没有更多了~
我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
原文