1 应用生命周期适配

HarmonyOS NEXT游戏启动、运行、销毁时分别对应不同的生命周期，游戏适配需将引擎在Native侧的生命周期与应用的生命周期绑定，实现不同状态之间的切换。游戏场景下，应用主要生命周期时序大致如下图所示：

HarmonyOS NEXT游戏通过UIAbility组件与用户进行交互，当用户打开、切换应用以及关闭应用时，应用中的UIAbility实例会在其生命周期的不同状态之间转换。

在Stage模型下，应用主窗口由UIAbility创建并维护生命周期，UIAbility的生命周期包括Create、Foreground、Background、Destroy四个状态，与显示相关的状态通过WindowStage的事件暴露给开发者。

新建DevEco Studio工程时，将在entry/src/main/ets/entryability目录下默认生成UIAbility，其中包含常用的生命周期回调，其中nativeAppLifecycle是引擎在Native侧的生命周期。

常用的UIAbility生命周期回调

onCreate()：在应用加载过程中，UIAbility实例创建完成时触发Create状态，此时系统会调用onCreate()回调。可以在该回调中进行页面初始化操作，例如变量定义资源加载等，用于后续的UI展示。
onDestroy()：在销毁时回调，执行资源清理等操作。
onForeground()：当应用从后台转到前台时触发。
onBackground()：当应用从前台转到后台时触发。

在UIAbility实例创建完成之后，在进入Foreground之前，系统会创建一个WindowStage。

常用的WindowStage生命周期回调

onWindowStageCreate()：当WindowStage创建完成后调用；可以在该回调中设置UI加载、设置WindowStage的事件订阅。
onWindowStageDestroy()：当WindowStage销毁后调用。

Page的生命周期

应用的UI页面可由一个或者多个自定义组件组成。一般基本页面需由@Entry @Component这两个组件进行装饰。

@Entry装饰的自定义组件为页面的入口组件，即页面的根节点，一个页面有且仅能有一个@Entry。只有被@Entry装饰的组件才可以调用页面的生命周期。
@Component：@Component装饰的UI单元为自定义组件，可组合多个系统组件实现UI的复用

每个Stage模型的DevEco Studio工程会默认创建一个Page(entry/src/main/ets/pages/Index.ets)页面生命周期，被@Entry装饰的组件生命周期可提供以下生命周期接口：

组件生命周期，被@Component装饰的自定义组件的生命周期可提供以下生命周期接口：

被@Entry和@Component装饰的页面中可定义如下的生命周期接口的调用顺序如下：

Index.ets页面如下：

XComponent组件生命周期

XComponent组件作为一种绘制组件，通常用于满足开发者较为复杂的自定义绘制需求。开发者可使用XComponent组件来进行EGL/OpenGLES渲染的开发和媒体数据写入。

若对XComponent进行Native 开发，需要在ArkTS侧和Native侧进行开发。Native XComponent是XComponent组件提供在Native侧的实例，可作为JS层和Native层XComponent绑定的桥梁。在ArkTS侧使用XComponent组件并选择surface；在Native侧开发需对ArkUI XComponent所持有的surface和触摸事件注册相应的回调。

若在主页面绘制图形，需在Native侧注册surface生命周期和触摸事件回调。借助XComponent进行EGL/OpenGLES的渲染开发步骤见渲染一节。

ArkTS侧代码如下，其中有onLoad()和onDestroy()事件。

Native侧surface生命周期相关Callback的定义如下：

XComponent组件ArkTS层和Native层的时序对应如下：

1. onLoad事件

定义：组件加载完成时回调事件。

触发时刻：当XComponent准备好surface后触发。

参数context：context上挂载了暴露在模块上(nativerender.so)的Native方法。

XComponent中的libraryname的作用类似于import某个so模块，因此context的使用方法类似于利用 import context from "libnativerender.so"直接加载模块后获得的context实例时序：onLoad事件的触发和surface相关，其和Native侧的OnSurfaceCreated的时序如下图：

2. 组件改变事件

定义：当组件UI发生变化引起重绘时的回调事件。

触发时刻：当XComponent的surface发生变化时，会触发OnSurfaceChangedCB对当前的XComponent持有的surface对象进行重新绘制，使得其生成相应的内容重新展示出来。例如当一个surface的尺寸、模式或者其他位置发生变化时（常见于折叠屏、屏幕旋转），OnSurfaceChangedCB就会被调用。

3. onDestroy事件

定义：插件卸载完成时回调事件。

触发时刻：XComponent组件被销毁时触发与一般ArkUI的组件销毁时机一致。

时序：其和Native侧的OnSurfaceDestroyed的时序如下图：