# CCHarmonyExamples

**Repository Path**: lulonghai/CCHarmonyExamples

## Basic Information

- **Project Name**: CCHarmonyExamples
- **Description**: Cocos creator游戏鸿蒙化的一些demo
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 2
- **Created**: 2025-03-20
- **Last Updated**: 2025-08-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

**本仓库已迁移至新仓库：[https://gitee.com/ohgameport/OHGamePort](https://gitee.com/ohgameport/OHGamePort)，后续该仓库不再更新，请移步新仓库**
# 工具准备
工欲善其事必先利其器，在进行适配之前进行完善的工具准备将是十分必要的，会达到事半功倍的效果  
1. 首先需要准备一台支持HarmonyOS Next5.0系统的手机，可以参考[HarmonyOs Next5.0支持机型](https://consumer.huawei.com/cn/support/harmonyos/models-next/)来查看哪些手机能够升级成5.0版本，然后根据[公测报名尝鲜指导](https://cn.club.vmall.com/mhw/consumer/cn/community/mhwnews/article/id_1000000000001931529/)来升级手机版本至5.0版本，升级尝鲜审核通过后在若干天内会推送5.0的系统版本，如果着急的话可以打客服电话950800找人工客服加急处理推送，记得把序列号提供给客服
2. 需要下载最新5.x的**release**版本的DevEco，可以从[最新版本DevEco下载地址](https://developer.huawei.com/consumer/cn/download/)来下载，有些同学以前也使用过DevEco，版本可能是2.x、3.x，4.x，这些版本都不能用，均需下载最新的5.x**release**版本
3. 需要下载最新的引擎版本，2.4.x最新的为2.4.15版本，3.8.x最新的为3.8.6版本，最新版本的引擎针对鸿蒙Next平台做了大量的适配，避免开发者再进行额外的适配工作，最新的正式版本引擎可从Dashboard上直接下载
# 适配过程
首先贴出官方指导，官方对于cocos creator的鸿蒙化适配有一个专题：[相关链接](https://developer.huawei.com/consumer/cn/forum/subject/2104176721393942002)  
1. 首先第一步就是升级引擎版本，对于2.x的版本需要升级到2.4.15版本，对于3.x版本需要升级到3.8.6版本，引擎升级完成后可以先出个安卓包，验证下功能，这样可以保证引擎升级这一步没有问题，不然和适配鸿蒙的问题糅合在一起会比较麻烦。友情提醒下，有些伙伴会定制引擎，升级引擎版本的时候别忘记把定制化的内容同步到新版本上哦
2. 查看cocos脚本中是否有对于不同平台进行适配，如果有的话也需要增加对于鸿蒙平台的适配
3. 导出**HarmonyOS Next工程**，并针对自身需求调整构建参数
4. 接入账号登录与应用内支付，账号登录可以参考[游戏服务接入指南](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/gameservice-introduction)和[应用内支付接入指南](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/iap-introduction)
5. 接入完成后可以联系鸿蒙适配交流群中的技术支持进行验收，验收通过有就可以提审了，至此就完成了整个鸿蒙化过程

# 一些Demo
| Demo名称 | Demo地址 | 文档链接 |
| -- | -- | -- |
| cocos与arkts交互demo | [2.4.15版本demo](https://gitee.com/lulonghai/CCHarmonyExamples/blob/master/cocos-interaction-demo/2.4.15/cid/README.md), [3.8.6版本demo](https://gitee.com/lulonghai/CCHarmonyExamples/blob/master/cocos-interaction-demo/3.8.6/cid/README.md) | [基于反射机制实现 JavaScript 与 HarmonyOS Next 系统原生通信(2.4)](https://docs.cocos.com/creator/2.4/manual/zh/advanced-topics/arkts-reflection.html)，[基于反射机制实现 JavaScript 与 HarmonyOS Next 系统原生通信(3.8)](https://docs.cocos.com/creator/3.8/manual/zh/advanced-topics/arkts-reflection.html) |
| Game Service Kit（游戏服务）接入demo | [Game Service Kit Demo](https://gitee.com/shengqizhou/hmos-next-account-2.0/tree/account2.1/) | [Game Service Kit简介](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/gameservice-introduction) |
| IAP Kit（应用内支付服务）接入demo | [IAP Kit Demo](https://gitee.com/harmonyos_samples/iapkit-sample-clientdemo-arkts) | [IAP Kit简介](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/iap-introduction) |
| Ads Kit（广告服务）接入demo | [Ads Kit Demo](https://gitee.com/harmonyos_samples/ads-kit-sample-code-client-demo-arkts) | [Ads Kit简介](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ads-introduction) |



# FAQ
验收常常会反馈一些问题，这边总结了一些常见的问题以及对应的解决方法
| 验收问题 | 解决方案 |
| -- | -- |
| 折叠屏适配问题 | [如何适配折叠屏问题](https://gitee.com/lulonghai/CCHarmonyExamples/blob/master/docs/%E5%A6%82%E4%BD%95%E9%80%82%E9%85%8D%E6%8A%98%E5%8F%A0%E5%B1%8F%E9%97%AE%E9%A2%98.md) |
| 摄像头/刘海遮挡了UI显示问题 | [如何适配刘海屏、挖空屏等异形屏](https://gitee.com/lulonghai/CCHarmonyExamples/blob/master/docs/%E5%A6%82%E4%BD%95%E9%80%82%E9%85%8D%E5%88%98%E6%B5%B7%E5%B1%8F%E3%80%81%E6%8C%96%E7%A9%BA%E5%B1%8F%E7%AD%89%E5%BC%82%E5%BD%A2%E5%B1%8F.md) |
| 无法拉起支付问题 | [如何修改无法拉起支付的问题](https://gitee.com/lulonghai/CCHarmonyExamples/blob/master/docs/%E5%A6%82%E4%BD%95%E4%BF%AE%E6%94%B9%E6%97%A0%E6%B3%95%E6%8B%89%E8%B5%B7%E6%94%AF%E4%BB%98%E7%9A%84%E9%97%AE%E9%A2%98.md) | 
| 侧滑一次退出/侧滑无响应问题 | [如何修改侧滑相关的问题](https://gitee.com/lulonghai/CCHarmonyExamples/blob/master/docs/%E5%A6%82%E4%BD%95%E4%BF%AE%E6%94%B9%E4%BE%A7%E6%BB%91%E7%9B%B8%E5%85%B3%E7%9A%84%E9%97%AE%E9%A2%98.md) |
| 屏幕旋转锁定仍可旋转问题 | [如何修改屏幕旋转问题](https://gitee.com/lulonghai/CCHarmonyExamples/blob/master/docs/%E5%A6%82%E4%BD%95%E4%BF%AE%E6%94%B9%E5%B1%8F%E5%B9%95%E6%97%8B%E8%BD%AC%E9%97%AE%E9%A2%98.md) |
| 平板上横屏游戏可竖屏旋转/竖屏游戏可横屏旋转问题 | [如何修改平板上竖屏游戏横屏显示的问题](https://gitee.com/lulonghai/CCHarmonyExamples/blob/master/docs/%E5%A6%82%E4%BD%95%E4%BF%AE%E6%94%B9%E5%B9%B3%E6%9D%BF%E4%B8%8A%E7%AB%96%E5%B1%8F%E6%B8%B8%E6%88%8F%E6%A8%AA%E5%B1%8F%E6%98%BE%E7%A4%BA%E7%9A%84%E9%97%AE%E9%A2%98.md) |
| 复制ID无效果问题 | [如何修改无法复制黏贴的问题](https://gitee.com/lulonghai/CCHarmonyExamples/blob/master/docs/%E5%A6%82%E4%BD%95%E4%BF%AE%E6%94%B9%E6%97%A0%E6%B3%95%E5%A4%8D%E5%88%B6%E9%BB%8F%E8%B4%B4%E7%9A%84%E9%97%AE%E9%A2%98.md) |
| 游戏启动时闪现ICON问题 | [如何修改游戏启动时闪现ICON的问题](https://gitee.com/lulonghai/CCHarmonyExamples/blob/master/docs/%E5%A6%82%E4%BD%95%E4%BF%AE%E6%94%B9%E6%B8%B8%E6%88%8F%E5%90%AF%E5%8A%A8%E6%97%B6%E9%97%AA%E7%8E%B0ICON%E7%9A%84%E9%97%AE%E9%A2%98.md) |
| 游戏过程中自动息屏问题 | [如何修改游戏过程中自动息屏的问题](https://gitee.com/lulonghai/CCHarmonyExamples/blob/master/docs/%E5%A6%82%E4%BD%95%E4%BF%AE%E6%94%B9%E6%B8%B8%E6%88%8F%E8%BF%87%E7%A8%8B%E4%B8%AD%E8%87%AA%E5%8A%A8%E6%81%AF%E5%B1%8F%E7%9A%84%E9%97%AE%E9%A2%98.md) |
| 闹钟畅联结束后游戏不恢复背景音乐问题 | [如何修改闹钟畅联结束，游戏没声音的问题](https://gitee.com/lulonghai/CCHarmonyExamples/blob/master/docs/%E5%A6%82%E4%BD%95%E4%BF%AE%E6%94%B9%E9%97%B9%E9%92%9F%E7%95%85%E8%81%94%E7%BB%93%E6%9D%9F%EF%BC%8C%E6%B8%B8%E6%88%8F%E6%B2%A1%E5%A3%B0%E9%9F%B3%E7%9A%84%E9%97%AE%E9%A2%98.md) |
| 软键盘弹出遮蔽输入框问题 | [如何在官方账号登陆时做软键盘的避让](https://gitee.com/lulonghai/CCHarmonyExamples/blob/master/docs/%E5%A6%82%E4%BD%95%E5%9C%A8%E5%AE%98%E6%96%B9%E8%B4%A6%E5%8F%B7%E7%99%BB%E9%99%86%E6%97%B6%E5%81%9A%E8%BD%AF%E9%94%AE%E7%9B%98%E7%9A%84%E9%81%BF%E8%AE%A9.md) |
| 手机底部横条遮挡游戏画面问题 | [如何消除底部横条](https://gitee.com/lulonghai/CCHarmonyExamples/blob/master/docs/%E5%A6%82%E4%BD%95%E6%B6%88%E9%99%A4%E5%BA%95%E9%83%A8%E6%A8%AA%E6%9D%A1.md) |
| 点击适龄提示无响应问题 | [如何修改点击适龄无响应问题](https://gitee.com/lulonghai/CCHarmonyExamples/blob/master/docs/%E5%A6%82%E4%BD%95%E4%BF%AE%E6%94%B9%E7%82%B9%E5%87%BB%E9%80%82%E9%BE%84%E6%97%A0%E5%93%8D%E5%BA%94%E9%97%AE%E9%A2%98.md) |
| 上架后游戏在应用市场/游戏中心搜不到的问题 | [为什么上架后游戏在应用市场和游戏中心都搜索不到](https://gitee.com/lulonghai/CCHarmonyExamples/blob/master/docs/%E4%B8%BA%E4%BB%80%E4%B9%88%E4%B8%8A%E6%9E%B6%E5%90%8E%E6%B8%B8%E6%88%8F%E5%9C%A8%E5%BA%94%E7%94%A8%E5%B8%82%E5%9C%BA%E5%92%8C%E6%B8%B8%E6%88%8F%E4%B8%AD%E5%BF%83%E9%83%BD%E6%90%9C%E7%B4%A2%E4%B8%8D%E5%88%B0.md) |


# 参考资料
* [Cocos creator鸿蒙化过程中可能会用到的一些demo](https://gitee.com/lulonghai/CCHarmonyExamples)，如果对于demo有需求的话可以联系我进行更新
* [Cocos creator游戏如何适配HarmonyOs Next](https://developer.huawei.com/consumer/cn/forum/subject/2104176721393942002)
* [游戏服务接入指南](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/gameservice-introduction)
* [应用内支付接入指南](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/iap-introduction)
* [HarmonyOs Next5.0支持机型](https://consumer.huawei.com/cn/support/harmonyos/models-next/)
* [HarmonyOs Next5.0系统升级指导](https://cn.club.vmall.com/mhw/consumer/cn/community/mhwnews/article/id_1000000000001931529/)
* [最新版本DevEco下载地址](https://developer.huawei.com/consumer/cn/download/)