Android 上的 Javadoc (Eclipse)
我正在尝试在 Eclipse 中为我的 Android 项目生成 Javadoc html 页面。我尝试使用 -linkoffline
参数,如 此处建议,以及使用指向我的 android.jar 文件的 -classpath
参数。这些都不起作用,因为我仍然收到 package android.app does not exit
(和其他)警告。我还尝试从命令行运行 javadoc 工具,而不是使用 Eclipse。
理想情况下,我希望为我的类生成自己的页面,所有 android.* 和 java.* 类都链接到在线页面。我使用的是 Mac OS 10.6 和 Java 版本 1.6.0_20。
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论
评论(2)
在尝试自己解决类似问题时,我发现的两个要点是:
将要链接到的 android.jar 文件包含在 android.jar 的 classpath 属性中>javadoc Ant 任务。这意味着类似以下内容:
<前><代码>
在 javadoc 任务下添加链接子项,以便将在线 Android 参考 URL 与 Android 参考包列表的本地副本相匹配>。这意味着类似以下内容:
这对于我来说足以在我的项目 Javadoc 中显示 Android 链接。
While trying to resolve a similar issue myself, the two main points I've found have been:
To include the android.jar file you're linking to within the classpath attribute of the javadoc Ant task. That means something like the following:
To add a link subitem under javadoc task in order to match the online Android Reference URL with a local copy of Android Reference package-list. That means something like the following:
This was enough for me in order to show Android links within my project Javadoc.
您是否尝试过使用 ant 脚本来处理 javadoc?将其命名为 javadoc.xml 或 build.xml 以外的其他名称 - 否则 Eclipse 会将其选为默认构建脚本。从 eclipse 内部运行 ant 脚本(
RMB on file | Run As | Ant Build
),或从控制台运行:ant -f
。我的看起来与此类似:
Have you tried using an ant script for the javadocs? Name it javadoc.xml or something other than build.xml - else eclipse will pick it up as the default build script. Run the ant script either from inside eclipse (
RMB on file | Run As | Ant Build
), or from the console:ant -f <file-name.xml>
.Mine looks something similar to this: