• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# HCE卡模拟开发指南
2
3### 介绍
4
5本示例通过使用[HCE卡模拟开发指南](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/connectivity/nfc/nfc-hce-guide.md)中各场景的开发示例，展示在工程中，帮助开发者更好地理解HEC功能并合理使用。该工程中展示的代码详细描述可查如下链接：
6[HCE卡模拟开发指南](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/connectivity/nfc/nfc-hce-guide.md)
7
8### 效果预览
9|启动界面|
10|-------|
11|<img src="./screenshots/image.jpeg" width="360;" /> |
12
13### 使用说明
14
151.启动应用
162.应用停留在启动界面
173.输出预期日志，功能启动
18
19### 工程目录
20entry/src/main/ets/   # HCE应用前台刷卡
21|---entryability
22|   |---EntryAbility.ets
23|---entrybackupability
24|   |---EntryBackupAbility.ets
25|---pages
26|   |---Index.ets
27entry1/src/main/ets/  # HCE应用后台刷卡
28|---entry1ability
29|   |---Entry1Ability.ets
30|---entry1backupability
31|   |---Entry1BackupAbility.ets
32|---pages
33|   |---Index.ets
34```
35
36### 具体实现
37
38#### HCE应用前台刷卡
391. 在module.json5文件中声明NFC卡模拟权限，以及声明HCE特定的action。
402. import需要的NFC卡模拟模块和其他相关的模块。
413. 判断设备是否支持NFC能力和HCE能力。
424. 使能前台HCE应用程序优先处理NFC刷卡功能。
435. 订阅HCE APDU数据的接收。
446. 完成HCE刷卡APDU数据的接收和发送。
457. 退出应用程序NFC刷卡页面时，退出前台优先功能。
46
47#### HCE应用后台刷卡
481. 在module.json5文件中声明NFC卡模拟权限，声明HCE特定的action，声明应用能够处理的AID。
492. import需要的NFC卡模拟模块和其他相关的模块。
503. 判断设备是否支持NFC能力和HCE能力。
514. 订阅HCE APDU数据的接收。
525. 完成HCE刷卡APDU数据的接收和发送。
536. 退出应用程序时，退出订阅功能。
54
55### 相关权限
56
57[ohos.permission.NFC_CARD_EMULATION](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/AccessToken/permissions-for-all.md#ohospermissionnfc_card_emulation)
58
59### 依赖
60
61不涉及。
62
63### 约束与限制
64
651.本示例仅支持标准系统上运行, 支持设备：RK3568。
66
672.本示例为Stage模型，支持API14版本SDK，版本号：5.0.2.57，镜像版本号：OpenHarmony_5.0.2.57。
68
693.本示例需要使用DevEco Studio NEXT Developer Preview2 (Build Version: 5.0.5.306， built on December 12, 2024)及以上版本才可编译运行。
70
71### 下载
72
73如需单独下载本工程，执行如下命令：
74
75````
76git init
77git config core.sparsecheckout true
78echo code/DocsSample/ConnectivityKit/NFC/HCECardSimulationDevelopment/ > .git/info/sparse-checkout
79git remote add origin https://gitee.com/openharmony/applications_app_samples.git
80git pull origin master
81````