前言:因为公司用的扫码库是ZXing,但是在使用的时候发现存在一些问题,所以就想分析一下源码,搞清楚ZXing解析二维码的原理和步骤,然后再进一步对ZXing进行一些优化。
下载源码
ZXing
库是开源的,可以直接在github下载源码阅读,源码地址在这里,可以用git命令将源码clone道本地,如图
从上图中可以发现源码有200多兆,当然这两百多兆不仅有源码,还有一些文档什么的。源码下载完成后,会有以下的目录,如图
这里就称一个文件夹为一个模块,各个模块的描述如下表
模块 | 描述 |
core | 图像解码库和测试代码 |
javase | JavaSE的客户端代码 |
android | Android客户端的源码 |
android-integration | 简化Intent与Android客户端集成 |
android-core | 配置Android摄像头 |
zxingorg | 在线解析二维码 |
zxing.appspot.com | 在线生成二维码 |
docs | 介绍ZXing项目的文档 |
运行源码
源码下载下来后的工作就是导入Android Studio中来跑下,看下源码运行的效果,从下载下来的模块来看,这里与Android有关的代码应该是在android
、androidcore
和core
模块中,这里的android
模块Android客户端的源码,但是要想成功运行源码,还需要将android
、androidcore
作为其依赖库。具体的操作方法如下
- File-->New-->ImportModule 将
android
模块导入项目。 - File-->New-->NewModule在跳出的界面选择
AndroidLibrary
,修改名称后点击Finish
即可生成一个ModlueLibrary
,然后,将生成的Library
中Java目录下的文件删除,将Zxing中的core文件夹下的Java目录下的文件拷贝过来,最后,将此模块设为android
模块的依赖。 - 用和步骤2一样的方法,导入
androidcore
模块。
以上操作完成后,项目的结构应该如下图所示
这时还需要解决几个问题,代码才能运行起来,步骤如下
- 将
android
模块下的AndroidManifest.xml
中的
<uses-sdk android:minSdkVersion="19" android:targetSdkVersion="22"/>
这行代码删除。
- 将
HistoryItemAdapter.java
的构造方法中的代码修改为
HistoryItemAdapter(Context activity) { super(activity, R.layout.history_list_item, new ArrayList<HistoryItem>()); this.activity = activity; }
- 将
RSSExpandedReader.java
中的这句代码
ps = checkRows(new ArrayList<>(), 0);
修改为
ps = checkRows(new ArrayList<ExpandedRow>(), 0);
将上面几处修改完成,此时项目就能跑起来了,不过这时跑起来的项目是横屏的,只要在AndroidManifest.xml
修改以下Acticity的配置就能将横屏切换成竖屏了。
结束语
本篇主要讲述了怎样下载及运行项目,只有将项目运行起来,才能方便的调试,通过调试才能很好的理解其中的原理及解析源码的步骤。可以发现现在运行的项目其中有好多功能对我们来说都是多余的,下篇我们将删除多余的功能并开始分析源码,了解整个解码的步骤。