鸿蒙5.0开发进阶：Stage模型-@ohos.app.appstartup.startupManager

最新推荐文章于 2025-11-25 18:40:54 发布
原创 最新推荐文章于 2025-11-25 18:40:54 发布 · 832 阅读 · 23 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#harmonyos #华为 #android #前端 #鸿蒙系统 #ArkUI #Stage模型

往期鸿蒙全套实战文章必看：（文中附带全栈鸿蒙学习资料）

@ohos.app.appstartup.startupManager

本模块提供应用启动框架管理启动任务的能力，只能在主线程调用。

说明

本模块首批接口从API version 12开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

本模块接口仅可在Stage模型下使用。

导入模块

import { startupManager }  from '@kit.AbilityKit';

startupManager.run

run(startupTasks: Array<string>, config?: StartupConfig): Promise<void>

执行启动框架。

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AppStartup

参数：

参数名类型必填说明
startupTasksArray<string>是表明准备执行的启动任务所实现的StartupTask接口的类名称数组。
configStartupConfig否启动框架超时时间与启动任务监听器配置。

返回值：

类型说明
Promise<void>Promise对象。无返回结果的Promise对象。

错误码：

以下错误码详细介绍

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
16000050Internal error.
28800001Startup task or its dependency not found.
28800002The startup tasks have circular dependencies.
28800003An error occurred while running the startup tasks.
28800004Running startup tasks timeout.

示例：：

import { AbilityConstant, UIAbility, Want, startupManager } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
    let startParams = ['StartupTask_001'];
    try {
      // 手动调用run方法
      startupManager.run(startParams).then(() => {
        console.log('StartupTest startupManager run then, startParams = ');
      }).catch((error: BusinessError) => {
        console.info("StartupTest promise catch error, error = " + JSON.stringify(error));
        console.info("StartupTest promise catch error, startParams = "
          + JSON.stringify(startParams));
      })
    } catch (error) {
      let errMsg = JSON.stringify(error);
      let errCode: number = error.code;
      console.log('Startup catch error , errCode= ' + errCode);
      console.log('Startup catch error ,error= ' + errMsg);
    }
  }
  // ...
}

startupManager.removeAllStartupTaskResults

removeAllStartupTaskResults(): void

删除所有启动任务结果。

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AppStartup

示例：：

import { AbilityConstant, UIAbility, Want, startupManager } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';
import { hilog } from '@kit.PerformanceAnalysisKit';

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
    startupManager.run(['StartupTask_001']).then(() => {
      console.info("StartupTask_001 init successful");
    })
  }

  onWindowStageCreate(windowStage: window.WindowStage) {
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
    startupManager.removeAllStartupTaskResults(); // 移除所有启动任务结果

    windowStage.loadContent('pages/Index', (err, data) => {
      if (err.code) {
        hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
        return;
      }
      hilog.info(0x0000, 'testTag', 'Succeeded in loading the content. Data: %{public}s', JSON.stringify(data) ?? '');
    });
  }
}

startupManager.getStartupTaskResult

getStartupTaskResult(startupTask: string): Object

获得指定的启动任务结果。

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AppStartup

参数：

参数名类型必填说明
startupTaskstring是启动任务实现StartupTask接口的文件名，所有启动任务都需要实现StartupTask接口的方法。

返回值：

类型说明
Object指定启动任务的结果。

错误码：

以下错误码详细介绍

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：：

import { AbilityConstant, UIAbility, Want, startupManager } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';
import { hilog } from '@kit.PerformanceAnalysisKit';

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
    startupManager.run(['StartupTask_001']).then(() => {
      console.info("StartupTask_001 init successful");
    })
  }

  onWindowStageCreate(windowStage: window.WindowStage) {
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
    let result = startupManager.getStartupTaskResult('StartupTask_001'); // 手动获取启动任务结果
    console.info("getStartupTaskResult result = " + result);
    windowStage.loadContent('pages/Index', (err, data) => {
      if (err.code) {
        hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
        return;
      }
      hilog.info(0x0000, 'testTag', 'Succeeded in loading the content. Data: %{public}s', JSON.stringify(data) ?? '');
    });
  }
}

startupManager.isStartupTaskInitialized

isStartupTaskInitialized(startupTask: string): boolean

获取指定启动任务是否已初始化。

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AppStartup

参数：

参数名类型必填说明
startupTaskstring是启动任务实现StartupTask接口的类名称。

返回值：

类型说明
boolean返回布尔值，true表示该启动任务已执行完成，false表示该启动任务尚未执行完成。

错误码：

以下错误码详细介绍

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：：

import { AbilityConstant, UIAbility, Want, startupManager } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';
import { hilog } from '@kit.PerformanceAnalysisKit';

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
    startupManager.run(['StartupTask_001']).then(() => {
      console.info("StartupTask_001 init successful");
    })
  }

  onWindowStageCreate(windowStage: window.WindowStage) {
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
    let result = startupManager.isStartupTaskInitialized('StartupTask_001');
    if (result) {
      console.info("StartupTask_001 init successful");
    } else {
      console.info("StartupTask_001 uninitialized");
    }

    windowStage.loadContent('pages/Index', (err, data) => {
      if (err.code) {
        hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
        return;
      }
      hilog.info(0x0000, 'testTag', 'Succeeded in loading the content. Data: %{public}s', JSON.stringify(data) ?? '');
    });
  }
}

startupManager.removeStartupTaskResult

removeStartupTaskResult(startupTask: string): void

删除指定初始化结果。

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AppStartup

参数：

参数名类型必填说明
startupTaskstring是启动任务所实现StartupTask接口的类名称。

错误码：

以下错误码详细介绍

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例：：

import { AbilityConstant, UIAbility, Want, startupManager } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';
import { hilog } from '@kit.PerformanceAnalysisKit';

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
    startupManager.run(['StartupTask_001']).then(() => {
      console.info("StartupTask_001 init successful");
    })
  }

  onWindowStageCreate(windowStage: window.WindowStage) {
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
    startupManager.removeStartupTaskResult('StartupTask_001');

    windowStage.loadContent('pages/Index', (err, data) => {
      if (err.code) {
        hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
        return;
      }
      hilog.info(0x0000, 'testTag', 'Succeeded in loading the content. Data: %{public}s', JSON.stringify(data) ?? '');
    });
  }
}

鸿蒙NEXT开发：Stage模型能力的接口-@ohos.app.appstartup.startupManager
ZPYQAQ的博客
02-27 696
本模块提供应用启动框架管理启动任务的能力，只能在主线程调用。
鸿蒙5.0实战案例：应用启动框架AppStartup应用场景分析
Maniu_666的博客
04-02 494
自动模式下启动框架的执行顺序在创建AbilityStage和执行AbilityStage onCreate回调之间。那启动框架内的任务执行顺序是什么样子呢？基于以下配置，进行任务时序分析。
【Unity启动管理插件】Startup Manager 2 简化和优化游戏的启动过程和初始化流程
2403_88403568的博客
10-30 865
Startup Manager 2 是一款 Unity 插件，旨在简化和优化游戏的启动过程和初始化流程。该插件为开发者提供了一种便捷的方式来管理游戏启动时的各种设置和加载操作，确保游戏能够快速且流畅地启动。无论是大型项目还是小型独立游戏，Startup Manager 2 都能帮助开发者更好地控制游戏的启动流程。
HiBit Startup Manager（电脑开机启动项管理软件）官方中文版V2.3.20 | 电脑启动项管理工具下载
chaorenqiang的博客
03-17 5332
HiBit Startup Manager是一款简单实用的电脑开机启动项管理软件，拥有易于使用的用户界面，可以帮助用户轻松管理Windows系统启动时自动加载的所有应用程序的列表，允许用户自由添加、编辑、禁用和删除windows自启动的应用程序，通过启动监控增强系统安全性、延迟或者禁止随机启动的应用程序，提高计算机的整体性能的同时还可以解决系统加载时烦人的错误信息，另外HiBit Startup Manager还具备管理和优化 Windows 服务和计划任务、资源占用、程序信息复制、程...
TranslucentTB启动优化：StartupManager实现高效开机自启
gitblog_00863的博客
09-26 657
Windows系统开机自启功能常因应用启动缓慢导致用户体验下降，TranslucentTB通过`StartupManager`组件实现了高效的开机自启管理。本文将从技术实现角度解析其如何解决传统自启方案的痛点，以及普通用户如何配置这一功能。 ## 核心组件解析：StartupManager架构设计 `StartupManager`作为TranslucentTB的启动管理核心，采用了Window...
安卓：启动项目管理Startup Manager (无广告版)
05-07
安卓下的开机启动项目管理小工具，这是无广告版。
推荐一款Windows启动项管理工具：HiBit Startup Manager
xzji001的博客
02-20 3254
是一款使管理启动程序非常简单。启动时，每个启动项的顶部都会显示一个列表，底部显示详细信息。还有所有启动项目的列表，包括新的和潜在的危险程序。单击任何程序，就可以选择删除，编辑，启用或禁用。
StartUp Manager－Grub 启动经管器
weixin_30375247的博客
03-07 217
Toy Posted in AppsRSSTrackback 年夜家知道，Grub 的设置配备布置文件在 /boot/grub/menu.lst。固然文本设置配备布置文件有评释阐发');，但是编纂起来比较费事。若是对 Grub 不太了解的话，那么可以操作图形设置配备布置界面的 SUM——StartUp Manager。 警告：此软件尚不稳定年夜概招致 Grub 损坏，不...
鸿蒙API14开发【@ohos.app.appstartup.startupManager】应用框架api
bbq的博客
04-13 754
本模块提供应用启动框架管理启动任务的能力，只能在主线程调用。
电脑开机启动项管理小工具，绿色免安装
ITdgr的博客
08-04 1948
HiBit Startup Manager 是一款功能强大的启动项管理工具，旨在帮助用户管理和优化计算机的自动启动程序。通过这些功能，用户不仅可以提高系统的启动速度，还能减少资源占用，从而提升整体性能。总之，HiBit Startup Manager 是一款非常实用且高效的启动项管理工具，适合希望优化系统启动并提升计算机运行效率的用户使用。★★★★★电脑开机启动项管理小工具：https://pan.quark.cn/s/3f0c2c7ce22f。
鸿蒙API13开发【@ohos.app.appstartup.startupManager】Stage模型能力的接口
鸿蒙的技术博客
11-27 1008
本模块提供应用启动框架管理启动任务的能力，只能在主线程调用。
Android Startup 开源项目教程
最新发布
gitblog_01064的博客
11-25 386
Android Startup 项目的目录结构如下： ``` android-startup/ ├── app/ │ ├── build.gradle │ └── src/ │ └── main/ │ ├── java/ │ │ └── com/ │ │ └── idisfkj/ │
HarmonyOS Next开发学习手册——应用启动框架AppStartup
maniuT的博客
06-24 2061
AppStartup提供了一种简单高效的初始化组件的方式，开发者可以使用AppStartup来显示的设置组件的初始化顺序以及之间的依赖关系，支持异步初始化组件加速应用的启动时间。开发者需要分别为待初始化的组件实现AppStartup提供的 StartupTask 接口，并在 startup_config.json 中配置AppStartup之间的依赖关系，每个StartupTask都是一个等待执行的启动任务，启动框架将使用拓扑排序保证各个启动任务的执行顺序。说明启动框架只支持在entry中使用。
.NET 为大型应用接入 ApplicationStartupManager 启动流程框架
dotNET跨平台
04-10 511
对于大型的应用软件，特别是客户端应用软件，应用启动过程中，需要执行大量的逻辑，包括各个模块的初始化和注册等等逻辑。大型应用软件的启动过程都是非常复杂的，而客户端应用软件是对应用的启动性能有所要求的，不同于服务端的应用软件。设想，用户双击了桌面图标，然而等待几分钟，应用才启动完毕，那用户下一步会不会就是点击卸载了。为了权衡大型应用软件在启动过程，既需要执行复杂的启动逻辑，又...
鸿蒙Qt字体实战：消灭“豆腐块“乱码与自定义字体加载
小淼淼的博客
11-23 536
Qt应用移植到鸿蒙系统时常见中文字体显示为方框（"豆腐块"）问题，主要原因是系统字体回退失败或自定义字体加载路径错误。解决方案包括：显式指定系统字体、将字体文件拷贝到沙箱目录再加载、在QML中正确使用FontLoader引用字体名称。此外还需注意High DPI适配问题，通过设置环境变量或手动调整缩放因子来优化字体渲染效果。建议打包开源中文字体随App发布，确保字体在不同设备上都能正常显示。
Quality : ActivityThread: callApplicationOnCreate delay 23406 com.android.nfc 4575
08-29
如果是你开发的应用，检查 `onCreate()` 中是否做了如下操作： - 大量 IO 操作（如读取大文件） - 同步网络请求 - 复杂的数据结构初始化 - 第三方 SDK 初始化（如统计、广告、地图等） --- ## 四、优化建议 ### ...
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值