基于Google ZXing 3.3.0稳定版分析,基本的流程讲解。会涉及如何编写基于ZXing库的APK; 如何修改源码定制自己的扫面界面。
Google ZXing介绍
Google ZXing介绍
简单理解, ZXing支持各种条形码,二维码扫描,由多个模块组成, 而且支持PC端,移动端。
本系列,关注的是如何在Android手机中使用ZXing库, 重点关注,
core
, android
, android-core
。
Google ZXing 先睹为快
github上ZXing没有提供apk下载,需要google play,将android目录导入Android Studio编程完成如下apk。
百度网盘 google-zxing apk
Google ZXing 源码导入
ZXing项目使用Maven管理,编译, 没有使用Android Studio工具, 要想快速导入AS(Android Studio下同), 稍微麻烦点。如果你顺手Maven,直接查看 Getting Started Developing 步骤。
接下来,介绍导入AS过程。
ZXing目录结构
在ZXing介绍那一节,已经展示ZXing想的目录结构。
ZXing 常用库
Android使用的有: core
, android
, android-core
, android-integration
ZXing源码导入
以导入android
目录为例讲解,如何在AS中使用ZXing核心库。其中android
是官方提供的demo, 通过该Demo熟悉如何集成ZXing核心库。
使用jar包形式
git clone源码或者直接下载 zxing-3.3.0 解压后,目录内容如下:
在AS导入界面,选择导入选项,进入android
目录,连续next后,官方Demo就导入到AS中。
这里需要注意下载zxing目录和导入到AS workspace不能是同一个文件夹,否则会出现错误。
已经说明,ZXing核心是core
, android-core
, 而android
是提供的Demo,上述导入目的是想快速运行该Demo而已。现在,还编译不过,因为缺少zxing 核心库,以及android核心库。
解决方法
- 1 下载core-3.3.0.jar包 http://repo1.maven.org/maven2/com/google/zxing/core/3.3.0/core-3.3.0.jar
- 2 AS导入工程中的app目录下新建libs目录(默认没有), 将core-3.3.0.jar 拷贝进入。
- 3 选中core-3.3.0.jar右键,选择
Add As Library...
将jar包添加到依赖中 - 4 再次编译,查看结果,还是会有问题。
这种方式会在app目录中对应的build.gradle 增加一行 。
compile files('libs/core-3.3.0.jar')
如上运行还是有错误, 提示:
没有导入
android-core
, 从zxing源码中zxing\android-core\src\main\java\com\google\zxing\client\android\camera
拷贝 CameraConfigurationUtils.java
到
- 5 再次编译,成功生成apk,小米5手机测试OK。
以上方法甚是觉得累赘,因为我们需要的是zxing核心库core
,android-core
, 库的开发者肯定已经放在了AS对应的仓库中了,接下来只要很简单的 添加2个依赖就可以把该Demo所需的依赖库下载,为我所用。
请看,下面的步骤。
ZXing依赖库导入
大家对build.gradle
肯定不陌生,就是AS项目的配置文件,既然Demo需要依赖zxing核心库,步骤如下:
- AS工程目录app下的build.gradle 添加 依赖
dependencies {
compile 'com.google.zxing:core:3.3.0';
compile 'com.google.zxing:android-core:3.3.0';
}
为什么知道是这些,简单。ZXing使用Maven来管理的,所以每个目录会有个pom.xml文件。找到zxing源码根目录下的pom.xml
文件, 搜索关键字 android-core
, core
<dependency>
<groupId>com.google.zxing</groupId>
<artifactId>core</artifactId>
<version>${zxing.version}</version>
</dependency>
<dependency>
<groupId>com.google.zxing</groupId>
<artifactId>android-core</artifactId>
<version>${zxing.version}</version>
</dependency>
再结合上述AS的依赖,一看就知道 compile '组织名称:制品名称:版本号';
小结
以上所有步骤小结为
- git clone 或者 下载zxing-3.3.0源码,将其中android目录导入AS
- 添加依赖
- 编译apk
不建议下载zxing 核心库源码,自己编译成jar包,理由很简单,没必要!
- 因为常用场景不会去改动core核心库,里面基本是算法相关。
- 徒劳新增了Demo的文件量