ZXingAndroidClientLibrary发布及使用指南

经过几天的努力，ZXingAndroidClientLibrary终于经过测试，成功发布。Github地址：https://github.com/RileyGe/ZXingAndroidClientLibrary

ZXingAndroidClientLibrary是自己在使用学习ZXing开源库时，发现其示例软件Barcode Scanner非常适合用于自己的软件中，所以在网上出现了非常多的对Barcode Scanner软件的化简方法，但这些方法都有一个非常不好的地方就是成果是以一个APP的形式存在的，使用起来会有很多不便。具体可以参照我的文章：ZXing简明教程-从0开始，里面详细的说明了我学习的过程及制作些开源库的想法。

一、使用入门

1.1 直接引用

如果只想使用此库而不对源码进行任何更改，那么你有福了，非常容易。

1、下载AAR文件

下载地址为：ZXingAndroidClientLibrary-Releases。下载后将AAR文件解压到任意位置。

2、加载AAR库

使用Android Studio，在已有的Android程序中。通过菜单“File->New->New Module”，打开如下界面：

选择“Import .JAR/.AAR Package”，并选择刚才下载的AAR文件。

3、引用AAR文件

通过“File->Project Structure…”打开如下界面：

添加Module dependency。

4、进行一点修改

这时一般情况下是会出现一个错误的，这并不是我没有修改到位，而是要进行一个选择：

a、如果想用自己的图标：在APP的Mainfest文件中增加两行：xmlns:tools=”http://schemas.android.com/tools”、tools:replace=”android:icon”。位置如下图所示。

如果不想自己的图标，AAR库中包含了一个图标，就更简单了，删除上图中：android:icon=”@mipmap/ic_launcher”这一句就可以了。

这样就可以正常使用了。

1.2 引用代码

引用代码和上面的步骤基本一致，不过导入ZXingAndroidClientLibrary时使用的是“Import Module”。其他都是一样的，不过导入源码需要的时间一般比较长。

二、使用CaptureActivity

CaptureActivity是Barcode Scanner最核心的功能，也是此程序的入口。

使用此功能非常简单，直接当在一个普通的Activity使用就可以了，典型代码为：

三、此类库相对于Barcode Scanner的修改

如果只是想使用此库文件，不需要了解此内容。

主要修改有3点：

1、在Android Library不能使用android:showAsAction标签，所以一些layout文件中需要用app:showAsAction替代android:showAsAction。不要忘记 xmlns:app=”http://schemas.android.com/apk/res-auto”。

2、如果项目是Android Library，R文件生成的字段会变成public static int,而不是public static final int,所以itemId不能用在switch语句中，在Android Library中要把switch-case换成if-else语句（共6处）。

3、在Mainfest文件中，原来CaptureActivity是初始Activity，去掉些部分内容。即去掉：

四、示例程序

源码的app文件夹下是一个完整而且非常简单示例程序，核心的代码只有两句：

但由于新版本Android安全性的考虑，需要在运行时确认摄像头权限。在确认摄像头权限时使用了PermissionsDispatcher。