日志打印

hilog日志系統(tǒng)，使應(yīng)用/服務(wù)可以按照指定級別、標(biāo)識和格式字符串輸出日志內(nèi)容，幫助開發(fā)者了解應(yīng)用/服務(wù)的運(yùn)行狀態(tài)，更好地調(diào)試程序。

說明： 本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。

導(dǎo)入模塊

import hilog from '@ohos.hilog';

hilog.isLoggable

isLoggable(domain: number, tag: string, level: LogLevel) : boolean

在打印日志前調(diào)用該接口，用于檢查指定領(lǐng)域標(biāo)識、日志標(biāo)識和級別的日志是否可以打印。

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

參數(shù)：

參數(shù)名	類型	必填	說明
domain	number	是	日志對應(yīng)的領(lǐng)域標(biāo)識，范圍是0x0~0xFFFF，開發(fā)者可根據(jù)需要自定義。
tag	string	是	指定日志標(biāo)識，可以為任意字符串，建議用于標(biāo)識調(diào)用所在的類或者業(yè)務(wù)行為。
level	[LogLevel]	是	日志級別。

返回值：

類型	說明
boolean	如果返回true，則該領(lǐng)域標(biāo)識、日志標(biāo)識和級別的日志可以打印，否則不能打印。

示例：

hilog.isLoggable(0x0001, "testTag", hilog.LogLevel.INFO);

LogLevel

日志級別。

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

名稱	默認(rèn)值	說明
DEBUG	3	詳細(xì)的流程記錄，通過該級別的日志可以更詳細(xì)地分析業(yè)務(wù)流程和定位分析問題。
INFO	4	用于記錄業(yè)務(wù)關(guān)鍵流程節(jié)點，可以還原業(yè)務(wù)的主要運(yùn)行過程；用于記錄可預(yù)料的非正常情況信息，如無網(wǎng)絡(luò)信號、登錄失敗等。這些日志都應(yīng)該由該業(yè)務(wù)內(nèi)處于支配地位的模塊來記錄，避免在多個被調(diào)用的模塊或低級函數(shù)中重復(fù)記錄。
WARN	5	用于記錄較為嚴(yán)重的非預(yù)期情況，但是對用戶影響不大，應(yīng)用可以自動恢復(fù)或通過簡單的操作就可以恢復(fù)的問題。
ERROR	6	應(yīng)用發(fā)生了錯誤，該錯誤會影響功能的正常運(yùn)行或用戶的正常使用，可以恢復(fù)但恢復(fù)代價較高，如重置數(shù)據(jù)等。
FATAL	7	重大致命異常，表明應(yīng)用即將崩潰，故障無法恢復(fù)。

hilog.debug

debug(domain: number, tag: string, format: string, ...args: any[]) : void

打印DEBUG級別的日志。

DEBUG級別的日志在正式發(fā)布版本中默認(rèn)不被打印，只有在調(diào)試版本或打開調(diào)試開關(guān)的情況下才會打印。

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

參數(shù)：

參數(shù)名	類型	必填	說明
domain	number	是	日志對應(yīng)的領(lǐng)域標(biāo)識，范圍是0x0~0xFFFF，開發(fā)者可根據(jù)需要自定義。
tag	string	是	指定日志標(biāo)識，可以為任意字符串，建議用于標(biāo)識調(diào)用所在的類或者業(yè)務(wù)行為。
format	string	是	格式字符串，用于日志的格式化輸出。格式字符串中可以設(shè)置多個參數(shù)，參數(shù)需要包含參數(shù)類型、隱私標(biāo)識。隱私標(biāo)識分為{public}和{private}，缺省為{private}。標(biāo)識{public}的內(nèi)容明文輸出，標(biāo)識{private}的內(nèi)容以過濾回顯。
args	any[]	是	與格式字符串format對應(yīng)的可變長度參數(shù)列表。參數(shù)數(shù)目、參數(shù)類型必須與格式字符串中的標(biāo)識一一對應(yīng)。

示例：

輸出一條DEBUG信息，格式字符串為"%{public}s World %{private}d"。其中變參%{public}s為明文顯示的字符串；%{private}d為隱私的整型數(shù)。

hilog.debug(0x0001, "testTag", "%{public}s World %{private}d", "hello", 3);

字符串"hello"填入%{public}s，整型數(shù)3填入%{private}d，輸出日志：

08-05 12:21:47.579  2695-2703/com.example.myapplication D 00001/testTag: hello World < private >

hilog.info

info(domain: number, tag: string, format: string, ...args: any[]) : void

打印INFO級別的日志。

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

參數(shù)：

參數(shù)名	類型	必填	說明
domain	number	是	日志對應(yīng)的領(lǐng)域標(biāo)識，范圍是0x0~0xFFFF，開發(fā)者可根據(jù)需要自定義。
tag	string	是	指定日志標(biāo)識，可以為任意字符串，建議用于標(biāo)識調(diào)用所在的類或者業(yè)務(wù)行為。
format	string	是	格式字符串，用于日志的格式化輸出。格式字符串中可以設(shè)置多個參數(shù)，參數(shù)需要包含參數(shù)類型、隱私標(biāo)識。隱私標(biāo)識分為{public}和{private}，缺省為{private}。標(biāo)識{public}的內(nèi)容明文輸出，標(biāo)識{private}的內(nèi)容以過濾回顯。
args	any[]	是	與格式字符串format對應(yīng)的可變長度參數(shù)列表。參數(shù)數(shù)目、參數(shù)類型必須與格式字符串中的標(biāo)識一一對應(yīng)。

示例：

輸出一條INFO信息，格式字符串為"%{public}s World %{private}d"。其中變參%{public}s為明文顯示的字符串；%{private}d為隱私的整型數(shù)。

hilog.info(0x0001, "testTag", "%{public}s World %{private}d", "hello", 3);

字符串"hello"填入%{public}s，整型數(shù)3填入%{private}d，輸出日志：

08-05 12:21:47.579  2695-2703/com.example.myapplication I 00001/testTag: hello World < private >

hilog.warn

warn(domain: number, tag: string, format: string, ...args: any[]) : void

打印WARN級別的日志。

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

參數(shù)：

參數(shù)名	類型	必填	說明
domain	number	是	日志對應(yīng)的領(lǐng)域標(biāo)識，范圍是0x0~0xFFFF，開發(fā)者可根據(jù)需要自定義。
tag	string	是	指定日志標(biāo)識，可以為任意字符串，建議用于標(biāo)識調(diào)用所在的類或者業(yè)務(wù)行為。
format	string	是	格式字符串，用于日志的格式化輸出。格式字符串中可以設(shè)置多個參數(shù)，參數(shù)需要包含參數(shù)類型、隱私標(biāo)識。隱私標(biāo)識分為{public}和{private}，缺省為{private}。標(biāo)識{public}的內(nèi)容明文輸出，標(biāo)識{private}的內(nèi)容以過濾回顯。
args	any[]	是	與格式字符串format對應(yīng)的可變長度參數(shù)列表。參數(shù)數(shù)目、參數(shù)類型必須與格式字符串中的標(biāo)識一一對應(yīng)。

示例：

輸出一條WARN信息，格式字符串為"%{public}s World %{private}d"。其中變參%{public}s為明文顯示的字符串；%{private}d為隱私的整型數(shù)。

hilog.warn(0x0001, "testTag", "%{public}s World %{private}d", "hello", 3);

字符串"hello"填入%{public}s，整型數(shù)3填入%{private}d，輸出日志：

08-05 12:21:47.579  2695-2703/com.example.myapplication W 00001/testTag: hello World < private >

hilog.error

error(domain: number, tag: string, format: string, ...args: any[]) : void

打印ERROR級別的日志。

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

參數(shù)：

參數(shù)名	類型	必填	說明
domain	number	是	日志對應(yīng)的領(lǐng)域標(biāo)識，范圍是0x0~0xFFFF，開發(fā)者可根據(jù)需要自定義。
tag	string	是	指定日志標(biāo)識，可以為任意字符串，建議用于標(biāo)識調(diào)用所在的類或者業(yè)務(wù)行為。
format	string	是	格式字符串，用于日志的格式化輸出。格式字符串中可以設(shè)置多個參數(shù)，參數(shù)需要包含參數(shù)類型、隱私標(biāo)識。隱私標(biāo)識分為{public}和{private}，缺省為{private}。標(biāo)識{public}的內(nèi)容明文輸出，標(biāo)識{private}的內(nèi)容以過濾回顯。
args	any[]	是	與格式字符串format對應(yīng)的可變長度參數(shù)列表。參數(shù)數(shù)目、參數(shù)類型必須與格式字符串中的標(biāo)識一一對應(yīng)。

示例：

輸出一條ERROR信息，格式字符串為"%{public}s World %{private}d"。其中變參%{public}s為明文顯示的字符串；%{private}d為隱私的整型數(shù)。

hilog.error(0x0001, "testTag", "%{public}s World %{private}d", "hello", 3);

字符串"hello"填入%{public}s，整型數(shù)3填入%{private}d，輸出日志：

08-05 12:21:47.579  2695-2703/com.example.myapplication E 00001/testTag: hello World < private >

hilog.fatal

fatal(domain: number, tag: string, format: string, ...args: any[]) : void

打印FATAL級別的日志。

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

參數(shù)：

參數(shù)名	類型	必填	說明
domain	number	是	日志對應(yīng)的領(lǐng)域標(biāo)識，范圍是0x0~0xFFFF，開發(fā)者可根據(jù)需要自定義。
tag	string	是	指定日志標(biāo)識，可以為任意字符串，建議用于標(biāo)識調(diào)用所在的類或者業(yè)務(wù)行為。
format	string	是	格式字符串，用于日志的格式化輸出。格式字符串中可以設(shè)置多個參數(shù)，參數(shù)需要包含參數(shù)類型、隱私標(biāo)識。隱私標(biāo)識分為{public}和{private}，缺省為{private}。標(biāo)識{public}的內(nèi)容明文輸出，標(biāo)識{private}的內(nèi)容以過濾回顯。
args	any[]	是	與格式字符串format對應(yīng)的可變長度參數(shù)列表。參數(shù)數(shù)目、參數(shù)類型必須與格式字符串中的標(biāo)識一一對應(yīng)。

示例：

輸出一條FATAL信息，格式字符串為"%{public}s World %{private}d"。其中變參%{public}s為明文顯示的字符串；%{private}d為隱私的整型數(shù)。

hilog.fatal(0x0001, "testTag", "%{public}s World %{private}d", "hello", 3);

字符串"hello"填入%{public}s，整型數(shù)3填入%{private}d，輸出日志：

08-05 12:21:47.579  2695-2703/com.example.myapplication F 00001/testTag: hello World < private >

審核編輯黃宇

聲明：本文內(nèi)容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場。文章及其配圖僅供工程師學(xué)習(xí)之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問題，請聯(lián)系本站處理。舉報投訴