Android系统打印服务插件printservice开发

从Android4.4开始，系统加入了打印相关的API，可以通过系统打印服务实现打印。对于需要使用打印功能的APP可参考官方教程接入打印服务。

Printing Content https://developer.android.com/training/printing/index.html

这不是本文的内容，本文介绍打印机厂商如何使自己的打印机接入android，即编写自己的打印插件接入android打印服务。且仅介绍接入部分，与打印机如何连接不在本文范围之内。

系统打印服务框架代码位于android.printservice包中。系统并没有实现具体打印功能，需要打印机厂商制作插件接入系统打印服务之后，自行实现。本文基于Android API Reference和以下两个github上的开源项目研究而来。两个参考项目如下：

android-print-plugin-cups 主页： https://github.com/pelya/android-print-plugin-cups

JfCupsPrintService 主页： https://github.com/mretallack/JfCupsPrintService

通过实验，初步实现了系统打印服务的接入（添加打印机）和模拟打印（将要打印的文件输出）。

从android.printservice中，我们可以知道主要有四个类：

PrintDocument 表示待打印文件，里面存放有文件的大小等信息和文件内容。

PrinterDiscoverySession 用于发现打印机，整个发现打印机和打印机状态更新的过程在该类里进行。

PrintJob 代表一个打印任务。

PrintService 接入系统打印的关键Service。

PrinterDiscoverySession 由 PrintService 创建，通过 onCreatePrinterDiscoverySession() 函数返回给系统。 PrintJob 由需要打印的APP创建，发送给 PrintService 。 PrintDocument 存放在 PrintJob 里面，被一同发过来。

和打印相关的类的更多详细参考见：Android_Printservice_API_部分翻译.md 。

当用户在设置里开启你的打印服务插件和进入系统打印服务界面时，系统会调用 PrinterDiscoverySession 里的 onStartPrinterDiscovery(List priorityList) 函数，通知你的插件查找打印机。具体查找方式需要自己实现，可能是查找USB接口，可能是搜索网络。系统只管结果，你通过调用其父类的 addPrinters() 方法将打印机添加进去。打印机是放在List数组里传入。

当用户离开上述打印插件的界面时，系统会调用 onStopPrinterDiscovery() 函数，表示插件可以停止寻找打印机了。

另外，在自定义的 addPrintersActivity 中，系统不会自动触发打印机寻找过程，需要自行处理。

当用户通过一些有打印功能的APP调用系统打印服务时，如果选择了你的插件的打印机，那么系统会调用 PrinterDiscoverySession 里的 onStartPrinterStateTracking(PrinterId printerId) 方法。这里系统主要希望得到打印机的 PrinterCapabilitiesInfo 和状态，里面包括打印机支持的纸张大小，以及色彩等详细功能参数。

比如：如果没有addMediaSize(PrintAttributes.MediaSize.ISO_A4, false)，那么用户就不能选择A4大小进行打印。后面的false表示是否设为默认值。

打印机有STATUS_BUSY、STATUS_IDLE、STATUS_UNAVAILABLE三种状态，只有打印机处于STATUS_IDLE时，系统才允许使用该打印机。

打印机参数直接体现在系统打印服务界面，只可以选择支持的参数，比如选择纸张的大小为A4。

同样，当用户离开该界面或者选择其他打印机时，系统会调用 onStopPrinterStateTracking(PrinterId printerId) 函数，来告诉插件不用再提供打印机的信息了。

当用户在刚刚的系统打印服务界面点击右上角的打印按钮时，系统会调用打印机所属的 PrintService 里的 onPrintJobQueued(PrintJob printJob) 方法，插件需要处理该 PrintJob 。首先需要通过 PrintJob.isQueued() 判断，该PrintJob是否准备好打印，返回true代表可以打印。然后可以通过 PrintJob.getDocument() 获得要打印的文档，这里面的数据可以通过 PrintDocument.getData() 读取。开始打印的时候，调用PrintJob.start()标记开始状态。当打印成功时，调用 PrintJob.complete() 标记打印成功。或者打印失败时，调用 PrintJob.fail( String) 标记失败。

注意：一定要对PrintJob进行状态标记，包括开始或者成功失败。如果什么都不标记，系统会一直在任务栏提示该任务打印中，并且该打印机不可打印其他任务，处于准备中。如果任务结束不标记成功或者失败，一段时间之后，系统会自动将该任务标记为失败，并且打印机状态自动变为不可用。

通过编写DEMO测试，发现android系统打印服务输出的数据是pdf 1.4的格式，无论文件内容是照片还是文档，都会统一转换为pdf 1.4。

一个打印服务和其他任何服务一样，需要在AndroidManifest.xml里声明。但是它还必须处理action为android.printservice.PrintService的Intent。这个intent声明失败会导致系统忽略该打印服务。另外，一个打印服务必须请求android.permission.BIND_PRINT_SERVICE权限，来保证只有系统能绑定（bind）它。声明这个失败会导致系统忽略这个打印服务。

一个打印服务可通过自定义设置页面（setting activity）进行配置，该activity提供