最近在做一個(gè) Android APP 的日志改造時(shí)，想要滿足如下需求：

• 能夠很方便地使用可變參數(shù)的方式輸出日志；
• 日志能夠根據(jù)級(jí)別輸出到控制臺(tái)和文件；
• 能夠按照日期和文件大小進(jìn)行日志文件的切割，滾動(dòng)保存指定天數(shù)的日志，自動(dòng)清理舊日志。

基于這個(gè)需求，我搜了一下「Android 日志框架」，大多網(wǎng)友推薦的是 logger、timber、xLog 等等，看著也不錯(cuò)。不過(guò)出于幾年后端開發(fā)的經(jīng)驗(yàn)和習(xí)慣，我進(jìn)一步了解，發(fā)現(xiàn)熟悉的 log4j 和 logback 在 Android 上也有人做過(guò)適配，所以最終決定使用 slf4j + logback，以在前后端開發(fā)中取得一致的體驗(yàn)。

做過(guò) Java 后端開發(fā)的同學(xué)，對(duì)于 slf4j + logback 的組合一般不陌生，而 Android 開發(fā)的同學(xué)則可能不一定聽過(guò)它們。所以，本文將從零開始，記錄如何在 Android APP 中集成 slf4j + logback 作為日志框架，并使用 Lombok 注解生成日志對(duì)象。

集成 slf4j + logback

logback-android 項(xiàng)目地址：https://github.com/tony19/logback-android

1.在項(xiàng)目/模塊的 build.gradle 文件中添加依賴：

dependencies {
  implementation 'org.slf4j:slf4j-api:2.0.7'
  implementation 'com.github.tony19:logback-android:3.0.0'
}

如果是單模塊項(xiàng)目，可以直接在 app/build.gradle 文件中添加，如果是多模塊項(xiàng)目，可以在一個(gè)公共模塊的 build.gradle 文件中添加，記得將 slf4j-api 的 implementation 改為 api 才可被其它模塊引用。

2.創(chuàng)建日志配置文件 app/src/main/assets/logback.xml：

<configuration debug="false"
    xmlns="https://tony19.github.io/logback-android/xml"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="https://tony19.github.io/logback-android/xml https://cdn.jsdelivr.net/gh/tony19/logback-android/logback.xsd"
>

    <property name="LOG_DIR" value="${EXT_DIR:-${DATA_DIR}}/test/log"/>
    
    <appender name="logcat" class="ch.qos.logback.classic.android.LogcatAppender">
        <tagEncoder>
            <pattern>%logger{12}</pattern>
        </tagEncoder>
        <encoder>
            <pattern>[%-20thread] %msg</pattern>
        </encoder>
    </appender>

    <appender name="local_file" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_DIR}/test.log</file>
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${LOG_DIR}/test.%d.log</fileNamePattern>
            <maxHistory>15</maxHistory>
        </rollingPolicy>
    </appender>

    <root level="DEBUG">
        <appender-ref ref="logcat" />
    </root>

    <root level="INFO">
        <appender-ref ref="local_file" />
    </root>
</configuration>

以上配置表示 DEBUG 及以上級(jí)別的日志輸出到控制臺(tái)，INFO 及以上級(jí)別的日志輸出到文件，文件按照日期切割，最多保留 15 天的日志。

大家可以按需配置，比如還可以限定單個(gè)文件大小、自定義日志輸出的格式等等。

在項(xiàng)目的 Wiki 里提到有一點(diǎn)是 Android 開發(fā)者比較關(guān)注的，就是日志有保存路徑，既可以指定絕對(duì)路徑，也可以用變量，比如：

• ${DATA_DIR} 表示 Context.getFilesDir()；
• ${EXT_DIR} 表示 Context.getExternalFilesDir(null)；
• ${EXT_DIR:-${DATA_DIR}} 表示當(dāng) EXT_DIR 可用時(shí)使用 EXT_DIR，否則使用 DATA_DIR；
• ${PACKAGE_NAME} 表示包名；
• ${VERSION_NAME} 表示版本名；
• ${VERSION_CODE} 表示版本號(hào)。

3.可以開始使用 slf4j 的 API 進(jìn)行日志打印了：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

// 聲明 logger
Logger log = LoggerFactory.getLogger(MainActivity.class);

// 打印日志
log.info("hello world");
log.info("number {}, boolean {}, string {}, object {}", 1, true, "string", new Object());

運(yùn)行 APP，可以看到日志輸出到 logcat 和對(duì)應(yīng)位置的文件。

當(dāng)對(duì)配置有疑問(wèn)，需要調(diào)試時(shí)，可以將上面配置文件里的 debug="false" 改為 debug="true"，這樣 logback 就會(huì)輸出詳細(xì)的信息，方便我們定位問(wèn)題。

使用 Lombok 注解生成日志對(duì)象

在上一部分的第 3 步，在每一個(gè)需要使用 logger 的類里，都需要手動(dòng)去聲明 logger，如 Logger log = LoggerFactory.getLogger(MainActivity.class);，不算方便。

這里我們可以使用 Lombok 注解來(lái)簡(jiǎn)化這一步驟，自動(dòng)生成 logger 對(duì)象。

Lombok 官方提供了 Android 平臺(tái)的集成說(shuō)明：https://projectlombok.org/setup/android。

基于 Android Studio 環(huán)境，要做的其實(shí)就兩步。

1.安裝 Lombok 插件：

Settings -> Plugins -> 搜索 Lombok -> 安裝

注：Android Studio 版本 2020.3.1 - 2022.3.1，JetBrains 官方插件市場(chǎng)無(wú)法搜索到兼容版本的 Lombok 插件，可以參考 https://gitee.com/sgpublic/lombok-plugin-repository 解決。

2.在需要使用的模塊的 build.gradle 文件里添加如下內(nèi)容：

dependencies {
	compileOnly 'org.projectlombok:lombok:1.18.30'
	annotationProcessor 'org.projectlombok:lombok:1.18.30'
}

然后，就可以使用 @Slf4j 注解來(lái)自動(dòng)生成 logger 對(duì)象了，現(xiàn)在的使用姿勢(shì)簡(jiǎn)化成了這樣：

@Slf4j
public class Test {
    public void test() {
        log.info("hello world");
    }
}

小結(jié)

好了以上就是在 Android 里集成 slf4j + logback 的記錄了，至此我「統(tǒng)一」了 Java 后端和 Android 客戶端打印日志的用法，在避免多項(xiàng)目維護(hù)造成「精神分裂」的路上前進(jìn)了一小步。

本文所列代碼示例已上傳至 GitHub，地址：https://github.com/mzlogin/AndroidPractices/tree/master/android-studio/LogbackDemo