開源項目 log4android 使用方式詳解

標籤：android   style   http   io   ar   color   使用   sp   for   

      話不多說， 直接上主題。

      log4android 是一個類似於log4j的開源android 日誌記錄項目。 項目基於 microlog 改編而來， 新加入了對檔案輸出的各種定義方式。

 

項目地址： 點擊這裡  (https://github.com/lisicnu/Log4Android)

 

使用方式: 

0. 匯入包.

    項目已經發布到maven倉庫中, 可以直接匯入包, 目前的版本為 1.0.0

    gradle編譯中如下:

         compile ‘com.github.lisicnu:log4android:1.0.0‘ 

 

1. 初始化方法.

    LogManager.init(Context) ,  預設到  assets目錄下尋找microlog.properties的檔案 對日誌進行初始化.

    LogManager.init(Context,int), 開啟指定的資源檔進行初始化, 不可指定SD卡檔案.

    LogManager.init(Context,int, boolean), 開啟指定的檔案進行初始化, 可指定SD卡檔案.

 

2. 注意點.

    LogManger.isDebug 此屬性確定是否是測試模式, 如果是測試模式, 將直接輸出到 logcat中, 否則按設定檔進行輸出.

    建議使用方式. LogManager.isDebug = BuildConfig.DEBUG;  此值預設為true.

 

3. 使用方式.

    調用 LogManager.v(String ,Object). 等方法進行日誌記錄. 使用方式和 android.utl.Log 方法一樣.

 

4. 設定檔

完整設定檔例子:

     microlog.formatter=PatternFormatter
     microlog.formatter.PatternFormatter.pattern=%i %c %d [%P] %m %T
     microlog.appender=FileAppender
     microlog.appender.FileAppender.File=logs
     microlog.appender.FileAppender.Options=%a %f-yyyyMMdd
     microlog.level=DEBUG
     microlog.addDefaultLogger=true

 

     其中, PatternFormater 中的 含義如下

        %i :  // 輸出設定的clientId.        %c :  // 輸出logger的名稱.        %d :  // 輸出絕對時間        %m :  // 輸出訊息        %P :  // 輸出等級, 如 DEBUG, WARNING, ERROR 等.        %r :  // 輸出從設定之後的相對時間.        %t :  // 輸出線程名        %T :  // 輸出 throwable的詳細資料.        %% :  // 輸出 %.

microlog.appender.FileAppender.File  此屬性設定檔案夾名稱, 預設路徑為程式外置sd卡資料目錄下的logs檔案夾.
microlog.appender.FileAppender.Options  設定輸出檔案的屬性.

        %a :  // 追加到記錄檔中. 如果沒有,則建立新檔案.        %f :  // 指定使用日期為檔案命名,後可能具體的日期格式. 如 yyyyMMddHHmmss, yyyMMddHHmm等. e.g. %f-yyyyMMddHHmmss        %p :  // 使用固定檔案名稱, 當檔案大小達到最大時,預設追加數字索引. 當使用此屬性時, microlog.appender.FileAppender.File將被識別為檔案名稱的首碼.        %s :  // 檔案的最大大小, 單位為 M. 0 或者不設定表示不分割檔案. 如 %s-0.5

 

開源項目 log4android 使用方式詳解