HarmonyOS 鸿蒙Next中想了解一下手机钱包卡在鸿蒙应用上的开发流程以及是否需要对TSM平台做什么改造吗

HarmonyOS 鸿蒙Next中想了解一下手机钱包卡在鸿蒙应用上的开发流程以及是否需要对TSM平台做什么改造吗 【问题描述】：就是华为钱包上面的交通卡，之前我们安卓这端的应用已经接入了，现在考虑鸿蒙端后续要接入，对TSM平台需要做什么改造吗

【问题现象】：我们想开发钱包卡功能，，之前我们安卓这端的应用已经接入了，现在考虑鸿蒙端后续要接入，对TSM平台需要做什么改造吗

【版本信息】：未涉及

【复现代码】：未涉及

【尝试解决方案】：未涉及

6 回复

要对TSM平台做改造，查询订单接口要改造。

更多关于HarmonyOS 鸿蒙Next中想了解一下手机钱包卡在鸿蒙应用上的开发流程以及是否需要对TSM平台做什么改造吗的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


【解决方案】

开发者你好，是需要对TSM平台做改造的，查询订单接口要改造。

参考云端接口返回数据样例：

1、开卡+充值

1、新增addCardOpaqueData必须返回

2、status必须是900，代表支付成功

{
	"returnCode": "0",
	"returnDesc": "success",
	"orderCount": 1,
	"orderList": [{
		"orderNo": "xxx",
		"orderType": xxx,
		"issuerid": "xxx",
		"status": "xxx",
		"orderTime": "xxx",
		"currency": "xxx",
		"amount": "xxx",
		"cardNo": "xxx",
		"addCardOpaqueData": "xxx"
	}]
}

已解决

TSM平台不需要做专门的架构改造，它本质应该上是一个通过标准化接口提供服务的后端平台。

在HarmonyOS Next中开发手机钱包卡应用，需使用ArkTS语言，遵循鸿蒙应用开发规范。开发流程包括：设计UI界面、实现卡片数据管理、集成NFC功能模块、调用系统安全服务进行数据加密，并完成应用签名与上架。对于TSM平台，若鸿蒙Next的NFC和安全架构与现有TSM接口兼容，则无需改造；若不兼容，需适配鸿蒙的TEE（可信执行环境）和SE（安全元件）接口，确保TSM能安全下发和管理卡片数据。

针对HarmonyOS Next（鸿蒙Next）上开发手机钱包卡（如交通卡）功能，其核心流程与安卓端类似，但开发框架和接口已切换为HarmonyOS的ArkTS/ArkUI。关于TSM平台的改造需求，通常取决于鸿蒙侧新增的特定交互协议或安全要求。

主要开发流程如下：

  1. 申请资质与资源：在华为开发者联盟注册应用，并申请钱包相关的服务权限和证书。获取开发必需的AppID、证书等。
  2. 集成HMS Core钱包服务：HarmonyOS Next通过HMS Core提供钱包卡能力。需要在工程中集成Wallet Kit的SDK，并配置相应的依赖与权限。
  3. 实现卡数据准备与安全通道：应用侧（或配合服务端）需按照规范准备卡数据（如交通卡的发卡信息、用户信息等）。与TSM平台的交互，核心是建立安全通道（通常基于GP规范）来完成个人化数据的传输。这部分逻辑（如APDU指令组装、安全单元SE访问）应由应用侧或安全中间件处理。
  4. 调用HarmonyOS API发起开卡：使用HarmonyOS的@hw.wallet/walletKit等API，将准备好的卡数据通过钱包服务提供的接口传递给系统钱包，由系统完成向SE写入数据、添加卡面等流程。开发者主要关注与钱包服务的数据交互点。
  5. 测试与上架：使用真机进行全流程测试，完成后提交应用审核。

关于TSM平台是否需要改造：

通常不需要为HarmonyOS Next进行平台级的核心改造。 原因如下：

  • 协议层一致：TSM平台与终端设备（手机）之间的核心交互协议（如基于GP的远程管理、APDU指令集）是标准化的，与操作系统（Android或HarmonyOS）解耦。只要HarmonyOS侧的应用或安全中间件能够正确生成并传输符合GP规范的指令报文，TSM平台无需感知终端OS的变化。
  • 改造触发点：TSM平台的改造需求通常源于业务规则变化、新卡类型支持、安全等级提升或加密算法更新等，而非单纯的终端操作系统升级。
  • 开发侧适配：需要适配的工作主要在HarmonyOS应用侧。你需要确保：
    • 用于与TSM平台通信的网络模块（如发送HTTP/HTTPS请求）能正常工作。
    • 涉及SE访问、APDU处理的底层模块（可能涉及securityLabel、cryptoFramework等HarmonyOS安全API）能正确运行在HarmonyOS上。
    • 遵循HarmonyOS Wallet Kit的API规范来与系统钱包交互，而不是原来的安卓API。

总结： 从安卓迁移到HarmonyOS Next开发钱包卡功能，重点在于将应用侧代码（包括与TSM平台通信的逻辑）适配到HarmonyOS的开发框架和API。TSM平台本身通常无需为HarmonyOS进行特定改造，除非华为钱包服务对卡数据格式或安全交互流程提出了新的标准要求。建议详细查阅HarmonyOS官方文档中关于Wallet Kit的开发指南。

回到顶部