Android App的JavaDoc在4个子帧中打开Android SDK Javadoc而不是1有没有办法解决这个问题?

时间:2011-12-03 00:16:18

标签: android javadoc

更新:我现在添加了截图,因为我不再被视为spambot。

显然我无法将截图发布为StackOverflow的“垃圾邮件防范机制”的一部分,因此您将不得不在描述中挣扎......

当您使用"-linkoffline http://java.sun.com/javase/6/docs/api/ http://java.sun.com/javase/6/docs/api/"生成JavaDoc时,它会生成很好的链接,只在右侧框架中打开类的描述 - 与单击指向您自己的类之一的链接相同的行为。

左框架中列出的所有 MY 类,右框架中所选类的详细信息(即java.lang.Object)

Linked with Sun's JavaDoc

当您使用"-linkoffline http://d.android.com/reference C:\Android\android-sdk\docs\reference"生成JavaDoc时,如果单击指向Object的链接,而不是仅在右侧框架中打开Object类,则会打开右侧框架内有4个子框架的页面。

左框架中列出的所有 MY 类,右框架中的4个子框架:Android开发人员标题(顶部),包列表(左上角),班级列表(左下角)和详细信息选定的类,即java.lang.Object(右)

Linked with Android JavaDoc

有没有办法将你的应用程序的JavaDoc链接到Android的SDK JavaDoc,这样它实际上看起来很漂亮,就像一个有凝聚力的JavaDoc?即是蓝色并具有标准的2帧接口(如Sun的JDK文档和默认的用户生成文档?

1 个答案:

答案 0 :(得分:0)

我认为这里的问题是看起来像Android引用的深层链接,比如http://developer.android.com/reference/android/content/res/XmlResourceParser.html(作为一个例子),实际上不仅仅是这个类的文档,而且实际上还包含什么看起来像不同的框架与其他包的链接。这些实际上是HTML源代码中的列表,它们使用一些CSS和JavaScript来设置样式,看起来像是单独的框架:

这是包列表的结尾和一个包中类的列表的开头:

 ...
 <a href="/reference/org/xml/sax/helpers/package-summary.html">org.xml.sax.helpers</a></li>
    <li class="api apilevel-1">
  <a href="/reference/org/xmlpull/v1/package-summary.html">org.xmlpull.v1</a></li>
    <li class="api apilevel-1">
  <a href="/reference/org/xmlpull/v1/sax2/package-summary.html">org.xmlpull.v1.sax2</a></li>
              </ul><br/>
            </div> <!-- end packages -->
          </div> <!-- end resize-packages -->
          <div id="classes-nav">
            <ul>

    <li><h2>Interfaces</h2>
      <ul>
          <li class="selected api apilevel-1"><a href="/reference/android/content/res/XmlResourceParser.html">XmlResourceParser</a></li>
      </ul>
    </li>

    <li><h2>Classes</h2>
      <ul>
          <li class="api apilevel-1"><a href="/reference/android/content/res/AssetFileDescriptor.html">AssetFileDescriptor</a></li>
          <li class="api apilevel-3"><a href="/reference/android/content/res/AssetFileDescriptor.AutoCloseInputStream.html">AssetFileDescriptor.AutoCloseInputStream</a></li>
 ...

实际上重要的部分是<div class="g-unit" id="doc-content">,它位于这些导航div之后。

所以我想你可以使用一些Javascript来隐藏所有其他div并且只显示这个。或者,或者,在顶部框架中显示这些链接而不是当前链接。

可能有一些Javadoc的修改版本产生类似(并兼容)Android参考的文档,但我不知道在哪里。