Unity接入日志插件Log4Net

article/2025/9/29 16:25:13

前言

log4net是一个日志插件，可以帮助我们把控制台输出的日志写入到本地。这个功能说简单就简单，说复杂其实还挺复杂。
为什么这么说呢，首先文件写入本地确实简单，但是如果你要实现一下功能就没那么简单了。

1.把每行日志按照指定格式写入，方便查看，
2.按照不同日期切分日志文件
3.日志文件太大可以自动切换文件，即：日志轮转功能。
4.可以自定义设置最大文件大小
5.可以自定义多久清理一次日志
相比大家就知道，实现一个好的日志管理系统没那么容易了。而log4net就是这么一个工具可以帮助我们。

下载地址：

Github地址：https://github.com/apache/logging-log4net
官网地址：https://logging.apache.org/log4net/download_log4net.html

导入插件

下载完插件，里面有很多不同net版本的，我们直接导入net45的版本，记得把Unity的API Compabbility Level 设置为.Net4.x

在这里插入图片描述

log4net.configer配置文件

配置文件的配置方式：https://logging.apache.org/log4net/release/manual/configuration.html
这里给大家提供一个log4net.configer，放到项目Assets/StreamingAssets目录下

<?xml version="1.0" encoding="utf-8" ?>
<configuration><configSections><section name="log4net" type="System.Configuration.IgnoreSectionHandler"/></configSections><appSettings></appSettings><log4net><appender name="FileAppender" type="log4net.Appender.RollingFileAppender"><!--保存到文件-->     <file type="log4net.Util.PatternString" value="%property{ApplicationLogPath}\\%property{LogFileName}.log" /><rollingStyle value="Composite" /><datePattern value="yyyy-MM-dd" /><staticLogFileName value="false" /><param name="Encoding" value="utf-8" />  <maximumFileSize value="100MB" />      <countDirection value="0" />         <maxSizeRollBackups value="100" /><appendToFile value="true" />      <layout type="log4net.Layout.PatternLayout"><conversionPattern value="记录时间：%date 线程：[%thread] 日志级别：%-5level 记录类：%logger 日志消息：%message%newline" /></layout></appender><appender name="UiLogAppender" type="UiLogAppender"></appender><logger name="FileLogger" additivity="false">    <level value="DEBUG" /><appender-ref ref="FileAppender" /></logger></log4net>
</configuration>

集成类

我们调用一下Logger.Init()函数即可，不用做其他任何操作了。正常使用Unity自带的Debug.LogXXX即可。

using System.IO;
using log4net;
using UnityEngine;public static class Logger
{private static ILog log = LogManager.GetLogger("FileLogger"); //FileLoggerpublic static void Init(){Application.logMessageReceived += onLogMessageReceived; //添加unity日志监听//ApplicationLogPath和LogFileName在log4net.config中使用FileInfo file = new System.IO.FileInfo(Application.streamingAssetsPath+ "/log4net.config"); //获取log4net配置文件GlobalContext.Properties["ApplicationLogPath"] = Path.Combine(Directory.GetCurrentDirectory(), "Log"); //日志生成的路径GlobalContext.Properties["LogFileName"] = "log"; //生成日志的文件名log4net.Config.XmlConfigurator.ConfigureAndWatch(file); //加载log4net配置文件Debug.Log("日志初始化");}private static void onLogMessageReceived(string condition, string stackTrace, LogType type){switch (type){case LogType.Error:log.ErrorFormat("{0}\r\n{1}", condition, stackTrace.Replace("\n", "\r\n"));break;case LogType.Assert:log.DebugFormat("{0}\r\n{1}", condition, stackTrace.Replace("\n", "\r\n"));break;case LogType.Exception:log.FatalFormat("{0}\r\n{1}", condition, stackTrace.Replace("\n", "\r\n"));break;case LogType.Warning:log.WarnFormat("{0}\r\n{1}", condition, stackTrace.Replace("\n", "\r\n"));break;default:log.Info(condition);break;}}
}