Android: Attaching Sources to Libraries in Eclipse

最新推荐文章于 2025-04-30 09:52:29 发布

benwdm

最新推荐文章于 2025-04-30 09:52:29 发布

阅读量154

点赞数

CC 4.0 BY-SA版权

分类专栏： T_java T_移动开发文章标签：开发工具移动开发

本文链接：https://blog.youkuaiyun.com/benwdm/article/details/84407623

T_java 同时被 2 个专栏收录

145 篇文章

订阅专栏

T_移动开发

53 篇文章

订阅专栏

在Eclipse ADT r20中，通过为每个库创建属性文件，可以方便地将源码附加到库文件。此方法解决了先前版本中无法直接附加源码的问题。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Since ADT r17, Android projects in Eclipse have had a nice property: all jars in your libs directory have been automatically picked up by Eclipse projects under a magic “Android Dependencies” entry in the build path. Ant builds use the same conventions, so adding a library is as simple as dropping it into the right directory. Unfortunately, though, this magic came with a major limitation: there was no way to attach sources to these libraries (see issue 27940). This led me to duplicate build path entries manually just to get source attachments.

Good news: in the just-released r20 version of ADT, Google have provided a solution to this problem. It’s not well advertised, but if you check out comment 21 on the aforementioned issue, you see that by creating a properties file for each library, you can tell ADT where to find the sources. So, for example, if you have a jar named:

some-library-1.0.jar

you can create a properties file alongside it named:

some-library-1.0.jar.properties

Within the properties file you can add a src property set to the relative (or absolute, but that’s version-control-unfriendly) path of the source jar, zip or directory. Say, like me, you put it in the libs/src subdirectory, your properties file might look like:

src=src/some-library-1.0-sources.jar

Once you’ve added the properties file, refresh the project in Eclipse and voilà: the sources will be attached! A similar property named doc is supported for javadoc attachments.

Although this new feature is very welcome, I feel like it could use a bit more fine tuning. The main issue is the need to create a separate properties file for each jar. I keep my source jars in predictable locations, with conventional names, so I should be able to configure the convention once and have everything Just Work from then on. Heck, I’m not sure why there isn’t a default convention, which I could just follow with no further configuration!

===============================================

注：

上文所说的路径有错，properties文件必须放在libs目录下才能生效，而不能放在libs/src目录下