安卓日志文件的写入与管理

在项目开发中，经常需要通过日志来进行调试和疑难排查。而日志持久化是真正开发线上app必不可少的。安卓本身的Log类，是将日志输出到控制台，并不能输出到文件。本文介绍一个简单实用的LogUtils的用法和实现逻辑，可以将Log写出到日志中，给大家做参考。源码在此：log-to-file。
使用该LogUtils类，需要在Application的onCreate中添加初始化代码，如下：

private void initLog() {
    LogUtils.setLogDir(YiqiConfig.getLogFolderPath());
    if (EnvironmentUtils.getVersionName().toLowerCase().contains("beta")) {
        LogUtils.setLogLevel(LogUtils.LogLevel.DEBUG);
    } else {
        // 为了保护隐私和保证log的整洁，正式版上只打比warn高的log，即warn, error和assert
        LogUtils.setLogLevel(LogUtils.LogLevel.WARN);
    }
}

用法和android.utils.Log一样，方法名和参数都一一对应。增加的功能就是在输出到控制台之后，还会输出到日志文件中，以及管理日志文件的个数。单个日志文件的大小和日志文件的个数都可以在代码中设置。

private static final int LOG_FILES_MAX_NUM = 5; //文件最多有5个
private static final int LOG_FILE_MAX_SIZE = 1024 * 1024; //文件最大1MB

当写满一个文件时，创建新的日志文件，如果文件个数超过最大数，就删掉最老的日志文件。
主要逻辑下面这个方法中：

private File getNewLogFile() {
    File dir = new File(mLogFileDir);
    File[] files = dir.listFiles(fileFilter);
    if (files == null || files.length == 0) {
        // 创建新文件
        return createNewLogFile();
    }
    List<File> sortedFiles = sortFiles(files);
    if (files.length > LOG_FILES_MAX_NUM) {
        // 删掉最老的文件
        FileUtils.delete(sortedFiles.get(0));
    }
    // 取最新的文件，看写没写满
    File lastLogFile = sortedFiles.get(sortedFiles.size() - 1);
    if (lastLogFile.length() < LOG_FILE_MAX_SIZE) {
        return lastLogFile;
    } else {
        // 创建新文件
        return createNewLogFile();
    }
}

首先判断是否没有任何日志文件，如果是，直接创建新的日志文件；如果已经存在日志文件，判断当前日志文件个数是否超过最大数，如果超过，则删掉最老的日志文件；最后再判断最新的文件是否写满，没写满直接写在该文件中，写满的话，就新建一个新的文件。