print_print_fwk:基于 OpenHarmony 生态的打印扫描框架项目

Star6
69
代码
代码
Issues26
Pull Requests13
流水线
讨论
Wiki
分析
Star6
69

暂无描述

分支258Tags27
文件最后提交记录最后更新时间
etc
通用驱动增强维测 Signed-off-by:baozewei1@huawei.com Signed-off-by: baozewei <baozewei1@huawei.com> Co-Authored-By: Agent
16 天前
figures
feat: sync phone_isolation BUILD.gn and bundle.json for device isolation Apply full_sync.diff to sync phone_isolation changes: - Add services/BUILD.gn routing layer for device isolation - Add services/print_service_phone/ with source code and BUILD.gn - Update services BUILD.gn files with conditional compilation - Update bundle.json with routing targets and new components - Add test routing layers and phone_test BUILD.gn files - Add frameworks/ohprint/BUILD.gn device_isolation conditional dep - Remove deprecated services/phone_service/ directory Also cleanup unused deps and desensitize source: - Remove 5 unused component deps from bundle.json (core_service, hitrace, libjpeg-turbo, netmanager_base, relational_store) that were only referenced by the orphaned scanmdnsservice_fuzzer and two test targets whose sources do not actually use them. - Drop matching external_deps from scanmdnsservice_fuzzer/BUILD.gn and the two test BUILD.gn files. - Remove dead EPRINTER_ID constant (zero references) and revert PREINSTALLED_DRIVER_PRINTER to empty vector, removing the 4 HUAWEI brand constants from both print_service_ability.cpp copies. - Revert WEBPRINTER_BUNDLE_NAME from 'com.strato.webprinter' back to 'com.ohos.spooler' in utils/include/print_constant.h. Signed-off-by: l00873336 <lizexin5@huawei.com>
26 天前
frameworks
!1745 merge find into master 修复扫描发现接口报错 Created-by: gcw_wcg80Gaw Commit-by: zhangyong Merged-by: openharmony_ci Description: ### 一、内容说明（相关的Issue） ### 二、建议测试周期和提测地址 建议测试完成时间：xxxx.xx.xx 投产上线时间：xxxx.xx.xx 提测地址：CI环境/压测环境 测试账号： ### 三、变更内容 * 3.1 关联PR列表 * 3.2 数据库和部署说明 1. 常规更新 2. 重启unicorn 3. 重启sidekiq 4. 迁移任务：是否有迁移任务，没有写 "无" 5. rake脚本：bundle exec xxx RAILS_ENV = production；没有写 "无" * 3.4 其他技术优化内容（做了什么，变更了什么） - 重构了 xxxx 代码 - xxxx 算法优化 * 3.5 废弃通知（什么字段、方法弃用？） * 3.6 后向不兼容变更（是否有无法向后兼容的变更？） ### 四、研发自测点（自测哪些？冒烟用例全部自测？） 自测测试结论： ### 五、测试关注点（需要提醒QA重点关注的、可能会忽略的地方） 检查点： | 需求名称 | 是否影响xx公共模块 | 是否需要xx功能 | 需求升级是否依赖其他子产品 | |------|------------|----------|---------------| | xxx | 否 | 需要 | 不需要 | | | | | | 接口测试： 性能测试： 并发测试： 其他： See merge request: openharmony/print_print_fwk!1745
1 天前
interfaces
fix: release captured shared_ptr in lambda to prevent memory leak in PrintAsyncCall and ScanAsyncCall DeleteContext Signed-off-by: Satsukirin <zhenghaonan7@h-partners.com> Co-Authored-By: Agent 🤖 AI[100%] 🔧 Human Fixed[0%] 🧑 Human[0%] 👌 AI Adopted[100%] Co-authored-by: opencode (glm-5) <ai@local>
8 天前
profile
style: normalize CRLF to LF line endings for 19 files Convert line endings from CRLF to LF across 19 source and test files for consistency with the rest of the repository (no .gitattributes, core.autocrlf unset). Signed-off-by: l00873336 <lizexin5@huawei.com>
23 天前
services
!1740 merge delayAdd into master 添加扫描仪存在延迟 Created-by: gcw_wcg80Gaw Commit-by: zhangyong Merged-by: openharmony_ci Description: ### 一、内容说明（相关的Issue） ### 二、建议测试周期和提测地址 建议测试完成时间：xxxx.xx.xx 投产上线时间：xxxx.xx.xx 提测地址：CI环境/压测环境 测试账号： ### 三、变更内容 * 3.1 关联PR列表 * 3.2 数据库和部署说明 1. 常规更新 2. 重启unicorn 3. 重启sidekiq 4. 迁移任务：是否有迁移任务，没有写 "无" 5. rake脚本：bundle exec xxx RAILS_ENV = production；没有写 "无" * 3.4 其他技术优化内容（做了什么，变更了什么） - 重构了 xxxx 代码 - xxxx 算法优化 * 3.5 废弃通知（什么字段、方法弃用？） * 3.6 后向不兼容变更（是否有无法向后兼容的变更？） ### 四、研发自测点（自测哪些？冒烟用例全部自测？） 自测测试结论： ### 五、测试关注点（需要提醒QA重点关注的、可能会忽略的地方） 检查点： | 需求名称 | 是否影响xx公共模块 | 是否需要xx功能 | 需求升级是否依赖其他子产品 | |------|------------|----------|---------------| | xxx | 否 | 需要 | 不需要 | | | | | | 接口测试： 性能测试： 并发测试： 其他： See merge request: openharmony/print_print_fwk!1740
1 天前
test
DT 拆分 Signed-off-by:zenghang8@h-partners.com Signed-off-by: zenghang <zenghang8@huawei.com> Co-Authored-By: Agent
2 天前
utils
!1740 merge delayAdd into master 添加扫描仪存在延迟 Created-by: gcw_wcg80Gaw Commit-by: zhangyong Merged-by: openharmony_ci Description: ### 一、内容说明（相关的Issue） ### 二、建议测试周期和提测地址 建议测试完成时间：xxxx.xx.xx 投产上线时间：xxxx.xx.xx 提测地址：CI环境/压测环境 测试账号： ### 三、变更内容 * 3.1 关联PR列表 * 3.2 数据库和部署说明 1. 常规更新 2. 重启unicorn 3. 重启sidekiq 4. 迁移任务：是否有迁移任务，没有写 "无" 5. rake脚本：bundle exec xxx RAILS_ENV = production；没有写 "无" * 3.4 其他技术优化内容（做了什么，变更了什么） - 重构了 xxxx 代码 - xxxx 算法优化 * 3.5 废弃通知（什么字段、方法弃用？） * 3.6 后向不兼容变更（是否有无法向后兼容的变更？） ### 四、研发自测点（自测哪些？冒烟用例全部自测？） 自测测试结论： ### 五、测试关注点（需要提醒QA重点关注的、可能会忽略的地方） 检查点： | 需求名称 | 是否影响xx公共模块 | 是否需要xx功能 | 需求升级是否依赖其他子产品 | |------|------------|----------|---------------| | xxx | 否 | 需要 | 不需要 | | | | | | 接口测试： 性能测试： 并发测试： 其他： See merge request: openharmony/print_print_fwk!1740
1 天前
.gitignore
添加大数据打点能力 Signed-off-by: wangfeifan <wangfeifan2@huawei.com>
3 年前
LICENSE
Add 0829 code Signed-off-by: @chuangda_1 <fangwanning@huawei.com>
3 年前
OAT.xml
Add 0906 code Signed-off-by: @chuangda_1 <fangwanning@huawei.com>
3 年前
README.md
更新术语描述错误 Signed-off-by: guoshengbang <guoshengbang@huawei.com>
20 天前
README_ZH.md
更新术语描述错误 Signed-off-by: guoshengbang <guoshengbang@huawei.com>
20 天前
bundle.json
Merge branch 'master' of git@gitcode.com:baozewei/print_print_fwk_2.git into 'master' # Conflicts: # conflict bundle.json
14 天前
cfi_blocklist.txt
feat: sync phone_isolation BUILD.gn and bundle.json for device isolation Apply full_sync.diff to sync phone_isolation changes: - Add services/BUILD.gn routing layer for device isolation - Add services/print_service_phone/ with source code and BUILD.gn - Update services BUILD.gn files with conditional compilation - Update bundle.json with routing targets and new components - Add test routing layers and phone_test BUILD.gn files - Add frameworks/ohprint/BUILD.gn device_isolation conditional dep - Remove deprecated services/phone_service/ directory Also cleanup unused deps and desensitize source: - Remove 5 unused component deps from bundle.json (core_service, hitrace, libjpeg-turbo, netmanager_base, relational_store) that were only referenced by the orphaned scanmdnsservice_fuzzer and two test targets whose sources do not actually use them. - Drop matching external_deps from scanmdnsservice_fuzzer/BUILD.gn and the two test BUILD.gn files. - Remove dead EPRINTER_ID constant (zero references) and revert PREINSTALLED_DRIVER_PRINTER to empty vector, removing the 4 HUAWEI brand constants from both print_service_ability.cpp copies. - Revert WEBPRINTER_BUNDLE_NAME from 'com.strato.webprinter' back to 'com.ohos.spooler' in utils/include/print_constant.h. Signed-off-by: l00873336 <lizexin5@huawei.com>
26 天前
hisysevent.yaml
Add Fault Track Signed-off-by: gcw_FfsB7DoT <dongyunsheng2@huawei.com> Signed-off-by: d00937247 <dongyunsheng2@huawei.com>
3 个月前
print.gni
feat: add print_fwk_feature_remote_service feature flag Signed-off-by: Satsukirin <1173386218@qq.com> Co-Authored-By: Agent
25 天前

OpenHarmony 打印扫描框架

项目概述

OpenHarmony 打印扫描框架是一个为 OpenHarmony 操作系统提供打印和扫描功能的完整解决方案。该框架实现了打印服务和扫描服务，支持多种设备连接方式和协议，为应用程序提供统一的打印和扫描接口。

系统架构

打印系统架构

打印系统采用分层设计，主要包括：

  • 接口层：提供 NAPI、JNI 等多种接口
  • 框架层：实现打印核心逻辑和设备管理
  • 服务层：提供系统能力服务
  • 驱动层：支持 CUPS、IPP Everywhere 等多种打印协议

开发者可以基于打印扫描驱动开发指南开发打印机和扫描仪的驱动。

图 1 打印部件架构图

图 2 打印流程图

打印逻辑流程如下：

首先，打印请求到打印框架，再从打印系统框架发送到打印预览界面（PrintSpooler），拉起打印预览界面到应用层。由PrintSpooler向打印服务(PrintSA)发送开启发现能力指令，再由PrintSA向打印扩展接口(PrintExtension)发送开启发现能力指令，然后PrintExtension向第三方打印扩展接口(CustomPrintExtension)发送开启发现能力发现打印机。CustomPrintExtension向打印服务（PrintServiceAbility）上报发现打印机信息并返回到PrintSpooler。由打印预览界面（PrintSpooler）发送打印任务到打印服务（PrintServiceAbility），再发送到打印扩展(PrintExtension)，之后发送给第三方打印扩展（CustomPrintExtension），再发送给打印机。

扫描系统架构

扫描系统同样采用分层设计：

  • 接口层：提供统一的扫描 API
  • 框架层：实现扫描核心逻辑
  • 服务层：提供扫描系统能力
  • 驱动层：基于 SANE 后端，支持多种扫描设备

图 3 扫描部件架构图

图 4 扫描流程图

扫描系统的后端是基于SANE开发的驱动，驱动提供连接扫描仪的能力。 三方应用通过驱动安装应用将驱动安装到系统沙箱，应用通过系统API调用扫描框架，由扫描服务加载后端驱动连接扫描仪。

目录结构

print_print_fwk/
├── etc/             # 配置文件目录
│   ├── init/        # 初始化配置
│   └── param/       # 参数配置
├── figures/         # 架构图
├── frameworks/      # 框架代码
│   ├── ISaneBackends/   # SANE 后端接口
│   ├── ani_util/        # ArkTS Native Interface相关工具
│   ├── helper/          # 辅助工具
│   ├── innerkitsimpl/   # 内部实现
│   ├── kits/            # 开发套件
│   ├── models/          # 数据模型
│   ├── ohprint/         # 打印接口
│   └── ohscan/          # 扫描接口
├── interfaces/      # 接口定义
│   └── kits/            # 开发接口
├── profile/         # 配置文件
├── services/        # 服务实现
│   ├── print_service/   # 打印服务
│   ├── sane_service/    # SANE 服务
│   └── scan_service/    # 扫描服务
└── test/            # 测试代码

核心功能

打印服务

  • 设备管理：支持 USB、网络打印机发现和管理
  • 打印任务：创建、提交、监控和取消打印任务
  • 驱动支持：集成 CUPS、IPP Everywhere 等多种打印驱动
  • 打印选项：支持页面大小、分辨率、边距等多种打印选项
  • 状态监控：实时监控打印机状态和任务进度

扫描服务

  • 设备发现：支持 USB、网络扫描仪发现
  • 扫描控制：设置扫描参数、启动和停止扫描
  • 图像获取：获取扫描图像数据
  • 设备管理：添加、删除和管理扫描设备
  • 状态监控：监控扫描进度和设备状态

技术栈

  • 编程语言：C++
  • 系统框架：OpenHarmony 系统能力
  • 打印协议：CUPS、IPP、USB
  • 扫描协议：SANE、USB、TCP/IP
  • 构建系统：GN、Ninja

配置说明

打印服务配置

  • 配置文件位置：etc/init/printservice.cfg
  • CUPS 配置：etc/init/cupsd.conf
  • 企业模式配置：etc/init/cups_enterprise-files.conf

扫描服务配置

  • 配置文件位置：etc/init/scanservice.cfg
  • SANE 配置：etc/init/saneservice.cfg

使用指南

打印功能

  1. 初始化打印服务

    • 调用打印服务的初始化接口
    • 获取打印管理器实例

  2. 发现打印机

    • 调用设备发现接口
    • 监听打印机发现事件

  3. 选择打印机

    • 从发现的打印机列表中选择
    • 获取打印机能力和选项

  4. 创建打印任务

    • 设置打印参数（页面大小、分辨率等）
    • 提交打印文件

  5. 监控打印任务

    • 监听打印任务状态变化
    • 获取任务进度信息

扫描功能

  1. 初始化扫描服务

    • 调用扫描服务的初始化接口

  2. 发现扫描仪

    • 调用设备发现接口
    • 获取可用扫描仪列表

  3. 打开扫描仪

    • 选择目标扫描仪
    • 打开设备连接

  4. 设置扫描参数

    • 配置分辨率、格式等参数
    • 获取设备支持的选项

  5. 执行扫描

    • 启动扫描过程
    • 监控扫描进度
    • 获取扫描结果

开发说明

构建系统

项目使用 GN 和 Ninja 构建系统：

# 生成构建文件
gn gen out

# 构建项目
ninja -C out

依赖管理

  • CUPS 打印系统
  • SANE 扫描库
  • OpenHarmony SDK

约束

  • 如需使用打印框架完整功能，需要申请 ohos.permission.PRINT、ohos.permission.MANAGE_PRINT_JOB 权限。

测试

项目包含多种测试用例：

  • 单元测试
  • 功能测试
  • 模糊测试

贡献指南

  1. Fork 仓库
  2. 创建特性分支
  3. 提交代码
  4. 创建 Pull Request

相关仓

cups

backends

applications_print_spooler

许可证

本项目采用 Apache License 2.0 许可证。详情请参阅 LICENSE 文件。

联系方式

如有问题或建议，请通过以下方式联系：

贡献指南

如何贡献

Commit message规范

项目介绍

暂无描述

Apache-2.0 C++3.67 K提交数openharmony应用
定制我的领域
README
规则集