我一直在使用 JDK 11的JavaDocs 但是我注意到iFrames视图似乎不再可用。我搜索了一下,但没有找到关于这个问题为何被处理以及是否有其他的替代方案的任何细节。能否有人提供更多详细信息? JDK 10的视图 JDK 11的视图
如果其他人有同样的问题,框架已不再是默认生成的。这在JDK-8202961中有所涵盖。过去为了允许在API文档中进行导航,标准文档生成器会在窗口的左侧使用框架索引,以便选择要在窗口主体中显示的类、包和(最近)模块。最近,该文档生成器现在支持“搜索”功能,提供了一种更灵活的查找项目的方式。另外,文档生成器正在向仅使用HTML 5迁移,并且HTML 5对框架的基本支持不及HTML 4。以及JDK-8187794等等将javadoc/doclet更新为默认不生成框架,如果指定“—frames”选项来生成框架,则应生成警告。在将来的版本中,将删除对框架的支持。看起来,如果您真的想使用框架,可以从JDK src中生成自己的框架并体验警告,但这将在某个时候完全删除。总之,熟悉搜索功能,因为框架式的javadoc即将退出历史舞台!
我创建了 JANITOR – Java API Navigation Is The Only Rescue 工具,它可以在Java 11+的Javadoc页面中插入一个模块、包和类型(接口、类、枚举、异常、错误、注释)的导航树。
如果您喜欢Java 10和之前的API文档布局,包含HTML iframe,则可以查看https://github.com/climber09/Javadoc-Frames-Generator。这是一个正在进行的工作,因此我欢迎任何反馈。