檢測(cè)模式

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

說(shuō)明： 本模塊首批接口從API version 8開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。 開發(fā)前請(qǐng)熟悉鴻蒙開發(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)行檢測(cè)或反饋。

系統(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ī)則集中是否包含了某一個(gè)特定的規(guī)則，如果傳入的規(guī)則級(jí)別為線程級(jí)別，則僅在當(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;

審核編輯 黃宇