檢測模式

HiChecker可以作為應(yīng)用開發(fā)階段使用的檢測工具，用于檢測代碼運(yùn)行過程中部分易忽略的問題，如應(yīng)用線程出現(xiàn)耗時調(diào)用、應(yīng)用進(jìn)程中Ability資源泄露等問題。開發(fā)者可以通過日志記錄或進(jìn)程crash等形式查看具體問題并進(jìn)行修改，提升應(yīng)用的使用體驗。

說明： 本模塊首批接口從API version 8開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。 開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

導(dǎo)入模塊

import hichecker from '@ohos.hichecker';

常量

提供了所有規(guī)則類型的常量。

系統(tǒng)能力： SystemCapability.HiviewDFX.HiChecker

hichecker.addRule

addRule(rule: bigint): void

添加一條或多條規(guī)則到系統(tǒng)，系統(tǒng)根據(jù)添加的規(guī)則進(jìn)行檢測或反饋。

系統(tǒng)能力： SystemCapability.HiviewDFX.HiChecker

參數(shù)：

示例：

// 添加一條規(guī)則
hichecker.addRule(hichecker.RULE_CAUTION_PRINT_LOG);

// 添加多條規(guī)則
hichecker.addRule(
          hichecker.RULE_CAUTION_PRINT_LOG | hichecker.RULE_CAUTION_TRIGGER_CRASH);

hichecker.removeRule

removeRule(rule: bigint): void

刪除一條或多條規(guī)則，刪除的規(guī)則后續(xù)將不再生效。

系統(tǒng)能力： SystemCapability.HiviewDFX.HiChecker

參數(shù)：

示例：

// 刪除一條規(guī)則
hichecker.removeRule(hichecker.RULE_CAUTION_PRINT_LOG);

// 刪除多條規(guī)則
hichecker.removeRule(
          hichecker.RULE_CAUTION_PRINT_LOG | hichecker.RULE_CAUTION_TRIGGER_CRASH);

hichecker.getRule

getRule(): bigint

獲取當(dāng)前線程規(guī)則、進(jìn)程規(guī)則、告警規(guī)則的合集。

系統(tǒng)能力： SystemCapability.HiviewDFX.HiChecker

返回值：

示例：

// 添加一條規(guī)則
hichecker.addRule(hichecker.RULE_THREAD_CHECK_SLOW_PROCESS);

// 獲取已添加的規(guī)則
hichecker.getRule();   // return 1n;

hichecker.contains

contains(rule: bigint): boolean

當(dāng)前已添加的規(guī)則集中是否包含了某一個特定的規(guī)則，如果傳入的規(guī)則級別為線程級別，則僅在當(dāng)前線程中進(jìn)行查詢。

系統(tǒng)能力： SystemCapability.HiviewDFX.HiChecker

參數(shù)：

返回值：

示例：

// 添加一條規(guī)則
hichecker.addRule(hichecker.RULE_THREAD_CHECK_SLOW_PROCESS);

// 查詢是否包含
hichecker.contains(hichecker.RULE_THREAD_CHECK_SLOW_PROCESS); // return true;
hichecker.contains(hichecker.RULE_CAUTION_PRINT_LOG); // return false;

審核編輯 黃宇