系列生态共建篇·第53篇。跨端篇后有开源爱好者问“我在电商Demo里写了很多通用组件如SKU选择器、地址联动能不能抽离出来给社区用怎么做成标准的OpenHarmony三方库” 这正是开源生态的魅力。今天我们将电商Demo中的通用支付模块和SKU选择组件抽离、封装发布为一个标准的OpenHarmony三方库HAR包并上架到OHPMOpenHarmony Package Manager仓库。我们将覆盖库工程搭建、API设计、文档撰写、单元测试、CI发布全流程。全程基于API23含官方文档未涉及的“多目标构建”和“语义化版本控制”技巧。一、前言为什么“造轮子”也要讲姿势很多开发者写过“工具类”但那只是“代码片段”。真正的三方库需要具备独立性不依赖具体业务如电商Demo可独立编译和运行。通用性API设计抽象能适应多种场景如支付模块支持支付宝、微信、银联。稳定性经过充分测试版本迭代不破坏兼容性。易用性文档齐全示例清晰一键集成。OHPM是OpenHarmony的官方包管理器类似于npmNode.js或MavenAndroid。今天我们将把电商Demo中的“支付功能”提炼成一个名为harmony/payment-kit的高质量三方库并贡献给开源社区。二、核心概念辨析代码片段 vs 三方库维度代码片段 (Utils/Snippets)三方库 (Library/HAR)复用性低需复制粘贴修改高一键集成 (ohpm install)维护性差分散在各项目中好集中维护版本化管理测试无或简陋完善包含单元测试、集成测试文档注释为主独立文档、API参考、示例工程依赖隐式依赖项目环境显式声明依赖自动解决发布口头分享OHPM中央仓库可检索三、代码实现从“业务代码”到“开源库”3.1 创建HAR库工程步骤1新建Library Module在DevEco Studio中File-New-Module-Static Library (HAR)。命名为payment-kit。步骤2工程结构规划payment-kit/ ├── src/main/ets/ │ ├── components/ # UI组件如支付密码弹窗 │ │ └── PayPasswordDialog.ets │ ├── core/ # 核心逻辑 │ │ ├── PaymentManager.ets │ │ └── ChannelAdapter.ets │ ├── models/ # 数据模型 │ │ └── PaymentInfo.ets │ ├── utils/ # 工具类 │ │ └── SignUtil.ets │ ├── index.ets # 对外暴露的API入口关键 │ └── resources/ # 资源文件 ├── src/test/ets/ # 单元测试 ├── oh-package.json5 # 库配置文件类似package.json └── README.md # 项目说明文档3.2 抽离核心逻辑支付管理器创建src/main/ets/core/PaymentManager.ets// 定义支付渠道枚举 export enum PayChannel { ALIPAY alipay, WECHAT wechat, UNIONPAY unionpay, HUAWEI_IAP huawei_iap // 华为IAP } // 定义支付结果回调 export interface PaymentCallback { onSuccess?(result: PaymentResult): void onFailed?(code: number, msg: string): void onCancel?(): void } // 支付管理器单例 export class PaymentManager { private static instance: PaymentManager private channels: MapPayChannel, ChannelAdapter new Map() private currentCallback: PaymentCallback | null null static getInstance(): PaymentManager { if (!PaymentManager.instance) { PaymentManager.instance new PaymentManager() } return PaymentManager.instance } /** * 注册支付渠道适配器 */ registerChannel(channel: PayChannel, adapter: ChannelAdapter): void { this.channels.set(channel, adapter) console.log(支付渠道注册成功: ${channel}) } /** * 发起支付 */ pay(info: PaymentInfo, callback: PaymentCallback): void { this.currentCallback callback const adapter this.channels.get(info.channel) if (!adapter) { callback.onFailed?.(-1, 支付渠道 ${info.channel} 未注册) return } // 参数校验 if (!this.validateParams(info)) { callback.onFailed?.(-2, 支付参数校验失败) return } // 调用具体渠道的支付逻辑 adapter.pay(info, { onSuccess: (result) { this.handleSuccess(result) }, onFailed: (code, msg) { this.handleFailed(code, msg) }, onCancel: () { this.handleCancel() } }) } /** * 参数校验 */ private validateParams(info: PaymentInfo): boolean { if (!info.orderId || !info.amount || info.amount 0) { return false } return true } private handleSuccess(result: PaymentResult): void { console.log(支付成功:, result) this.currentCallback?.onSuccess?.(result) } private handleFailed(code: number, msg: string): void { console.error(支付失败:, code, msg) this.currentCallback?.onFailed?.(code, msg) } private handleCancel(): void { console.log(支付取消) this.currentCallback?.onCancel?.() } } // 渠道适配器接口策略模式 export interface ChannelAdapter { pay(info: PaymentInfo, callback: PaymentCallback): void }3.3 实现具体渠道华为IAP适配器创建src/main/ets/core/adapters/HuaweiIAPAdapter.etsimport { iap } from kit.IAPKit import { PaymentCallback, ChannelAdapter, PaymentInfo, PaymentResult } from ../PaymentManager export class HuaweiIAPAdapter implements ChannelAdapter { async pay(info: PaymentInfo, callback: PaymentCallback): Promisevoid { try { // 1. 创建订单 const order await iap.createPurchaseOrder({ productId: info.productId!, quantity: info.quantity || 1 }) // 2. 发起支付 const payResult await iap.pay(order) // 3. 处理支付结果 if (payResult.returnCode 0) { const result: PaymentResult { orderId: info.orderId, transactionId: payResult.inAppPurchaseData?.inAppPurchaseData?.orderId || , channel: huawei_iap, rawData: JSON.stringify(payResult) } callback.onSuccess?.(result) } else { callback.onFailed?.(payResult.returnCode, payResult.errMsg || 支付失败) } } catch (err) { console.error(华为IAP支付异常:, err) callback.onFailed?.(-3, 支付过程发生异常) } } }3.4 定义对外API入口文件关键src/main/ets/index.ets是库的“脸面”必须清晰、简洁。// 核心类 export { PaymentManager } from ./core/PaymentManager export { HuaweiIAPAdapter } from ./core/adapters/HuaweiIAPAdapter // 导出枚举和接口方便使用者 export { PayChannel } from ./core/PaymentManager export type { PaymentCallback, PaymentResult } from ./core/PaymentManager export type { PaymentInfo } from ./models/PaymentInfo // 提供便捷的初始化函数 import { PaymentManager } from ./core/PaymentManager import { HuaweiIAPAdapter } from ./core/adapters/HuaweiIAPAdapter export function initPaymentKit(): PaymentManager { const manager PaymentManager.getInstance() // 默认注册华为IAP渠道 manager.registerChannel(PayChannel.HUAWEI_IAP, new HuaweiIAPAdapter()) return manager }3.5 配置库信息oh-package.json5{ name: harmony/payment-kit, version: 1.0.0, description: A universal payment kit for HarmonyOS, supporting multiple channels., main: src/main/ets/index.ets, author: listening777, license: Apache-2.0, keywords: [harmonyos, payment, iap, alipay, wechat], repository: { type: git, url: https://gitee.com/your_repo/payment-kit.git }, dependencies: { ohos/iap: ^1.0.0 // 声明对IAP Kit的依赖 }, devDependencies: { ohos/hypium: ^1.0.0 // 单元测试框架 }, ohos: { minAPIVersion: 11, // 支持的最低API版本 targetAPIVersion: 12 // 目标API版本 } }3.6 编写README.md门面担当# harmony/payment-kit 一个用于HarmonyOS的通用支付聚合库旨在简化多支付渠道的集成流程。 ## 特性 - **一键集成**一行代码初始化支持链式调用。 - **可扩展**通过适配器模式轻松接入新支付渠道。 - ️ **类型安全**完整的TypeScript类型定义。 - **跨端支持**基于ArkUI-X支持HarmonyOS、Android、iOS。 ## 安装bashohpm install harmony/payment-kit## 快速开始typescriptimport { initPaymentKit, PayChannel, PaymentInfo } from harmony/payment-kit// 1. 初始化const paymentKit initPaymentKit()// 2. 构建支付信息const info: PaymentInfo {orderId: ORDER_123456,amount: 99.8,currency: CNY,channel: PayChannel.HUAWEI_IAP,productId: product_001, // 华为IAP商品IDsubject: 测试商品}// 3. 发起支付paymentKit.pay(info, {onSuccess: (result) {console.log(支付成功:, result.transactionId)},onFailed: (code, msg) {console.error(支付失败:, code, msg)},onCancel: () {console.log(用户取消支付)}})## API文档 ### PaymentManager - registerChannel(channel: PayChannel, adapter: ChannelAdapter): 注册支付渠道。 - pay(info: PaymentInfo, callback: PaymentCallback): 发起支付。 ### PaymentInfo | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | orderId | string | 是 | 商户订单号 | | amount | number | 是 | 支付金额 | | channel | PayChannel | 是 | 支付渠道 | | productId | string | 否 | 商品IDIAP需要 | ## 贡献指南 欢迎PR请确保 1. 代码通过ohpm run lint检查。 2. 新增功能包含单元测试。 3. 更新README文档。 ## 许可证 Apache License 2.0四、踩坑记录官方文档没写的开源细节API设计的“洁癖”三方库的API一旦发布修改成本极高。原则宁缺毋滥。不要在1.0.0版本暴露过多的内部方法。使用export严格控制对外API内部类使用internal或文件夹隔离。资源命名的“隔离”如果库中使用了图片、字符串等资源务必添加前缀如pk_防止与主工程资源冲突。例如$r(app.media.pk_pay_icon)。多目标构建Multi-target Build如果库需要支持HarmonyOS和OpenHarmony社区版需要注意API差异。使用条件编译// 条件编译仅HarmonyOS支持 // ts-ignore if (canIUse(SystemCapability.ArkUI.ArkUI.Full)) { // HarmonyOS特有逻辑 }版本号的“敬畏”严格遵守语义化版本SemVer主版本.次版本.修订号。主版本不兼容的API修改如重构了支付流程。次版本向后兼容的功能新增如增加了新的支付渠道。修订号向后兼容的问题修正如修复了某个NullPointerException。OHPM发布的“门槛”首次发布需要实名认证个人或企业。包名name必须全局唯一且不能以ohos/开头那是官方包。建议使用组织名/包名的格式。
企业数字化 ERP 产品动态
相关推荐
HarmonyOS 6.1 跨端开发进阶:ArkUI-X从“一次开发”到“多端部署”的实战 系列跨平台篇第52篇。测试篇后,有跨端开发者问:“鸿蒙版做完了,老板又要iOS和Android版,难道要招两套人马重写?ArkUI-X到底靠不靠谱?” 这是跨端开发的终极痛点。今天我们将电商Demo通过ArkUI-X编译成iOS和… · 2026/10/7 21:28:31
AI工程化:技能框架与无向量RAG技术解析 1. AI工程化浪潮下的技术范式演进过去三年间,AI工程化领域正在经历从实验室原型到产业落地的关键转折。2026年初的技术动态显示,开发者工具链正在发生三个显著变化:技能框架标准化程度提升、检索增强生成(RAG)技术突破… · 2026/11/15 4:12:49
电工证分哪几个单位通过率揭秘:别再交钱白考了 电工证分哪几个单位通过率揭秘:别再交钱白考了 怕考不过白交培训费?你不是一个人。电工证作为特种作业操作证中最常见的证书之一,报考人数年年攀升,但真正能顺利通过考试、拿到证书的人却并不多。很多人辛辛苦苦交完培训费,结果因为不了解考试流程、题型… · 2026/11/17 14:37:48
电工作业安全手套真实经历:怎么选、怎么考、怎么用全解析 电工作业安全手套真实经历:怎么选、怎么考、怎么用全解析 你是不是也遇到过这样的情况:找电工证报名被中介坑,花了几千块,结果证书不靠谱,连电工作业安全手套都不会正确使用?这不只是我的真实经历,也是很多一线工友的共同心声。今天就从电工作业安全手… · 2026/11/17 14:37:48
低压电工证k24讲解保姆级教程:郑州建筑工人避坑指南 低压电工证k24讲解保姆级教程:郑州建筑工人避坑指南 你是不是也经常听工友说“低压电工证k24讲解”怎么考、考什么,但一到自己动手报名就发懵?不知道去哪报名怕被中介坑,这几乎是每个想考低压电工证的建筑工人都会遇到的痛点。今天这篇保姆级教程,… · 2026/11/17 14:37:48
江门电工证假的千万别踩坑,电工证怎么考才靠谱 江门电工证假的千万别踩坑,电工证怎么考才靠谱 急需特种作业证才能上岗找工作,很多电工朋友在江门地区跑了不少机构,却发现自己拿到的“电工证”可能是假的,不仅影响工作,还可能被单位追责,甚至面临法律风险。江门电工证假的千万别踩坑,选对渠道、了解… · 2026/11/17 14:37:48
家用清洗需要电工证吗?真实经历告诉你怎么过实操考试 家用清洗需要电工证吗?真实经历告诉你怎么过实操考试 实操考试心里没底怕挂科?别急,今天我以鹤壁项目现场管理员的身份,结合真实经历,和你聊聊家用清洗是否需要电工证,以及怎么准备实操考试才能一次通过。… · 2026/11/17 14:37:48
想怎么考电工证网上查询学历不高也能报上名 想怎么考电工证网上查询学历不高也能报上名 你是不是也担心自己学历不高,连电工证都考不了?别急,今天咱们就来聊聊 想怎么考电工证 这个问题,尤其是像你这样刚毕业的工程类学生, 网上查询 一下就知道,其实考电工证的门槛没有你想象的那么高。… · 2026/11/17 14:36:47
长春初级电工证怎么考?通过率揭秘全在这里 长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/17 5:38:05
国内电工证报考条件与考试时间 低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/17 5:38:05
电工作业时如何断电?电子证书到底能不能全国通用? 电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/17 9:06:35
安徽特种工考证学校千万别踩坑,学历不高也能考证上岗 安徽特种工考证学校千万别踩坑,学历不高也能考证上岗 你是不是总觉得学历不高就考不了证,连报名资格都够不上?其实,很多人和你一样,学历不占优势,但想通过考证转行或提升自己的职业竞争力。安徽特种工考证学校虽然门槛不高,但千万别踩坑,稍有不慎就会… · 2026/11/17 0:00:20
你没学历也能考福田特种作业操作证?真实经历告诉你怎么干 你没学历也能考福田特种作业操作证?真实经历告诉你怎么干 你是不是觉得学历不高就考不上福田特种作业操作证?其实不然,我有个老乡,初中毕业,现在在安阳干焊工,每月拿8000多,还评上了高级技师。他的经历我今天就给你说说,看看你能不能照着走。… · 2026/11/17 0:00:20
低压电工证哪里盖章怎么报名 过期了别慌教你一步步复审 低压电工证哪里盖章怎么报名 过期了别慌教你一步步复审 证书过期了不知道怎么复审延期?低压电工证是很多电工从业者必须持有的证件,一旦到期未及时办理复审,不仅影响工作,还可能面临被单位辞退甚至罚款。今天我就从南阳地区培训机构学员的角度,详细告诉… · 2026/11/17 0:00:20
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/16 16:48:43
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/16 16:48:57
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/16 16:48:48