開源項目 log4android 使用方式詳解

話不多說， 直接上主題。

      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