我能够在我的
Android项目中记录几乎所有内容,并为他们生成漂亮的API参考.
例如,res / values / attrs.xml的一部分：
@H_404_6@<resources> <declare-styleable name="TimelineView"> <attr name="drawCollapsed" format="boolean" /> </declare-styleable> </resources>我注意到在Android的源码,standard attributes documentation is generated for R.
解决方法
我不知道这是一个官方的标准,但是在写我的问题时我偶然发现.我决定发布问题,无论如何,为了可能遇到这个问题的其他人的缘故.
我能够通过在属性上面添加一个XML注释来生成属性文档,现在我已经看到了这一点.
我最初没有重建我的项目,这导致原来缺乏文档.一旦我重建了该模块并生成了JavaDoc,就得到了所需的结果.
要遵循的步骤是：
>将注释置于所需属性之上.
@H_404_6@<resources> <declare-styleable name="TimelineView"> <!-- Initially draw collapsed until adapters have been set. --> <attr name="drawCollapsed" format="boolean" /> </declare-styleable> </resources>>重建相关模块/项目.
>生成JavaDoc.使用Android Studio(目前为0.5.8).
目前有small issue与自动生成,我正在使用解决方法介绍在第一个链接的帖子.
生成的文档应包含您的意见.
如果有人知道这个或官方方法的任何官方来源,请不要犹豫,分享.
更新：
看来这确实是在Android source files中完成的,包括一些JavaDoc指令,HTML和子注释在注释中,例如：
