ZXing源码解析一:让源码跑起来

前言:因为公司用的扫码库是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有关的代码应该是在androidandroidcorecore模块中,这里的android模块Android客户端的源码,但是要想成功运行源码,还需要将androidandroidcore作为其依赖库。具体的操作方法如下

  1. File–>New–>ImportModule 将android模块导入项目。
  2. File–>New–>NewModule在跳出的界面选择AndroidLibrary,修改名称后点击Finish即可生成一个ModlueLibrary,然后,将生成的Library中Java目录下的文件删除,将Zxing中的core文件夹下的Java目录下的文件拷贝过来,最后,将此模块设为android模块的依赖。
  3. 用和步骤2一样的方法,导入androidcore模块。

以上操作完成后,项目的结构应该如下图所示

1
这时还需要解决几个问题,代码才能运行起来,步骤如下
  1. android模块下的AndroidManifest.xml中的
    1
    <uses-sdk android:minSdkVersion="19" android:targetSdkVersion="22"/>

这行代码删除。

  1. HistoryItemAdapter.java的构造方法中的代码修改为

    1
    2
    3
    4
    HistoryItemAdapter(Context activity) {
    super(activity, R.layout.history_list_item, new ArrayList<HistoryItem>());
    this.activity = activity;
    }
  2. RSSExpandedReader.java中的这句代码

    1
    ps = checkRows(new ArrayList<>(), 0);

修改为

1
ps = checkRows(new ArrayList<ExpandedRow>(), 0);

将上面几处修改完成,此时项目就能跑起来了,不过这时跑起来的项目是横屏的,只要在AndroidManifest.xml修改以下Acticity的配置就能将横屏切换成竖屏了。

结束语

  本篇主要讲述了怎样下载及运行项目,只有将项目运行起来,才能方便的调试,通过调试才能很好的理解其中的原理及解析源码的步骤。可以发现现在运行的项目其中有好多功能对我们来说都是多余的,下篇我们将删除多余的功能并开始分析源码,了解整个解码的步骤。

wizardev wechat
欢迎您扫一扫上面的微信公众号,订阅我的博客!