文档开发者中心
我的
|

HarmonyOS 5

MDM 黑名单拦截场景下应用进程无法启动,除了 hdc 拉 faultlog,有没有方案自动采集系统故障日志并上报?

MDM 黑名单拦截场景下应用进程无法启动,除了 hdc 拉 faultlog,有没有方案自动采集系统故障日志并上报?
点赞
收藏
回复
8
分享
举报
浏览47 发布于5天前广东
全部评论
最多点赞
最新发布
最早发布
|
推荐答复

有,但先把边界说清楚:应用在 MDM 运行禁止名单里时,整个应用(含所有 ExtensionAbility)都不允许运行,应用侧代码一行都跑不了,"被拦截期间实时采集"这条路在三方应用侧不存在。能落地的是反过来:系统先把故障数据存进你的应用沙箱,等你的进程有机会被拉起时自动回调给你,你在回调里上报后端。

按推荐顺序三个方案:

  1. API 21 新增的 FaultLogExtensionAbility(故障延迟通知),就是为这个场景设计的:崩溃或冻屏发生约 30 分钟后,系统服务自动拉起你的扩展进程,在 onFaultReportReady 里收故障事件并上报,全程不依赖应用主进程启动。指南原话:"应用因崩溃或冻屏退出后,无法启动或长时间未启动的场景下,可以不依赖应用启动实现故障事件信息的订阅回调"。注意只有约 10 秒处理窗口,且仅覆盖崩溃和应用冻屏两类事件。

  2. API 12 起就有的 HiAppEvent 订阅:主进程 onCreate 里订阅 APP_CRASH/APP_FREEZE,"只有当应用下次启动后才能接收上一次的事件"——下次能启动时把沙箱里积压的故障事件收走上报,隔多久都在。

  3. 不想自己搭上报链路,直接开通 AGC 性能服务(原 APMS,崩溃服务已并入),开启后自动采集上报崩溃、冻屏。

两个坑提醒:

  • FaultLogger(querySelfFaultLog/query)从 API 18 起停止维护,别再基于它搭采集,直接走 HiAppEvent。
  • 如果应用是被名单直接拦住没起来(没有崩溃/冻屏),上面机制没有事件可收;而且拉黑期间到了 30 分钟扩展进程也大概率起不来(推测,未真机验证)。但已产生的故障事件会留在沙箱,移出黑名单能启动后照常收到。

最小 demo(API 21 工程编译通过):

EntryAbility.ets —— 主进程注册两个观察者:

收起
自动换行
深色代码主题
复制
import { UIAbility } from '@kit.AbilityKit';
import { hilog, hiAppEvent } from '@kit.PerformanceAnalysisKit';

export default class EntryAbility extends UIAbility {
  onCreate(): void {
    // 观察者A:应用正常重启后,在这里收到崩溃/冻屏事件并上报
    hiAppEvent.addWatcher({
      name: 'watcherNormal',
      appEventFilters: [{
        domain: hiAppEvent.domain.OS,
        names: [hiAppEvent.event.APP_CRASH, hiAppEvent.event.APP_FREEZE]
      }],
      onReceive: (domain: string, appEventGroups: Array<hiAppEvent.AppEventGroup>) => {
        for (const group of appEventGroups) {
          for (const info of group.appEventInfos) {
            hilog.info(0x0000, 'FaultLogDemo', 'watcherNormal recv %{public}s', info.name);
          }
        }
        // TODO: 调用上报接口把事件数据传到后端
      }
    });
    // 观察者B:空实现,仅用于把订阅过滤条件持久化到沙箱,供扩展进程使用
    hiAppEvent.addWatcher({
      name: 'watcherExtension',
      appEventFilters: [{
        domain: hiAppEvent.domain.OS,
        names: [hiAppEvent.event.APP_CRASH, hiAppEvent.event.APP_FREEZE]
      }],
      onReceive: (domain: string, appEventGroups: Array<hiAppEvent.AppEventGroup>) => {
      }
    });
  }
}

新建 faultlogextension/MyFaultLogExtensionAbility.ets:

收起
自动换行
深色代码主题
复制
import { FaultLogExtensionAbility, hilog, hiAppEvent } from '@kit.PerformanceAnalysisKit';

export default class MyFaultLogExtensionAbility extends FaultLogExtensionAbility {
  onConnect(): void {
    hilog.info(0x0000, 'FaultLogDemo', 'onConnect');
  }

  onDisconnect(): void {
    hilog.info(0x0000, 'FaultLogDemo', 'onDisconnect');
  }

  onFaultReportReady(): void {
    // 与主进程观察者B同名,接管延迟投递的故障事件
    hiAppEvent.addWatcher({
      name: 'watcherExtension',
      appEventFilters: [{
        domain: hiAppEvent.domain.OS,
        names: [hiAppEvent.event.APP_CRASH, hiAppEvent.event.APP_FREEZE]
      }],
      onReceive: (domain: string, appEventGroups: Array<hiAppEvent.AppEventGroup>) => {
        hilog.info(0x0000, 'FaultLogDemo', 'onReceive domain=%{public}s', domain);
        for (const group of appEventGroups) {
          for (const info of group.appEventInfos) {
            hilog.info(0x0000, 'FaultLogDemo', 'recv %{public}s', info.name);
          }
        }
        // 回调需在10秒内完成,超时在onDisconnect里保存进度
        // TODO: 调用上报接口把事件数据传到后端
      }
    });
  }
}

module.json5 的 extensionAbilities 里追加:

收起
自动换行
深色代码主题
复制
{
  "name": "MyFaultLogExtensionAbility",
  "srcEntry": "./ets/faultlogextension/MyFaultLogExtensionAbility.ets",
  "type": "faultLog"
}

验证方式:真机触发一次 JS crash,应用退出后保持设备亮屏不重启,等 30 分钟左右,HiLog 搜 FaultLogDemo 应能看到扩展进程被系统拉起并收到事件。注意 30 分钟是非休眠状态的累积时间,灭屏休眠会拉长等待。

相关文档:

展开全部
3楼回复于5天前 来自四川
学习
4楼回复于5天前 来自陕西

应用被禁启,和应用启动后崩溃,需要分开处理:前者可能根本没有目标进程的崩溃事件。FaultLogExtensionAbility 的官方定位是崩溃、冻屏的延迟通知,不能据此承诺它在 MDM 禁启策略下仍能运行。

这类现场方案应先由仍允许运行的企业管理端确认是否有对应设备类型的诊断采集能力,并收集策略命中与启动拒绝记录;目标应用自己的上报逻辑只有获得执行机会才有用。建议分开验证“只禁启、先崩溃再禁启、解除禁启后启动”三种情况,分别确认事件是否生成、采集端是否运行、是否收到日志,再决定部署哪条通道。延迟通知边界:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-hiviewdfx-faultlogextensionability/

8楼回复于5天前 来自四川

这个场景先看采集程序有没有运行资格:若目标应用连扩展进程也被 MDM 禁止启动,给它加 SDK 或 FaultLogExtensionAbility 都不能保证自动上报;而“启动被拒绝”本身也不等于发生了 APP_CRASH/APP_FREEZE。应由仍获准运行的 MDM 管理端核对策略、启动拒绝记录及其授权诊断能力,普通目标应用不能自行读取任意系统故障日志。

FaultLogExtensionAbility(API 21+)适合补收已产生的崩溃/冻屏事件:需主进程预先订阅,约 30 分钟非休眠累计时间后尝试拉起,处理窗口只有约 10 秒。官方这套机制没有承诺绕过 MDM 禁启,现场要分别验证“故障已生成、扩展获准启动、上报成功”;如果只是策略拒绝而没有故障,继续等 faultlog 回调也不会解决。建议先补充设备形态、系统/API 版本以及使用的 MDM 产品,以便确认管理端究竟开放了哪种采集能力。 故障延迟通知:https://developer.huawei.com/consumer/cn/doc/HarmonyOS-Guides/fault-log-extension-app-events-arkts/

7楼回复于5天前 来自四川

结论:有官方方案,但要区分“应用崩溃后无法启动”和“被 MDM 黑名单禁止启动”。这两种情况的处理方式不一样。

  • 应用崩溃后无法启动:HarmonyOS API 21+ 可使用 FaultLogExtensionAbility + HiAppEvent 延迟采集并上报崩溃日志。

  • MDM 黑名单禁止启动:不能保证 FaultLogExtensionAbility 能绕过管控策略运行。应优先让 MDM 管理端采集系统日志。

  • 普通应用完全无法运行:没有预先授权的外部采集通道时,无法保证自动取出系统故障日志。

一、优先考虑 MDM 管理端采集

HarmonyOS 企业设备管理提供了 systemManager.startCollectLog() 接口,可由具备相应权限的 MDM 应用发起系统故障日志采集。

该接口从 API 23 开始支持,要求 ohos.permission.ENTERPRISE_READ_LOG,采集完成后通过 EnterpriseAdminExtensionAbility.onLogCollected() 通知管理应用。

不过有一个关键限制:当前官方文档明确说明,该接口仅在 PC/2in1 设备上正常调用,其他设备类型返回错误码 801。

所以如果现场是 HarmonyOS 手机,不能直接把它作为通用解决方案。

场景

采集方案

可行性

PC/2in1,具有 MDM 管理权限

startCollectLog()

官方支持

手机,普通第三方应用

直接读取系统 faultlog

不支持通用访问

手机,应用崩溃但 Extension 可运行

FaultLogExtensionAbility

有条件支持

手机,MDM 完全禁止目标应用执行

MDM 厂商或企业管理系统诊断能力

需确认具体产品支持

MDM 端的采集流程可以设计为:

企业管理端发起采集 → 系统收集 faultlog → onLogCollected 回调 → MDM 上传服务器 → finishLogCollected 清理

该接口只能收集符合要求、已经落盘的系统故障日志,不能直接获取应用 filesDir/zlog 中的自定义业务日志。

二、应用崩溃无法启动:FaultLogExtensionAbility

对于允许扩展组件执行的设备,可以使用官方故障延迟通知机制。

示例:

收起
自动换行
深色代码主题
复制
import {
  FaultLogExtensionAbility,
  hiAppEvent
} from '@kit.PerformanceAnalysisKit';

export default class FaultReportAbility
  extends FaultLogExtensionAbility {

  onFaultReportReady(): void {
    hiAppEvent.addWatcher({
      name: 'FaultWatcher',
      appEventFilters: [
        {
          domain: hiAppEvent.domain.OS,
          names: [
            hiAppEvent.event.APP_CRASH,
            hiAppEvent.event.APP_FREEZE
          ]
        }
      ],
      onReceive: (domain, groups) => {
        for (const group of groups) {
          for (const event of group.appEventInfos) {
            // 读取 event.params.external_log
            // 将故障摘要及必要日志上报服务端
            // 应增加去重、超时和失败处理
          }
        }
      }
    });
  }
}

这是核心流程示例,还需要根据 SDK 完成 module.json5 中的 Extension 声明、对应回调签名及上报实现。

官方限制包括:

  • 故障发生约 30 分钟后才尝试拉起,计时按设备非休眠时间累计。

  • 系统调度可能继续延后。

  • Extension 处理时间约 10 秒。

  • 故障后设备重启,不保证原有延迟任务继续执行。

  • 主进程此前必须正常订阅相关 HiAppEvent 事件,否则 Extension 首次订阅可能无法获得之前的故障。

因此,应该在应用正常启动时尽早注册同名 watcher,并将上报逻辑设计为短时间、可中断、可重试。

三、MDM 黑名单场景最容易忽略的问题

MDM 拦截本身不等于应用崩溃。

例如应用被管理策略直接禁止启动,系统可能根本没有创建目标应用进程,也就不会产生该应用的 NativeCrash 或 JsError。

这种情况下:

  • HiAppEvent 不一定产生 APP_CRASH。

  • FaultLogExtensionAbility 不一定会被触发。

  • 即使已有历史 faultlog,普通应用也没有权限任意读取系统目录。

  • 应由管理端检查应用管控策略、启动拒绝记录以及 MDM 自身的操作日志。

此外,MDM 是否允许目标应用的 Extension 独立启动,需要在相同的设备和管控策略下进行验证,不能假定其能够突破黑名单限制。

四、实际项目推荐的采集架构

建议采用两条独立通道:

通道 A:应用故障采集

HiAppEvent → FaultLogExtensionAbility → HTTPS 诊断服务器

用于应用崩溃、冻屏后仍允许执行延迟通知的场景。

通道 B:企业设备管理采集

MDM 管理端 → 系统允许的诊断能力 → 企业服务器

用于应用被管控、禁止启动等场景。手机端需要与 MDM 厂商确认是否有授权的设备诊断接口,不能直接套用仅支持 PC/2in1 的 startCollectLog()。

同时建议正常运行期间定期上传必要的脱敏业务日志摘要,避免故障发生后完全依赖沙箱文件。

五、建议做四组验证

测试

重点判断

主动制造 NativeCrash

系统是否产生故障日志

崩溃后不重启应用

Extension 能否延迟上报

崩溃后施加 MDM 黑名单

Extension 是否仍允许运行

MDM 禁启但没有发生崩溃

管理端能否取得启动拒绝信息

尤其要分别记录“系统日志是否生成”“采集进程是否启动”“日志是否上传成功”,不能把三个结果混为一谈。

最终建议:如果现场设备是 HarmonyOS 手机,并且 MDM 已经完全禁止目标应用进程启动,那么最可靠的方向是让 MDM 管理端承担诊断采集职责,而不是继续增加目标应用内部的后台组件。

展开全部
6楼回复于5天前 来自山西
感谢🙏
5楼回复于5天前 来自河南

有,而且不用你自己做采集——faultlog 本来就是系统 FaultLogger 自动抓取落盘的,你要解决的是"应用进程不在了,谁来把日志送出去"。官方链路是 HiAppEvent 订阅加 FaultLogExtensionAbility(API 21 起),后者就是为"应用因崩溃或冻屏退出后,无法启动或长时间未启动"这个场景设计的,见接入指南。

正常路径:主进程提前 addWatcher 订阅崩溃、冻屏事件,回调里的 external_log 参数就是 faultlog 的应用沙箱路径,读全文 http 上报即可,APM 能力建设整套就是这个思路。崩溃后应用退出,事件下次启动补收。

起不来的路径(你问的核心):故障发生约 30 分钟后(非休眠状态累积),系统服务拉起应用的 FaultLogExtensionAbility,你在 onFaultReportReady 里 addWatcher 同名观察者,就能收到这次故障事件,不依赖应用能启动。三个限制记一下:主进程要先注册过同名 watcher,订阅规则存在沙箱里;回调处理要在 10 秒内完成;设备重启后不会补拉扩展进程。

MDM 黑名单这个前提要单独说:addDisallowedRunningBundles 拦的是应用启动,扩展进程是系统服务拉起的,会不会被策略一起拦掉,文档没有说明,我没在 MDM 环境实测,建议你先单独验证这一点,这是方案里唯一的不确定点。另外如果被拦的不是你自己的应用(改不了它的代码),普通应用没有替别的应用采集 faultlog 的通道,那种情况 hdc 仍是唯一手段。

最小 demo(API 26 编译通过)

module.json5 声明扩展,type 是 faultLog:

收起
自动换行
深色代码主题
复制
"extensionAbilities": [
  {
    "name": "MyFaultLogExtensionAbility",
    "srcEntry": "./ets/faultlogextension/MyFaultLogExtensionAbility.ets",
    "type": "faultLog",
    "exported": false
  }
]

EntryAbility.ets 的 onCreate 里注册观察者 A(正常重启时处理)和观察者 B(空实现,配合扩展延迟回调,名字必须与扩展内一致):

收起
自动换行
深色代码主题
复制
import { hiAppEvent } from '@kit.PerformanceAnalysisKit';

// 观察者A:应用正常重启时在主进程回调处理
hiAppEvent.addWatcher({
  name: 'WatcherNormal',
  appEventFilters: [
    {
      domain: hiAppEvent.domain.OS,
      names: [hiAppEvent.event.APP_CRASH, hiAppEvent.event.APP_FREEZE]
    }
  ],
  onReceive: (domain: string, appEventGroups: Array<hiAppEvent.AppEventGroup>) => {
    // eventInfo.params.external_log 是 faultlog 沙箱路径,读全文上报
  }
});
// 观察者B:空实现,仅生成过滤规则存入沙箱,供FaultLogExtensionAbility延迟回调使用
hiAppEvent.addWatcher({
  name: 'WatcherExtension',
  appEventFilters: [
    {
      domain: hiAppEvent.domain.OS,
      names: [hiAppEvent.event.APP_CRASH, hiAppEvent.event.APP_FREEZE]
    }
  ],
  onReceive: (domain: string, appEventGroups: Array<hiAppEvent.AppEventGroup>) => {
  }
});

MyFaultLogExtensionAbility.ets:应用起不来,30 分钟后系统拉起这里,收事件落盘或直接上报:

收起
自动换行
深色代码主题
复制
import { FaultLogExtensionAbility, hiAppEvent, hilog } from '@kit.PerformanceAnalysisKit';
import { fileIo } from '@kit.CoreFileKit';

export default class MyFaultLogExtensionAbility extends FaultLogExtensionAbility {
  onConnect(): void {
    hilog.info(0x0000, 'testTag', 'FaultLogExtensionAbility onConnect');
  }

  onDisconnect(): void {
    hilog.info(0x0000, 'testTag', 'FaultLogExtensionAbility onDisconnect');
  }

  onFaultReportReady(): void {
    hiAppEvent.addWatcher({
      name: 'WatcherExtension', // 与主进程观察者B同名
      appEventFilters: [
        {
          domain: hiAppEvent.domain.OS,
          names: [hiAppEvent.event.APP_CRASH, hiAppEvent.event.APP_FREEZE]
        }
      ],
      onReceive: (domain: string, appEventGroups: Array<hiAppEvent.AppEventGroup>) => {
        // 10秒内完成:落盘沙箱,或直接http上报(http不在扩展的模块限制列表里)
        const dir: string = this.context.filesDir + '/zlog';
        if (!fileIo.accessSync(dir)) {
          fileIo.mkdirSync(dir);
        }
        const file: fileIo.File = fileIo.openSync(dir + '/fault_' + Date.now() + '.json',
          fileIo.OpenMode.READ_WRITE | fileIo.OpenMode.CREATE);
        fileIo.writeSync(file.fd, JSON.stringify(appEventGroups));
        fileIo.closeSync(file);
        hilog.info(0x0000, 'testTag', 'fault event saved, domain: %{public}s', domain);
      }
    });
  }
}

主进程观察者 A 里读 external_log 并上报的写法,参考访问及删除 external_log 日志文件的示例,处理完及时删文件,沙箱日志空间有限。

整体节奏:主进程 watcher 提前注册好,应用能启动时观察者 A 收,起不来时 30 分钟后扩展收,两条路都通到你的上报接口,现场就不用 hdc 了。30 分钟延迟和"设备重启不补拉"这两条,做现场方案时留余量。

展开全部
2楼回复于5天前 来自四川
AI 生成内容,仅供参考

MDM黑名单拦截导致应用进程无法启动的场景下,HarmonyOS 提供了 FaultLogExtensionAbility(故障延迟通知)机制,可以在应用无法启动或长时间未启动时,不依赖应用主进程启动,由系统自动拉起独立进程完成故障事件的订阅回调与上报,无需通过 hdc 手动拉取 faultlog。该能力从 API version 21 开始支持,属于 Performance Analysis Kit(性能分析服务)。

方案原理

传统方案中,HiAppEvent 的崩溃/冻屏事件需要应用下次启动时由主进程观察者回调获取;而 MDM 拦截、崩溃后无法重启等场景下主进程起不来,事件就"卡"在沙箱里拿不到。FaultLogExtensionAbility 的解决思路是:

  1. 主进程存活时注册两个观察者:观察者 A(正常回调处理)和观察者 B(空实现,仅用于把订阅过滤条件持久化到应用沙箱,使故障事件在被处理前保留在沙箱内);
  2. 应用发生崩溃或冻屏后未及时重启,系统服务会在故障发生 30 分钟后(非休眠累积时间)自动拉起应用的 FaultLogExtensionAbility 进程;
  3. 在该进程中注册与观察者 B 同名的观察者并实现真正的回调,HiAppEvent 检测到沙箱中未处理的故障事件满足过滤条件后触发回调,开发者即可在回调中读取事件参数和 external_log 故障日志文件路径,完成采集与上报。

开发步骤与示例代码

以下示例以订阅崩溃事件和冻屏事件为例,适用于 Stage 模型。

第一步,在主进程(如 EntryAbility 的 onCreate)中注册观察者 A 和观察者 B:

收起
自动换行
深色代码主题
复制
import { UIAbility } from '@kit.AbilityKit';
import { hiAppEvent, hilog } from '@kit.PerformanceAnalysisKit';

export default class EntryAbility extends UIAbility {
  onCreate(): void {
    // 观察者A:正常重启后处理故障事件
    hiAppEvent.addWatcher({
      name: 'EntryAbilityWatcherNormal',
      appEventFilters: [
        {
          domain: hiAppEvent.domain.OS,
          // 同时订阅崩溃事件与冻屏事件
          names: [hiAppEvent.event.APP_CRASH, hiAppEvent.event.APP_FREEZE]
        }
      ],
      onReceive: (domain: string, appEventGroups: Array<hiAppEvent.AppEventGroup>) => {
        // 正常重启场景下在此处理并上报故障事件
        for (const eventGroup of appEventGroups) {
          hilog.info(0x0000, 'FaultLog', `主进程收到事件: ${eventGroup.name}`);
        }
      }
    });

    // 观察者B:空实现,仅用于生成过滤规则,
    // 使故障事件在被处理前保留在应用沙箱内
    hiAppEvent.addWatcher({
      name: 'EntryAbilityWatcherExtension',
      appEventFilters: [
        {
          domain: hiAppEvent.domain.OS,
          names: [hiAppEvent.event.APP_CRASH, hiAppEvent.event.APP_FREEZE]
        }
      ],
      onReceive: (domain: string, appEventGroups: Array<hiAppEvent.AppEventGroup>) => {
        // 空实现:若应用正常重启,观察者A已处理相同事件,
        // 观察者B通过空处理消耗沙箱中的事件,避免重复处理
      }
    });
  }
}

第二步,新建 entry/src/main/ets/faultlogextension/MyFaultLogExtensionAbility.ets,继承 FaultLogExtensionAbility 并重写三个生命周期接口:

收起
自动换行
深色代码主题
复制
// 导入需要继承的类FaultLogExtensionAbility
import { FaultLogExtensionAbility, hilog, hiAppEvent } from '@kit.PerformanceAnalysisKit';

export default class MyFaultLogExtensionAbility extends FaultLogExtensionAbility {
  // 系统连接FaultLogExtensionAbility时触发
  onConnect() {
    hilog.info(0x0000, 'FaultLogExtension', `FaultLogExtensionAbility onConnect`);
  }

  // 系统断开连接时触发,超时未处理完成可在此保存状态
  onDisconnect() {
    hilog.info(0x0000, 'FaultLogExtension', `FaultLogExtensionAbility onDisconnect`);
  }

  // 系统准备好故障信息后回调,建议业务逻辑不超过10秒
  onFaultReportReady() {
    hiAppEvent.addWatcher({
      // 观察者名称,必须与主进程事件观察者B一致
      name: 'EntryAbilityWatcherExtension',
      appEventFilters: [
        {
          domain: hiAppEvent.domain.OS,
          names: [hiAppEvent.event.APP_CRASH, hiAppEvent.event.APP_FREEZE]
        }
      ],
      onReceive: (domain: string, appEventGroups: Array<hiAppEvent.AppEventGroup>) => {
        for (const eventGroup of appEventGroups) {
          for (const eventInfo of eventGroup.appEventInfos) {
            // 故障发生时间、进程、包名、异常信息等关键字段
            const time: number = eventInfo.params['time'] as number;
            const pid: number = eventInfo.params['pid'] as number;
            const bundleName: string = eventInfo.params['bundle_name'] as string;
            const exception: string = JSON.stringify(eventInfo.params['exception']);
            // external_log为故障日志文件在应用沙箱中的路径,
            // 读取该文件即可获得完整faultlog内容,随后上传到自建服务端
            const externalLog: Array<string> = eventInfo.params['external_log'] as Array<string>;
            hilog.info(0x0000, 'FaultLogExtension',
              `time=${time}, pid=${pid}, bundle=${bundleName}, exception=${exception}, log=${JSON.stringify(externalLog)}`);
            // 此处实现上报逻辑:读取external_log文件内容并上传,
            // 上传成功后建议及时清理日志文件,避免占用沙箱空间
          }
        }
      }
    });
  }
}

第三步,在 entry/src/main/module.json5 中注册该 extensionAbility:

收起
自动换行
深色代码主题
复制
"extensionAbilities": [
  {
    "name": "MyFaultLogExtensionAbility",
    "srcEntry": "./ets/faultlogextension/MyFaultLogExtensionAbility.ets",
    "type": "faultLog"
  }
]

补充说明与关键约束

关于事件覆盖范围,FaultLogExtensionAbility 仅支持崩溃事件(APP_CRASH,含 JsError 与 NativeCrash)和应用冻屏事件(APP_FREEZE)两类故障事件的延迟通知。若 MDM 拦截本身只是拒绝进程启动而未触发崩溃或冻屏事件,则该机制不会产生对应事件,此时故障根因需要结合系统侧日志分析,应用侧无法自动采集到"被拦截"这一动作本身的信息。

关于 MDM 拦截的影响,需要特别注意:FaultLogExtensionAbility 进程属于应用自身的 extension 进程,若应用的启动被 MDM 策略完全阻断,该进程同样可能无法被拉起,延迟通知机制将失效。这种情况下应用侧没有可靠的自动采集手段,仍需依赖 hdc 拉取 faultlog 与系统日志进行离线分析。

其他重要约束包括:被拉起后仅有约 10 秒时间完成故障处理,超时可在 onDisconnect 中保存状态;从开机或上次拉起后应用首次触发故障开始计时 30 分钟,期间反复触发故障不会重新计时;FaultLogExtensionAbility 自身崩溃时不会被系统再次拉起;若故障发生后设备重启,重启后不会再拉起该进程;观察者 A 与观察者 B 名称不能重复,否则可能丢失事件;FaultLogExtensionAbility 进程中订阅的事件必须先在主进程中通过 HiAppEvent 订阅过,否则收不到回调。

调测验证时,触发崩溃或冻屏后保持应用和设备不重启、屏幕常亮(灭屏休眠会延长计时),等待约 30 分钟,在 HiLog 窗口搜索 FaultLogExtension 关键字,依次出现 onConnect、onFaultReportReady、onReceive 回调日志即表示机制生效。

展开全部
1楼回复于5天前 来自广东
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。