ohos.app.ability.error_manager（错误管理模块）

说明：

当前为Beta阶段。

error_manager模块提供对错误观测器的注册和注销的能力，主要是观测发生应用崩溃（crash）和应用冻结（appfreeze）等错误的情况。

导入模块

import kit.AbilityKit.*

权限列表

ohos.permission.DISTRIBUTED_DATASYNC

ohos.permission.PREPARE_APP_TERMINATE

ohos.permission.PRIVACY_WINDOW

使用说明

API示例代码使用说明：

• 若示例代码首行有“// index.cj”注释，表示该示例可在仓颉模板工程的“index.cj”文件中编译运行。
• 若示例需获取Context应用上下文，需在仓颉模板工程中的“main_ability.cj”文件中进行配置。

上述示例工程及配置模板详见仓颉示例代码说明。

class ErrorManager

public class ErrorManager {}

功能： 提供Ability错误管理的能力，包括错误事件的监听和取消监听。

系统能力： SystemCapability.Ability.AbilityRuntime.Core

起始版本： 22

static func off(ErrorManagerEvent, Int32)

public static func off(eventType: ErrorManagerEvent, observerId: Int32): Unit

功能： 取消监听Ability错误事件。

系统能力： SystemCapability.Ability.AbilityRuntime.Core

起始版本： 22

参数：

参数名	类型	必填	默认值	说明
eventType	ErrorManagerEvent	是	-	错误事件类型。
observerId	Int32	是	-	观察者ID。

异常：

• BusinessException：对应错误码如下表，详见元能力子系统错误码。

  错误码ID	错误信息
  16000003	The specified ID does not exist.
  16000050	Internal error.

示例：

// index.cj
import kit.AbilityKit.*
import kit.PerformanceAnalysisKit.*
import ohos.business_exception.BusinessException

try {
    let observerId: Int32 = 1
    ErrorManager.off(ErrorManagerEvent.Error, observerId)
} catch (e: BusinessException) {
    Hilog.info(0, "test_errorManager", "${e.message}")
}

static func on(ErrorManagerEvent, ErrorObserver)

public static func on(eventType: ErrorManagerEvent, observer: ErrorObserver): Int32

功能： 监听Ability错误事件。

系统能力： SystemCapability.Ability.AbilityRuntime.Core

起始版本： 22

参数：

参数名	类型	必填	默认值	说明
eventType	ErrorManagerEvent	是	-	错误事件类型。
observer	ErrorObserver	是	-	错误观察者。

返回值：

类型	说明
Int32	观察者ID。

异常：

• BusinessException：对应错误码如下表，详见元能力子系统错误码。

  错误码ID	错误信息
  16000003	The specified ID does not exist.
  16000050	Internal error.

示例：

// index.cj

import kit.AbilityKit.*
import ohos.business_exception.BusinessException
import kit.PerformanceAnalysisKit.Hilog

try {
    let observer = ErrorObserver(
        {
            errorMsg =>
                Hilog.info(0, "test_errorManager", "onUnhandledException, errorMsg:  =${errorMsg}")
        },
        onException: Some({ errorObj =>
            Hilog.info(0, "test_errorManager", "onException, name:   =${errorObj.name}")
            Hilog.info(0, "test_errorManager", "onException, message:   =${errorObj.message}")
            if (let Some(v) <- errorObj.stack) {
                Hilog.info(0, "test_errorManager", "onException, stack:    =${v}")
            }
        })
    )
    let id = ErrorManager.on(ErrorManagerEvent.Error, observer)
} catch (e: BusinessException) {
    Hilog.info(0, "test", "${e.message}")
}

enum ErrorManagerEvent

public enum ErrorManagerEvent {
    | Error
    | ...
}

功能： 错误管理事件类型。

系统能力： SystemCapability.Ability.AbilityRuntime.Core

起始版本： 22

Error

Error

功能： 错误事件。

系统能力： SystemCapability.Ability.AbilityRuntime.Core

起始版本： 22