Allow src/doc attachement for 3rd party jars in libs/

Since those jars are added dynamically through a classpath
container, the devs cannot set the source path and the javadoc
through Eclipse UI (container don't allow editing those).
To fix this, and to make sure that both paths are picked up
not only by the current project, but also by other projects
(if the current project is a library project), the value is
set by a file sitting next to the jar file.
The file is name after the jar file, adding .properties at the
end. For instance
foo.jar -> foo.jar.properties
It can currently contain 2 properties:
src: relative or absolute path to the source folder (or archive).
doc: relative or absolute path to the javadoc.

[Example]
for Joda-Time 2.1:
cd $PROJECT/libs
touch joda-time-2.1.jar.properties

And insert the following, making sure the path is correct:
src=/Users/josh.oneal/SDKs/joda-time-2.1/joda-time-2.1-sources.jar
doc=/Users/josh.oneal/SDKs/joda-time-2.1/joda-time-2.1-javadoc.jar

You can now right click your project in Eclipse and refresh, then Command / Ctrl + Click a class such asDateTime to view its source.

[Reference]
https://android-review.googlesource.com/#/c/35702/

http://stackoverflow.com/questions/10075453/the-jar-of-this-class-file-belongs-to-container-android-dependencies-which-doe
posted @ 2013-06-18 16:17  CY.  阅读(222)  评论(0编辑  收藏  举报