1# 打印框架<a name="ZH-CN_TOPIC_0000001124232845"></a> 2 3- [简介](#section11660541593) 4- [目录](#section161941989596) 5- [约束](#section119744591305) 6- [说明](#section1312121216216) 7- [相关仓](#section1371113476307) 8 9## 简介<a name="section11660541593"></a> 10 11打印框架支持三方应用创建打印任务，拉起后台打印任务管理，管理打印扩展和打印任务。 12提供打印扩展框架，实现三方打印扩展的接入，管理打印任务与打印机之间的关系，启动、取消打印任务，查询打印进度等。 13 14打印框架提供了扫描能力，支持三方应用搜索和连接扫描仪，查询扫描仪能力，设置参数并启动扫描，完成扫描后可以获得扫描出的图片文件。 15 16开发者可以基于[打印扫描驱动开发指南](https://gitee.com/openharmony/applications_print_spooler/blob/master/OpenHarmony%E6%89%93%E5%8D%B0%E6%89%AB%E6%8F%8F%E9%A9%B1%E5%8A%A8%E5%BC%80%E5%8F%91%E6%8C%87%E5%8D%971.8.md)开发打印机和扫描仪的驱动。 17 18**图 1** 打印部件架构图<a name="fig371116145419"></a> 19 20 21 22**图 2** 打印系统架构图<a name="fig371116145420"></a> 23 24 25 26打印逻辑流程如下： 27 28首先，打印请求到打印框架，再从打印系统框架发送到打印预览界面（PrintSpooler），拉起打印预览界面到应用层。由PrintSpooler向打印服务(PrintSA)发送开启发现能力指令，再由PrintSA向打印扩展接口(PrintExtension)发送开启发现能力指令，然后PrintExtension向第三方打印扩展接口(CustomPrintExtension)发送开启发现能力发现打印机。CustomPrintExtension向打印服务（PrintServiceAbility）上报发现打印机信息并返回到PrintSpooler。由打印预览界面（PrintSpooler）发送打印任务到打印服务（PrintServiceAbility），再发送到打印扩展(PrintExtension)，之后发送给第三方打印扩展（CustomPrintExtension），再发送给打印机。 29 30**图 3** 扫描系统架构图<a name="fig371116145421"></a> 31 32 33 34扫描系统的后端是基于[SANE](https://gitee.com/openharmony/third_party_backends)开发的驱动，驱动提供连接扫描仪的能力。 35三方应用通过驱动安装应用将驱动安装到系统沙箱，应用通过系统API调用扫描框架，由扫描服务加载后端驱动连接扫描仪。 36 37## 目录<a name="section161941989596"></a> 38 39``` 40foundation/print_print_fwk #打印框架 41├── frameworks 42│ └── innerkitsimpl # Native接口 43 └── kits\extension # 打印扩展管理 44├── interfaces\kits # 接口层代码 45│ └── jsnapi 46 └── extension # 管理扩展生命周期接口 47 └── extensionctx # 管理扩展上下文 48│ └── napi # JavaScript接口 49├── services # 服务层代码 50└── test # 测试用例资源 51``` 52 53## 约束<a name="section119744591305"></a> 54 55- 如需使用打印框架完整功能，需要申请code ohos.permission.PRINT、ohos.permission.MANAGE_PRINT_JOB权限。 56 57## 说明<a name="section1312121216216"></a> 58部件内子模块职责说明： 59### 打印模块 60- **打印管理（Print NAPI）** 61 62 对接打印应用的JS API，负责创建打印任务，监听打印任务状态变化等接口的实现 63 64- **打印管理（InnerPrint NAPI）** 65 66 对接打印后台管理应用、三方打印扩展的内部JS API，负责打印机发现、预览、启动打印、监听打印机、打印任务状态变化等接口的实现 67 68- **打印管理客户端（Print Manager Client）** 69 70 负责打印服务在客户端的接口实现，对外(JS应用或者Native应用）提供统一的打印服务能力 71 72- **打印管理服务端（Print Manager Server）** 73 74 对接打印管理，接受应用的打印任务相关请求，执行权限校验，并拉起后台打印任务管理；管理系统中打印扩展。包括打印扩展的新增、移除、修改属性（已安装的、默认的、当前使用的）、查询状态、监听变化等；管理打印任务队列。包括：打印格式化数据的传递、打印任务的数据缓存等；对接使用中的打印扩展，分发和管理打印任务 75 76- **打印拓展（Print Extension）** 77 78 打印扩展部分需要三方厂商定制 79 80- **三方打印扩展（Custom Print Extension）** 81 82 打印机厂商实现具体打印功能提供 83 84- **打印后台管理应用（Printspooler）** 85 86 系统打印管理应用 87 88### 扫描模块 89- **扫描js接口层（Scan NAPI）** 90 91 对接扫描应用的JS-sdk，负责扫描系统接口的实现 92 93- **扫描c接口层（Scan CAPI)** 94 95 对接扫描应用的c-sdk，负责扫描系统接口的实现 96 97- **扫描管理客户端（ScanManagerClient）** 98 99 负责扫描服务在客户端的接口实现，对外(JS应用或者Native应用)提供统一的扫描服务能力 100 101- **扫描系统服务端（ScanServiceAbility）** 102 103 对接扫描客户端，作为sane_service的客户端，将图片码流转成图片缓存 104 105- **扫描系统mdns服务（ScanMdnsService）** 106 107 用于监控局域网内扫描仪的状态，更新局域网扫描仪的id 108 109- **扫描系统usb服务（ScanUsbManager）** 110 111 用于监控usb扫描仪的状态，更新usb扫描仪的id 112 113- **扫描系统数据管理（ScanSystemData）** 114 115 用于管理添加的扫描仪信息数据 116 117- **扫描系统驱动服务（SaneServerManager）** 118 119 对接扫描系统服务端，加载扫描仪驱动，管理扫描驱动、扫描驱动缓存 120 121## 相关仓<a name="section1371113476307"></a> 122 123[cups](https://gitee.com/openharmony/third_party_cups) 124 125[backends](https://gitee.com/openharmony/third_party_backends) 126 127[applications_print_spooler](https://gitee.com/openharmony/applications_print_spooler) 128 129## 参与贡献 130 131[如何贡献](https://gitee.com/openharmony/docs/blob/HEAD/zh-cn/contribute/参与贡献.md) 132 133[Commit message规范](https://gitee.com/openharmony/device_qemu/wikis/Commit%20message%E8%A7%84%E8%8C%83)
