写点什么

应用退出不知道原因?HarmonyOS 有账本

  • 2026-06-30
    北京
  • 本文字数:1863 字

    阅读完需:约 6 分钟

本原创文章帖发布在华为开发者联盟社区,欢迎开发者前往访问评论交流,更多与该内容相关讨论,请点击原帖查看:应用退出不知道原因?HarmonyOS有账本-华为开发者话题 | 华为开发者联盟

一、背景与挑战

1.1 当前应用退出痛点

  • 退出原因记录分散:系统杀应用逻辑分散在多个模块(如资源管控、故障处理、后台任务管理等),缺乏统一的维测接口。

    区分退出是否是故障:部分退出原因是正常的用户行为,或者是系统正常的后台管理行为,需要剔除这些正常退出原因,关注消费产品使用者体验层面的异常问题。

1.2 常见退出场景分类

二、通过 HiAppEvent 订阅机制获取上次退出原因

2.1 核心能力

  • 订阅接口:hiAppEvent.addWatcher 支持订阅 hiAppEvent.event.APP_KILLED 系统事件 。

    数据模型:通过 eventInfo.params.reason 获取退出原因

2.2 开发实践示例

hiAppEvent.addWatcher({  // 开发者可以自定义观察者名称,系统会使用名称来标识不同的观察者  name: "watcher",  // 开发者可以订阅感兴趣的系统事件,此处是订阅了应用终止事件  appEventFilters: [    {      domain: hiAppEvent.domain.OS,      names: [hiAppEvent.event.APP_KILLED]    }  ],  // 开发者可以自行实现订阅实时回调函数,以便对订阅获取到的事件数据进行自定义处理  onReceive: (domain: string, appEventGroups: Array<hiAppEvent.AppEventGroup>) => {    hilog.info(0x0000, 'testTag', `HiAppEvent onReceive: domain=${domain}`);    for (const eventGroup of appEventGroups) {      // 开发者可以根据事件集合中的事件名称区分不同的系统事件      hilog.info(0x0000, 'testTag', `HiAppEvent eventName=${eventGroup.name}`);      for (const eventInfo of eventGroup.appEventInfos) {        // 开发者可以对事件集合中的事件数据进行自定义处理,此处是将事件数据打印在日志中        hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo.domain=${eventInfo.domain}`);        hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo.name=${eventInfo.name}`);        // 开发者可以获取到应用终止事件发生的时间戳        hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo.params.time=${eventInfo.params['time']}`);        // 开发者可以获取到应用的前后台状态        hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo.params.foreground=${eventInfo.params['foreground']}`);        // 开发者可以获取到应用终止事件发生的原因        hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo.params.reason=${eventInfo.params['reason']}`);        hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo.params.app_running_unique_id=${eventInfo.params['app_running_unique_id']}`);        hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo.params.bundle_version=${eventInfo.params['bundle_version']}`);      }    }  }});
复制代码

2.3 数据采集维度

三、开发案例:崩溃聚类分析实战

3.1 案例背景

某应用在鸿蒙 6.1 升级后出现高频崩溃,传统日志分析难以定位共性诱因。通过 HiAppEvent 订阅机制,开发者获取到以下关键数据:

  • 崩溃类型分布:JS Crash 占比 62%,CppCrash 占比 38%。

    资源管控诱因:整机内存管控触发的后台进程终止占比 75%。

3.2 基本架构

3.3 聚类分析流程

  1. 数据清洗:提取 eventInfo.params.reason 中的关键词(如 RssThresholdKiller、LowMemoryKill)。如果只关注前台应用闪退,则过滤 eventInfo.params.foreground

    聚类算法:对崩溃事件 reason 进行聚类,识别高频模式。

    数据关联,根因定位:针对聚类中心事件,通过 app_running_unique_id 字段和 hiAppEvent.event.APP_CRASH 事件日志进行关联。

3.3 修复效果

附:官方文档

  1. 应用终止事件介绍,含订阅示例代码:https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-killed-events?ha_source=InfoQ&ha_sourceId=70000011

    App Killed(应用终止)检测 https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/appkilled-guidelines?ha_source=InfoQ&ha_sourceId=70000011

    应用异常退出类问题检测方法 https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-stability-runtime-exception-exit-detection?ha_source=InfoQ&ha_sourceId=70000011

    应用被查杀类问题分析方法 https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-stability-app-killed-way?ha_source=InfoQ&ha_sourceId=70000011