如何查看Android SDK中注释的javadoc?
在“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 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论
评论(1)
这似乎已经是最好的了。
That appears to be as good as it gets.