Android 中的log4j使用

在前一篇文章中讲到了log4j 2.x版本的使用，一般来说，log4j都是使用在java开发中，安卓需要中无法直接使用log4j，需要其他的配置才能使用。要在Android开发中使用log4j，需要配置几个jar包。我使用的包分别为1)log4j-1.2.17.jar，2)android-logging-log4j-1.0.3.jar，3)slf4j-api-1.7.6.jar。其中android-logging-log4j-1.0.3.jar是专门开发来使log4j能够用在Android中的。下载这三个包之后，配置好工程中的路径，在工程下添加一个logback.xml文件，文件内容如下：

<configuration debug="true">

<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
<!-- encoders are  by default assigned the type
ch.qos.logback.classic.encoder.PatternLayoutEncoder -->
<encoder>
<pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
</encoder>
</appender>

<root level="debug">
<appender-ref ref="STDOUT" />
</root>
</configuration>

然后需要一个配置类，配置类是在最初运行时配置log的一些属性，比如log文件的名字，log的格式，log的存放位置等等。我们把配置类设计成单实例类，命名为ConfigureLog4J，在我的工程中其代码如下：

import java.io.File;

import org.apache.log4j.*;
import org.apache.log4j.LogManager;

import android.os.Environment;
import de.mindpipe.android.logging.log4j.LogConfigurator;

public enum ConfigureLog4J {

INSTANCE;

private LogConfigurator log_config = null;

private final String directory = Environment.getExternalStorageDirectory() + File.separator + "/single_execution";
private final String file_name = this.directory + "/execution.txt";

public void configure()
{
if (this.log_config == null)
{
log_config = new LogConfigurator();

log_config.setFileName(file_name);
log_config.setMaxFileSize(50 * 1024 * 1024);	// 50MB
log_config.setRootLevel(Level.DEBUG);
log_config.setFilePattern("%d{HH:mm:ss.S} %-5l - %m%n");
log_config.setUseLogCatAppender(false);

log_config.setImmediateFlush(false);

// Set log level of a specific logger
log_config.setLevel("ics.mobilememo", Level.DEBUG);

log_config.configure();
}
}

/**
* @return {@link #directory}: directory containing all the execution-related files
*/
public String getDirectory()
{
return this.directory;
}

/**
* @return {@link #file_name}: name of file in which the logs are stored
*/
public String getFileName()
{
return this.file_name;
}

/**
* Shut down the logger and let all buffered logs get flushed.
* See http://stackoverflow.com/a/3078377/1833118 */
public void shutdown()
{
LogManager.shutdown();
}
}

shutdown()是log结束时必须要调用的，否则log不会写到文件中，文件写失败。

写好这些，就可以开始使用了，我写了一个BatteryActivity的安卓工程来测试，

private final Logger log4android = Logger.getLogger(BatteryActivity.class);

在运行初始时，调用

ConfigureLog4J.INSTANCE.configure();

然后就可以使用log4j了。像这样：

log4android.debug("hello world");

在Activity的onDestroy()中调用

ConfigureLog4J.INSTANCE.shutdown();

当应用运行结束，被销毁时，就可以得到一个log文件，log文件的位置在ConfigureLog4J类的配置所指明的位置。打开log文件就可以看到写入的log。