# 游戏鸿蒙化资料汇总

**Repository Path**: harrysimply/openharmony-game-wiki

## Basic Information

- **Project Name**: 游戏鸿蒙化资料汇总
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-04-03
- **Last Updated**: 2025-09-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 游戏鸿蒙化资料汇总

![团结引擎 2025.1](https://img.shields.io/badge/团结引擎-1.6.x-blue?style=flat&labelColor=black) ![ 鸿蒙](https://img.shields.io/badge/Deveco%20Studio-5.0.x-blue?style=flat&labelColor=black)   


## 1.概述

包含游戏鸿蒙化指导文档与 demo， 当前文档以Unity引擎游戏适配为主。


## 2. 入门资料

游戏开发者可以参考以下资料：

1、当前Unity游戏都通过升级团结引擎导出游戏到鸿蒙平台。团结引擎使用指导： https://gitee.com/swallowguo/tuanjie-engine-oh 

2、当前团结引擎支持导出工程到deveco studio里面，通过deveco studio导出游戏（类似于AS）。deveco studio下载地址： https://developer.huawei.com/consumer/cn/download/

3 、鸿蒙工程使用的编程语言主要是arkts。arkts编程语言的指导文档：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/start-overview

4 、Unity游戏鸿蒙化的一般流程： （1） 分析三方SDK，例如xlua等三方组件要使用鸿蒙版本 （2）游戏升级团结引擎，并在鸿蒙真机上导出hap包点亮游戏（3）接入登录支付等华为上架kit，对折叠屏进行适配 （4）验收测试 （5）提审 （6）上架

## 3.   进阶资料

1、[鸿蒙平台跨语言调用指导:C#和ArkTs互相调用](./wiki/openharmony-game-cross-platform-call.md) 

> 鸿蒙平台的适配，尤其是很多安卓java 写的逻辑，都需要通过鸿蒙的 arkts 重写。因此需要了解 C#和 Arkts 互相调用的方式。
>
> 示例团结工程： [工程地址](./demo/tuanjie-csharp-call-arkts/) / [unitypackage](./packages/tuanjie-csharp-call-arkts.unitypackage) 

2、[鸿蒙工程中的 ui 线程和 worker 线程](./wiki/openharmony-game-ui-worker-thread-conception.md)

> 开发者在适配鸿蒙插件的时候，如果有时候调用某些系统接口的时候和 网上demo 示例代码表现不一致，有非常大概率是在 worker 线程调用了某些只能在 ui 线程发起调用的方法，因此需要了解Tuanjie 导出鸿蒙工程里面的 ui 线程和 worker 线程，来规避相关问题。

3、 [三方库的鸿蒙化适配：以 xlua/xlua-protobuf 为例](./wiki/xlua-with-protobuf-openharmony-support.md) 

> 一些开源三方库如 xlua，开发者可以找到对应的C/C++源码，但是有时候没有找到满足要求的鸿蒙产物，就需要使用鸿蒙的 Cmake 工具链自己编译一下，唯一困难的就是要自己配一下 cmake 的环境变量。

4、[通过流水线构建鸿蒙产物指引](./wiki/openharmony-game-ci-build-hap.md) 

> 当前版本的 Tuanjie 引擎无论是通过命令行导鸿蒙工程或是直接导鸿蒙产物，基本上都可以满足要求。

## 4. 适配常见场景

|  场景 |  适配指导 | 示例工程 |
| :-| :-| :- |
| 隐私协议弹窗| [鸿蒙游戏接入隐私协议与用户协议弹窗](./wiki/openharmony-game-privacy-dialog.md)  | [demo (arkts 工程)](./demo/privacy-dialog-demo/) |
| 华为账号登录|[团结引擎鸿蒙单机游戏账号接入](./wiki/single-player-openharmony-game-account.md)|
| 折叠屏适配|[折叠屏问题适配指导](./wiki/openharmony-game-fold-screen-adapt.md)|[通用折叠屏适配demo](./demo/tuanjie-foldscreen-adapt-demo/) <br>[监听折叠屏变化传回游戏 demo](./demo/tuanjie-foldstatus-notice-demo/) |
| Webview| [团结引擎的鸿蒙Webview](./wiki/openharmony-game-with-webview.md)| [通用 webviewdemo（团结）](./demo/tuanjie-webview-demo/) |




## 5. FAQ

#### Q1: 我的游戏是通过 Unity 制作的，必须要升级到团结引擎才能支持鸿蒙平台吗？

A1:  是的，当前只有团结引擎支持鸿蒙平台导出，需要将 Unity 引擎升级到团结引擎，才能导出鸿蒙工程。

#### Q2：团结引擎可以直接构建出 hap 包吗？

A2: 可以。当前最新版本（1.6.3）版本，在 `Player Setting` - `Publishing Settings` 配置好自定义的 keystore 文件、证书文件、以及 profile 文件后，就可以通过`Build`按钮直接出鸿蒙包体（包含`.app`和`.hap`文件）。

#### Q3: 游戏运行在鸿蒙真机上面有团结水印影响游戏上架吗？

A3:  当前游戏带水印不影响游戏审核上架，如需去除水印请联系团结引擎商务。

#### Q4：游戏右下角"Not for Release"的水印是怎么回事？

A4： 根据实践经验，团结引擎1.6.0 版本以后，个人版证书的引擎会在打出包后会在第三天左右的时候出现“Not for release”水印，如需去除，操作方式同 Q3 。

#### Q5: 我还能从哪里获取到游戏鸿蒙化的资料？

A5:    [开发者联盟-鸿蒙游戏移植](https://developer.huawei.com/consumer/cn/games/game-porting)