Easylogging++ 项目教程

1. 项目的目录结构及介绍

Easylogging++ 是一个轻量级的 C++ 日志库，其 GitHub 仓库的目录结构如下：

easyloggingpp/
├── CMakeLists.txt
├── LICENSE
├── README.md
├── appveyor.yml
├── build/
├── cmake/
├── doc/
├── easylogging++.cc
├── easylogging++.h
├── examples/
├── scripts/
├── tests/
└── thirdparty/

目录介绍

• CMakeLists.txt: CMake 构建文件。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文档。
• appveyor.yml: AppVeyor 持续集成配置文件。
• build/: 构建目录，用于存放构建生成的文件。
• cmake/: CMake 相关脚本和配置文件。
• doc/: 项目文档，包括使用手册和 API 文档。
• easylogging++.cc: 日志库的源文件。
• easylogging++.h: 日志库的头文件。
• examples/: 示例代码，展示如何使用 Easylogging++。
• scripts/: 项目相关的脚本文件。
• tests/: 单元测试和集成测试代码。
• thirdparty/: 第三方依赖库。

2. 项目的启动文件介绍

Easylogging++ 的启动文件主要是 easylogging++.h 和 easylogging++.cc。这两个文件包含了日志库的所有功能实现。

easylogging++.h

这是 Easylogging++ 的头文件，包含了所有必要的类和宏定义。在使用 Easylogging++ 时，首先需要包含这个头文件：

#include "easylogging++.h"

easylogging++.cc

这是 Easylogging++ 的源文件，包含了头文件中定义的类的具体实现。通常情况下，用户不需要直接包含这个文件，因为它会在编译时自动与头文件一起编译。

3. 项目的配置文件介绍

Easylogging++ 的配置可以通过代码进行，也可以通过配置文件进行。配置文件通常是一个文本文件，格式为 INI 格式。

配置文件示例

以下是一个简单的配置文件示例：

* GLOBAL:
   FORMAT = "%datetime{%Y-%M-%d %H:%m:%s.%g} %levshort %msg"
   FILENAME = "logs/myapp.log"
   ENABLED = true
   TO_FILE = true
   TO_STANDARD_OUTPUT = true
   SUBSECOND_PRECISION = 3
   PERFORMANCE_TRACKING = true
   MAX_LOG_FILE_SIZE = 2097152 ## 2MB

* DEBUG:
   FORMAT = "%datetime %levshort %func %line %msg"

配置项介绍

• GLOBAL: 全局配置项，适用于所有日志级别。

  • FORMAT: 日志格式。
  • FILENAME: 日志文件名。
  • ENABLED: 是否启用日志记录。
  • TO_FILE: 是否将日志写入文件。
  • TO_STANDARD_OUTPUT: 是否将日志输出到标准输出。
  • SUBSECOND_PRECISION: 时间戳的毫秒精度。
  • PERFORMANCE_TRACKING: 是否启用性能跟踪。
  • MAX_LOG_FILE_SIZE: 日志文件的最大大小。

• DEBUG: 针对 DEBUG 级别的日志配置。

  • FORMAT: 日志格式。

加载配置文件

在代码中加载配置文件的方法如下：

#include "easylogging++.h"

INITIALIZE_EASYLOGGINGPP

int main(int argc, char* argv[]) {
    el::Configurations conf("path/to/your-logging.conf");
    el::Loggers::reconfigureAllLoggers(conf);

    LOG(INFO) << "My first info log using default logger";
    return 0;
}

通过以上步骤，你可以配置和使用 Easylogging++ 日志库。