eclipse给引用的jar包添加源码包

简介

我们在使用第三方开源的 jar 包时，大部分都会提供对应的 source 包。但我们大部分时候是没有去使用这个 source 包的。why？因为我们只需要用到 jar 包中的 api 呀，不需要知道其实现。but 作为一个合格的开发人员，不能只停留在使用别人 api 的层面上呀。如果遇到一些陌生的api，不知道其用法怎么办？利用各大搜索引擎去找资料，如果遇上这个 api 通用性比较高还好，如果是一个生冷偏僻的 api 怎么办？瞎猜？No,Read The Fucking Source Code. 才是解决问题的关键。那要怎么看源码呢？我们直接引用的 jar 是看不到源码的，所以我们需要导入其相关的source包。一般正规的jar都会有一一对应的jar和source包。如果没有source包的话，那就没办法了。

应用

本文主要讲解的就是给 jar 包添加对应的 source 包，方便查看其源码实现。

第一步：下载对应的 jar 和 source 包。

例如：xxx.jar 和 xxx-sources.jar 分别是 jar 和 source 包。

第二步：将 jar 和 source 包添加到工程中。

• 将 jar 和 source 包拷贝到 libs 目录下
  
• 右键 jar 包 -> Build Path -> Add to Build Path
  
  Add to Build Path 后就会生成 Referenced Libraries 的库，然后选择其目录下的jar，右键->Properties->Java Source Attachment->Workspace location->Browse->选择对应的source包即可。
  

别急，以为这样就成功了吗？错，因为 Android 项目会自动将 libs 目录下的 jar 生成到 Android Private Libraries 中，并且它的排序可能在 Reference Libraries 之前，所以我们引用的还是没有添加 source 包的 jar。 那怎么办？

- 右键项目名->Properties->Java Build Path->Order and Export->选中jar包->点击Up按键（将jar的排序移到Android Private Libraries之前即可）

OK，大功告成！！！