目录

效果：

开发环境

涉及知识点

集成配置

蓝牙连接

蓝牙打印

GitHub

效果：

特别声明：较之前的版本有很大的调整，之前的版本是未适配8.0的，现在是适配了的，接入方式也不一样，包括代码逻辑都有调整，不过梳理清楚流程之后也就不难了，非常简单。（更新时间：2020-03-27）

开发环境

• Gprinter佳博打印机，型号GP-2120TU
• Android Studio 3.6.1，gradle 3.5.3

本文可能内容比较长，但是难度不大。文末附github地址。

涉及知识点

• 蓝牙相关
• 多线程开发
• 线程池
• 构建者模式
• 单例模式
• 运行时权限
• BroadcastReceiver
• startActivityForResult
• 等等

集成配置

1.添加jar包，在app目录下新建libs文件夹，拷入jar文件并Add As Library

2.在main目录下新建jniLibs目录，并拷入so文件

3.配置我们的manifest文件，添加必要的权限

    <!-- 打印相关权限 --><uses-permission android:name="android.permission.INTERNET" /><uses-permission android:name="android.permission.BLUETOOTH_ADMIN" /><uses-permission android:name="android.permission.BLUETOOTH" /><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /><uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" /><uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /><uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /><uses-featureandroid:name="android.hardware.usb.host"android:required="true" />

ok，基本的配置完成，开始进入正题。

基本大的流程分为两部分，一是蓝牙连接，二是打印，下面开始一一介绍。

蓝牙连接

分为几个小步骤

1.因为蓝牙涉及到隐私权限，所以先检查、请求权限

    private void checkPermission() {for (String permission : permissions) {if (PackageManager.PERMISSION_GRANTED != ContextCompat.checkSelfPermission(this, permission)) {per.add(permission);}}}private void requestPermission() {if (per.size() > 0) {String[] p = new String[per.size()];ActivityCompat.requestPermissions(this, per.toArray(p), REQUEST_CODE);}}

2.点击连接按钮，通过startActivityForResult启动一个蓝牙列表页面，实际上显示为一个dialog

    public void btnConnect(View view) {startActivityForResult(new Intent(MainActivity.this, BluetoothListActivity.class), BLUETOOTH_REQUEST_CODE);}

3.这个页面的作用就是判断蓝牙是否可用、是否开启，显示已配对和未配对的蓝牙设备列表

    /*** 初始化蓝牙*/private void initBluetooth() {// 获取蓝牙适配器mBluetoothAdapter = BluetoothAdapter.getDefaultAdapter();// 检查蓝牙是否可用if (mBluetoothAdapter == null) {Toast.makeText(this, "当前设备不支持蓝牙", Toast.LENGTH_SHORT).show();} else {// 检查蓝牙是否打开if (!mBluetoothAdapter.isEnabled()) {Intent enableIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);startActivityForResult(enableIntent, REQUEST_ENABLE_BT);} else {getDeviceList();}}}@Overrideprotected void onActivityResult(int requestCode, int resultCode, Intent data) {super.onActivityResult(requestCode, resultCode, data);if (requestCode == REQUEST_ENABLE_BT) {if (resultCode == Activity.RESULT_OK) {// bluetooth is openedgetDeviceList();} else {// bluetooth is not openToast.makeText(this, "蓝牙没有开启", Toast.LENGTH_SHORT).show();}}}/*** 蓝牙设备列表*/protected void getDeviceList() {// 初始化一个数组适配器，用来显示已匹对和未匹对的设备mDevicesArrayAdapter = new ArrayAdapter<>(this, R.layout.bluetooth_device_name_item);lvPairedDevice.setAdapter(mDevicesArrayAdapter);lvPairedDevice.setOnItemClickListener(mDeviceClickListener);// 已匹对数据Set<BluetoothDevice> pairedDevices = mBluetoothAdapter.getBondedDevices();// 添加一个item显示信息mDevicesArrayAdapter.add("已配对：");if (pairedDevices.size() > 0) {//遍历填充数据for (BluetoothDevice device : pairedDevices) {mDevicesArrayAdapter.add(device.getName() + "\n" + device.getAddress());}} else {mDevicesArrayAdapter.add("没有已配对设备");}}/*** 接收扫描设备的广播* changes the title when discovery is finished*/private final BroadcastReceiver mFindBlueToothReceiver = new BroadcastReceiver() {@Overridepublic void onReceive(Context context, Intent intent) {String action = intent.getAction();// 每当发现一个蓝牙设备时if (BluetoothDevice.ACTION_FOUND.equals(action)) {// Get the BluetoothDevice object from the Intent//获取设备BluetoothDevice device = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE);// If it's already paired, skip it, because it's been listed// 未匹对的情况下添加显示if (device.getBondState() != BluetoothDevice.BOND_BONDED) {mDevicesArrayAdapter.add(device.getName() + "\n" + device.getAddress());}// 扫描结束} else if (BluetoothAdapter.ACTION_DISCOVERY_FINISHED.equals(action)) {setProgressBarIndeterminateVisibility(false);setTitle("选择蓝牙设备");//此处-2是减去我们手动添加的两个区分显示的itemLog.i("tag", "finish discovery" + (mDevicesArrayAdapter.getCount() - 2));if (mDevicesArrayAdapter.getCount() == 0) {mDevicesArrayAdapter.add("没有找到蓝牙设备");}}}};/*** 扫描设备*/private void discoveryDevice() {setProgressBarIndeterminateVisibility(true);setTitle("扫描中");// 添加一个item区分显示信息mDevicesArrayAdapter.add("未配对：");// If we're already discovering, stop itif (mBluetoothAdapter.isDiscovering()) {mBluetoothAdapter.cancelDiscovery();}// 开始扫描，每扫描到一个设备，都会发送一个广播mBluetoothAdapter.startDiscovery();}

4.点击一个列表item的时候 即表示连接此设备，通过setResult返回该item对应的设备mac地址

    private OnItemClickListener mDeviceClickListener = new OnItemClickListener() {@Overridepublic void onItemClick(AdapterView<?> av, View v, int arg2, long arg3) {// Cancel discovery because it's costly and we're about to connect// Get the device MAC address, which is the last 17 chars in the ViewString info = ((TextView) v).getText().toString();String noDevices = "没有已配对设备";String noNewDevice = "没有找到蓝牙设备";Log.i("TAG", info);// info 不是我们手动添加的信息 即表示为真实蓝牙设备信息if (!info.equals(noDevices) && !info.equals(noNewDevice) && !info.equals("未配对") && !info.equals("已配对")) {mBluetoothAdapter.cancelDiscovery();//mac 地址String address = info.substring(info.length() - 17);// 设置信息并返回// Set result and finish this ActivityIntent intent = new Intent();intent.putExtra(EXTRA_DEVICE_ADDRESS, address);setResult(Activity.RESULT_OK, intent);finish();}}};

5.在MainActivity的onActivityResult中获取mac地址，并通过设备连接管理类DeviceConnFactoryManager进行连接

    @Overrideprotected void onActivityResult(int requestCode, int resultCode, Intent data) {super.onActivityResult(requestCode, resultCode, data);if (resultCode == RESULT_OK) {//蓝牙连接if (requestCode == BLUETOOTH_REQUEST_CODE) {closePort();//获取蓝牙mac地址String macAddress = data.getStringExtra(BluetoothListActivity.EXTRA_DEVICE_ADDRESS);//初始化DeviceConnFactoryManager 并设置信息new DeviceConnFactoryManager.Build()//设置标识符.setId(id)//设置连接方式.setConnMethod(DeviceConnFactoryManager.CONN_METHOD.BLUETOOTH)//设置连接的蓝牙mac地址.setMacAddress(macAddress).build();//配置完信息，就可以打开端口连接了Log.i("TAG", "onActivityResult: 连接蓝牙" + id);threadPool = ThreadPool.getInstantiation();threadPool.addTask(new Runnable() {@Overridepublic void run() {DeviceConnFactoryManager.getDeviceConnFactoryManagers()[id].openPort();}});}}}

这里可以看到，我们是先拿到了mac地址，然后通过管理类的构建者模式进行设置参数，最后再通过管理类调用openPort方法去连接的。

6.在连接管理类中通过jar包封装的方法进行连接，并通过广播Broadcast把连接状态发送出去

    public void openPort() {deviceConnFactoryManagers[id].isOpenPort = false;sendStateBroadcast(CONN_STATE_CONNECTING);switch (deviceConnFactoryManagers[id].connMethod) {case BLUETOOTH:System.out.println("id -> " + id);mPort = new BluetoothPort(macAddress);isOpenPort = deviceConnFactoryManagers[id].mPort.openPort();break;default:break;}//端口打开成功后，检查连接打印机所使用的打印机指令ESC、TSCif (isOpenPort) {queryCommand();} else {if (this.mPort != null) {this.mPort = null;}sendStateBroadcast(CONN_STATE_FAILED);}}

这里通过实例化BluetoothPort把mac地址传入，然后调用了PortManager的openPort方法返回了一个状态。

往下看，这个switch代码块之后就是对这个状态的判断，当状态为已连接的时候调用了queryCommand方法，这个方法里面有一些操作，其中一个就是通过广播把已连接的状态发出去。

7.在MainActivity中接收广播，并根据状态对界面进行显示处理

    private BroadcastReceiver receiver = new BroadcastReceiver() {@Overridepublic void onReceive(Context context, Intent intent) {String action = intent.getAction();if (DeviceConnFactoryManager.ACTION_CONN_STATE.equals(action)) {int state = intent.getIntExtra(DeviceConnFactoryManager.STATE, -1);int deviceId = intent.getIntExtra(DeviceConnFactoryManager.DEVICE_ID, -1);switch (state) {case DeviceConnFactoryManager.CONN_STATE_DISCONNECT:if (id == deviceId) mTvState.setText("未连接");break;case DeviceConnFactoryManager.CONN_STATE_CONNECTING:mTvState.setText("连接中");break;case DeviceConnFactoryManager.CONN_STATE_CONNECTED:mTvState.setText("已连接");Toast.makeText(MainActivity.this, "已连接", Toast.LENGTH_SHORT).show();break;case CONN_STATE_FAILED:mTvState.setText("未连接");Toast.makeText(MainActivity.this, "连接失败！重试或重启打印机试试", Toast.LENGTH_SHORT).show();break;}/* Usb连接断开、蓝牙连接断开广播 */} else if (ACTION_USB_DEVICE_DETACHED.equals(action)) {mHandler.obtainMessage(CONN_STATE_DISCONN).sendToTarget();}}};

既然知道状态了就可以根据自己的需求去处理，这里只是简单的提示。

ok，到这连接的部分就介绍完毕了，下面开始介绍打印的部分。

蓝牙打印

打印其实是软件与硬件之间的交互，而这部分恰恰是sdk的职责所在，所以留给我们的任务已经不多了，也就相对简单很多。

1.通过线程池添加打印任务

    public void printLabel() {Log.i("TAG", "准备打印");threadPool = ThreadPool.getInstantiation();threadPool.addTask(new Runnable() {@Overridepublic void run() {...}});}

因为打印是耗时任务，所以不管是为了避免卡顿还是ANR，我们应该用线程池进行优化，为了方便再用单例封装起来。

2.打印之前也要先做蓝牙状态的判断，只有做到足够的严谨，才能看起来万无一失。。

    public void printLabel() {Log.i("TAG", "准备打印");threadPool = ThreadPool.getInstantiation();threadPool.addTask(new Runnable() {@Overridepublic void run() {//先判断打印机是否连接if (DeviceConnFactoryManager.getDeviceConnFactoryManagers()[id] == null ||!DeviceConnFactoryManager.getDeviceConnFactoryManagers()[id].getConnState()) {mHandler.obtainMessage(CONN_PRINTER).sendToTarget();return;}...}});}

这里呢，因为是在子线程，所以通过handler在主线程更新ui或者给个提示

    @SuppressLint("HandlerLeak")private Handler mHandler = new Handler() {@Overridepublic void handleMessage(Message msg) {switch (msg.what) {case CONN_STATE_DISCONN:if (DeviceConnFactoryManager.getDeviceConnFactoryManagers()[id] != null || !DeviceConnFactoryManager.getDeviceConnFactoryManagers()[id].getConnState()) {DeviceConnFactoryManager.getDeviceConnFactoryManagers()[id].closePort(id);Toast.makeText(MainActivity.this, "成功断开连接", Toast.LENGTH_SHORT).show();}break;case PRINTER_COMMAND_ERROR:Toast.makeText(MainActivity.this, "请选择正确的打印机指令", Toast.LENGTH_SHORT).show();break;case CONN_PRINTER:Toast.makeText(MainActivity.this, "请先连接打印机", Toast.LENGTH_SHORT).show();break;}}};

    public void printLabel() {Log.i("TAG", "准备打印");threadPool = ThreadPool.getInstantiation();threadPool.addTask(new Runnable() {@Overridepublic void run() {//先判断打印机是否连接if (DeviceConnFactoryManager.getDeviceConnFactoryManagers()[id] == null ||!DeviceConnFactoryManager.getDeviceConnFactoryManagers()[id].getConnState()) {mHandler.obtainMessage(CONN_PRINTER).sendToTarget();return;}if (DeviceConnFactoryManager.getDeviceConnFactoryManagers()[id].getCurrentPrinterCommand() == PrinterCommand.TSC) {Log.i("TAG", "开始打印");sendLabel();} else {mHandler.obtainMessage(PRINTER_COMMAND_ERROR).sendToTarget();}}});}

    private void sendLabel() {LabelCommand tsc = new LabelCommand();tsc.addSize(40, 30); // 设置标签尺寸，按照实际尺寸设置tsc.addGap(1); // 设置标签间隙，按照实际尺寸设置，如果为无间隙纸则设置为0tsc.addDirection(LabelCommand.DIRECTION.FORWARD, LabelCommand.MIRROR.NORMAL);// 设置打印方向tsc.addQueryPrinterStatus(LabelCommand.RESPONSE_MODE.ON);//开启带Response的打印，用于连续打印tsc.addReference(0, 0);// 设置原点坐标tsc.addTear(EscCommand.ENABLE.ON); // 撕纸模式开启tsc.addCls();// 清除打印缓冲区// 绘制简体中文tsc.addText(30, 30, LabelCommand.FONTTYPE.SIMPLIFIED_CHINESE, LabelCommand.ROTATION.ROTATION_0, LabelCommand.FONTMUL.MUL_1, LabelCommand.FONTMUL.MUL_1,"这是标题");tsc.addText(200, 30, LabelCommand.FONTTYPE.SIMPLIFIED_CHINESE, LabelCommand.ROTATION.ROTATION_0, LabelCommand.FONTMUL.MUL_1, LabelCommand.FONTMUL.MUL_1,"序号：" + "1");tsc.addText(30, 90, LabelCommand.FONTTYPE.SIMPLIFIED_CHINESE, LabelCommand.ROTATION.ROTATION_0, LabelCommand.FONTMUL.MUL_1, LabelCommand.FONTMUL.MUL_1,"价格：" + "99.00");tsc.addText(30, 140, LabelCommand.FONTTYPE.SIMPLIFIED_CHINESE, LabelCommand.ROTATION.ROTATION_0, LabelCommand.FONTMUL.MUL_1, LabelCommand.FONTMUL.MUL_1,"数量：" + "99");tsc.addText(30, 190, LabelCommand.FONTTYPE.SIMPLIFIED_CHINESE, LabelCommand.ROTATION.ROTATION_0, LabelCommand.FONTMUL.MUL_1, LabelCommand.FONTMUL.MUL_1,"日期：" + "2020-02-02");// 绘制图片
//        Bitmap b = BitmapFactory.decodeResource(getResources(), R.mipmap.ic_launcher);
//        tsc.addBitmap(20, 50, LabelCommand.BITMAP_MODE.OVERWRITE, b.getWidth(), b);//二维码tsc.addQRCode(200, 90, LabelCommand.EEC.LEVEL_L, 4, LabelCommand.ROTATION.ROTATION_0, "www.baidu.com");tsc.addPrint(1, 1); // 打印标签tsc.addSound(2, 100); // 打印标签后 蜂鸣器响/* 发送数据 */Vector<Byte> data = tsc.getCommand();if (DeviceConnFactoryManager.getDeviceConnFactoryManagers()[id] == null) {Log.i("TAG", "sendLabel: 打印机为空");return;}DeviceConnFactoryManager.getDeviceConnFactoryManagers()[id].sendDataImmediately(data);}