Harmony 鸿蒙

WARNING

！！！目前鸿蒙支持 CocosCreator 3.8.7 和 Unity（团结引擎）开发的游戏！！！

1、SDK层做了适配，鸿蒙整体上对接方式和Android和iOS一致，接口不变，但是目前只支持了部分接口。

2、同时，鸿蒙使用的出包方式也和Android/iOS不同，由于鸿蒙打包复杂，且打包时就需要签名验证，所以我方准备采用一种全新的打包方式，即CP游戏引擎直接导出资源，压缩成zip包发给我方运营同学，我方来进行直接打包。

3、解密方式修改，鸿蒙只支持最新版本资源加密出包方式

鸿蒙支持接口

`` 鸿蒙在启动时，GameHelper.init 之后，需要额外调用一下 GameHelper.App.startGameForH5Static() 方法

基础功能模块

均已支持

广告模块

均已支持

支付模块

目前只支持消耗型商品购买，对于一次性商品和订阅商品不支持，同时恢复购买等接口也不生效

登录模块

强制登录，无接口，暂无存档

统计模块

均支持

其他模块

重点支持了敏感词接口，其他接口部分支持，持续补充中

出包方式

Cocos出包方式

请根据游戏资源导入工程这部分文档内容，获取到游戏资源的so和assets文件，然后按照以下格式，压缩成zip文件，上传给我方即可。

Unity 出包方式

Unity（团结引擎）项目支持以下两种资源包：

• 完整的 HarmonyOSWithSource.zip
• 仅包含游戏运行所需文件的精简资源包

上传完整工程资源包时，系统会自动查找以下目录；压缩包外层额外包含一层 HarmonyOSWithSource 目录也可以正常识别：

• tuanjieLib/libs
• tuanjieLib/src/main/resources/rawfile

资源会根据打包模板中 autospec_engine.json 的配置，自动复制到 entry 或 tuanjieLib。该逻辑不会影响原有 Cocos 项目的 assets + libs 上传方式。

推荐的最小压缩包

正常的 Unity/IL2CPP 游戏建议按照以下结构整理并上传：

UnityHarmonyResource.zip
├─ libs
│  ├─ classesLib.har
│  └─ arm64-v8a
│     ├─ libil2cpp.so
│     ├─ libtuanjie.so
│     └─ lib_burst_generated.so     # 使用 Burst 时需要
└─ resources
   └─ rawfile
      └─ Data
         ├─ boot.config
         ├─ data.tj3d
         ├─ Managed
         │  ├─ Metadata
         │  │  └─ global-metadata.dat
         │  └─ Resources
         ├─ RuntimeInitializeOnLoads.json
         ├─ ScriptingAssemblies.json
         ├─ tuanjie default resources
         └─ tuanjie_app_guid

TIP

建议保留完整的 resources/rawfile/Data 目录，不要继续拆分其中的文件。该目录内容与 Unity 项目的代码裁剪、程序集和 Burst 配置有关，完整上传最为稳妥。

如果本地没有 uac_spec.json，还可以通过请求中的 resource.tuanjieVersion 或 resource.engineVersion 选择 Unity 模板。例如，2022.3.62t11 会按照 2022.3.62 匹配到 unity_tuanjie_192 模板。

资源加解密

请参考 资源加密出包