XLog 使用教程

1. 项目目录结构及介绍

XLog 的源码仓库通常具有以下基本目录结构：

.
├── src
│   ├── main
│   │   ├── java
│   │   │   └── com.elvishew.xlog     # 主要Java代码存放路径，包括核心类和接口
│   │   └── res                      # 可能包含一些资源文件，如XML配置
└── README.md                       # 项目说明文档
└── build.gradle                    # 项目构建配置文件
└── ...

src/main/java/com.elvishew.xlog 存放着XLog的核心类和接口，如XLog，LogConfiguration等，它们定义了日志打印的主要功能和配置方式。

2. 项目启动文件介绍

在Android应用中，XLog的初始化通常在应用程序的Application子类的onCreate()方法中进行。主要涉及以下步骤：

public class MyApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        
        // 初始化XLog，设置日志级别为DEBUG并启用异步模式
        XLog.init(LogLevel.DEBUG);
        
        // 如果需要，可以自定义日志保存路径和控制台打印开关
        String cachePath = getFilesDir() + "/xlog";
        String logPath = Environment.getExternalStorageDirectory().getPath() + "/Marssample/log";
        XLog.appenderOpen(LogLevel.DEBUG, XLog.AppenderMode.ASYNC, cachePath, logPath, "MyApp", 0, "");
        XLog.setConsoleLogOpen(true);

        // 更多配置...
    }
}

这里，XLog.init(LogLevel.DEBUG)用于初始化全局的日志配置，而XLog.appenderOpen()则用来打开日志追加器，指定日志保存的位置和模式。

3. 项目配置文件介绍

XLog 的配置可以通过 LogConfiguration 类来完成。在初始化时，可以创建一个 Builder 对象来定制配置：

LogConfiguration config = new LogConfiguration.Builder()
    .logLevel(BuildConfig.DEBUG)       // 设置日志级别
    .tag("MY_TAG")                     // 设置日志标签
    .enableThreadInfo()                // 启用线程信息
    .enableStackTrace(2)               // 启用堆栈跟踪，深度为2
    .enableBorder()                    // 启用边框
    .build();

// 使用自定义配置初始化
XLog.init(config);

通过这种方式，你可以自由地调整日志输出的细节，满足不同场景的需求。

以上就是XLog的基本结构、启动和配置介绍。在实际应用中，根据需求进行适当的调整，就可以充分利用这个强大的日志框架了。