概述
AppStartup提供了一种简单高效的初始化组件的方式,开发者可以使用AppStartup来显示的设置组件的初始化顺序以及之间的依赖关系,支持异步初始化组件加速应用的启动时间。开发者需要分别为待初始化的组件实现AppStartup提供的 StartupTask 接口,并在 startup_config.json 中配置AppStartup之间的依赖关系,每个StartupTask都是一个等待执行的启动任务,启动框架将使用拓扑排序保证各个启动任务的执行顺序。
说明
启动框架只支持在entry中使用。
开发流程
- 开启启动框架AppStartup:在 module.json5配置文件 配置文件中appStartup标签中指定启动框架配置文件的路径。
- 编写启动框架配置文件:在启动框架配置文件中,依次添加各个待初始化组件的配置信息,并指定启动框架参数的文件路径。
- 为每个待初始化组件添加启动任务:通过实现StartupTask接口,启动框架将会按顺序执行初始化流程。
- 设置启动框架参数:在启动框架参数文件中,设置超时时间和组件初始化的监听器等参数。
开发指导
开启启动框架AppStartup
开启启动框架后,当应用启动时系统将会读取开发者实现的配置文件并检查是否存在循环依赖,采用拓扑排序对其进行排序。开发者只需要在 module.json5配置文件 中配置appStartup标签, 并指定启动框架的配置文件路径即可开启启动框架。
{
"module": {
"name": "entry",
"type": "entry",
...
"appStartup": "$profile:startup_config",
...
}
}
编写启动框架配置文件
启动框架配置文件将为系统提供 StartupTask 的具体实现路径和参数设置,从而进行读取并执行相应的启动任务。该文件为JSON格式,应放在工程的resource目录下,配置文件路径需要与 module.json5配置文件 中appStartup标签指定的路径一致。启动任务之间不允许存在循环依赖,且每个启动任务的名称必须唯一。
示例代码如下。
{
"startupTasks": [
{
"name": "StartupTask_001",
"srcEntry": "./ets/startup/StartupTask_001.ets",
"dependencies": [
"StartupTask_002",
"StartupTask_003"
],
"runOnThread": "taskPool",
"waitOnMainThread": false
},
{
"name": "StartupTask_002",
"srcEntry": "./ets/startup/StartupTask_002.ets",
"dependencies": [
"StartupTask_004"
],
"runOnThread": "taskPool",
"waitOnMainThread": false
},
{
"name": "StartupTask_003",
"srcEntry": "./ets/startup/StartupTask_003.ets",
"dependencies": [
"StartupTask_004"
],
"runOnThread": "taskPool",
"waitOnMainThread": false
},
{
"name": "