用于Eclipse的ADT r17插件的新版本增加了自动设置JAR依赖项的功能。/ libs文件夹中的所有.jar文件现在都已添加到构建配置中。不幸的是,Android Dependencies类路径容器是不可修改的。
如何将javadoc和源附加到自动插入的.jar(从/ libs文件夹)?
用于Eclipse的ADT r17插件的新版本增加了自动设置JAR依赖项的功能。/ libs文件夹中的所有.jar文件现在都已添加到构建配置中。不幸的是,Android Dependencies类路径容器是不可修改的。
如何将javadoc和源附加到自动插入的.jar(从/ libs文件夹)?
Answers:
回答问题的最佳方法是总结Xavier,plastiv,VinceFR和Christopher的答案。
为了将源代码和javadoc链接到Eclipse自动链接的.jar库,您必须执行以下操作:
.properties
在libs文件夹中创建一个文件(请参见示例)。确保保留.jar部分。.properties
文件中指定源的相对路径和javadoc .jar 。该示例使用Gson库。
libs
├── docs
│ └── gson-2.2.2-javadoc.jar
├── gson-2.2.2.jar
├── gson-2.2.2.jar.properties
└── src
└── gson-2.2.2-sources.jar
src=src/gson-2.2.2-sources.jar
doc=docs/gson-2.2.2-javadoc.jar
当然,您可以将javadoc和源.jar移到其他文件夹中并指定相对路径。随你(由你决定。可以将源jar和javadoc jar直接放置在lib文件夹中,但不建议这样做,因为这会使文档和源代码包含在您的应用程序中。
Eclipse JavaDoc面板的屏幕截图:
使用Gson和Android 4.2.2的Eclipse项目的屏幕截图:
如果您要引用的Javadocs不是打包提供的,.jar
而只是作为Android开发人员在注释中要求的文件和文件夹提供的,请执行以下操作:
.jar
放在libs/
文件夹中创建一个yourlibraryname.jar.properties
包含以下内容的文件(不要忘记了.jar
):
doc=docs
将javadocs文件夹添加到该libs/
文件夹。
您应该提出以下文件夹结构:
├── docs
│ ├── allclasses-frame.html
│ ├── allclasses-noframe.html
│ ├── com
│ │ └── google
│ │ └── ads
│ │ ├── Ad.html
│ │ │ ....
│ │ └── package-tree.html
│ │ ...
│ └── stylesheet.css
├── GoogleAdMobAdsSdk-6.4.1.jar
└── GoogleAdMobAdsSdk-6.4.1.jar.properties
别忘了如上所述关闭并重新打开 Eclipse项目!这是一个引用GoogleAdMobAds Android库的工作示例项目的屏幕截图。
在Windows上,必须对属性文件中的doc和src路径引用使用反斜杠进行转义。例如,对于android-support-v4.jar,属性文件的内容类似于:
doc=C:\\Program Files (x86)\\Android\\android-sdk\\extras\\android\\support\\v4\\docs
src=C:\\Program Files (x86)\\Android\\android-sdk\\extras\\android\\support\\v4\\src
答案来自http://code.google.com/p/android/issues/detail?id=27490#c21
在您的libs文件夹中,您必须具有:
doc(folder)
foo_doc(folder)
index.html
...
...
foo.jar
foo.jar.properties
在你的foo.jar.properties
,只是把doc=./doc/foo_doc
也许您将不得不刷新您的项目,清理它,关闭它并重新打开它。
这个对我有用!
我尝试了以上所有方法,但没有一个对我有用。我想出了一种永远有效的方法。基本上,罪魁祸首是ADT处理“ libs”文件夹的方式,因此我退出使用“ libs”文件夹。相反,我创建了一个“库”文件夹并使用了它。
您可以执行以下操作,并且该操作将始终有效-即使ADT将来应更改其更改“ libs”文件夹处理方式的方式也是如此:
通过执行上述过程,您的项目将具有如下所示的文件夹:
您的Java构建路径如下所示:
在订购和出口中,库被打勾:
在ADT 22上,我无法同时访问commons-io-2.4.jar和android-support-v4.jar的Javadoc
这是我修复它的方法:
前提:这两个库都在“参考库”下列出。
右键单击commons-io-2.4.jar,然后选择“属性”。出现此窗口:
commons-io-2.4.jar与commons-io-2.4-javadoc.jar捆绑在一起,因此我在归档外部文件路径中指定了Javadoc。
我对支持库做了同样的事情:右键单击android-support-v4.jar并选择Properties。出现此屏幕:
这次我指定了源目录的路径。
当我升级到SDK工具和ADT修订版17时,对commons-io-2.0.1.jar的库引用已损坏。
为了解决该问题,我使用了Project-> Properties-> Java Build Path,然后选择Libraries选项卡。我删除了对commons-io-2.0.1.jar的任何引用,然后使用Add Jar将commons-io-2.0.1.jar重新添加到项目中。然后,单击库名称旁边的“>”箭头以展开库引用,并使用编辑按钮设置“源”附件和Javadoc位置。
抱歉,我没有足够的代表,所以无法发布图片(请...)。
似乎是一个移动的目标,但是,在从许多地方收集了点点滴滴之后(包括对这个问题的回答,该问题帮助但未能描述所有必要的细节,或者系统在此期间略有变化),这似乎是解决方案,至少到目前为止(2013年8月28日)。
lib
文件夹内,xxx.jar.properties
为每个要与Javadoc关联的库添加一个文件。doc=d:\\Android\\javadoc\\libGoogleAnalyticsServices
未能遵守上述任何步骤(未解压缩javadoc,引用文件而不是文件夹等)似乎会破坏它。
只需更新ADT插件即可。对我有用!
希望有帮助!
对于任何给定的jar,如果希望在编码时看到工具提示上的Javadoc帮助,请执行以下操作:右键单击项目>属性> Java构建路径>库选项卡。单击罐子旁边的箭头以展开。
源附件应指向实际jar的位置(可能就在Java文件夹中)。
Javadoc位置:您在这里有两个选择:URL和存档。如果此jar的javadocs处于包含第一级index.html文件的文件夹的形式,请选择“ Javadoc URL”并指向该文件夹。如果您的javadocs在jar中,请选择“存档中的Javadoc”并指向jar。不要忘记重新启动工作区/关闭并重新打开项目,以使用Javadoc信息更新工具提示。
我希望这有助于对我认为应该非常简单的任务给出简单的答案。