Unity日志管理
Unity的日志輸出在編輯器中初肉，而且格式詭異厢钧，不方便查看。著實不利于開發(fā)睹逃，在Java開發(fā)時候我們有Log4j盗扇，Logback等日志框架，格式定義舒服又方便沉填。這不Unity好像沒有粱玲，那就自己打造一個吧。
需求分析
- 可以輸出到文件
- 異步打印日志拜轨，提高性能
- 追加打印而不是重啟重頭開始
- 易于使用
需求實現(xiàn)
做過Java開發(fā)的人都知道抽减，Java中的Log4j等日志框架都通過各種各樣的Appender來擴展輸出實現(xiàn)。
這里只是以一種實現(xiàn)講解一下思路：
先定義一個Appender的接口
/// <summary>
/// 日志Appender
/// </summary>
public interface ILogAppender
{
/// <summary>
/// 記錄日志
/// </summary>
/// <param name="log">Log.</param>
void Log(LogData logData);
}
來個RollingFileAppender的實現(xiàn)：
public class RollingFileAppender : AsyncTask, ILogAppender
{
#if UNITY_EDITOR
string logRootPath = Application.dataPath + "/Log";
#elif UNITY_STANDALONE_WIN
string logRootPath = Application.dataPath + "/Log";
#elif UNITY_STANDALONE_OSX
string logRootPath = Application.dataPath + "/Log";
#else
string logRootPath = Application.persistentDataPath + "/Log";
#endif
// 時間格式化
protected const string TIME_FORMATER = "yyyy-MM-dd hh:mm:ss,fff";
/// <summary>
/// 文件最大值 10M
/// </summary>
private int maxFileSize = 10 * 1024 * 1024;
// 文件Writer
private StreamWriter streamWriter;
// 文件流
private FileStream fileStream;
// 文件路徑
private string filePath;
// 寫日志隊列
private List<LogData> writeList;
// 等待隊列
private List<LogData> waitList;
// 鎖
private object lockObj;
// 是否停止的標(biāo)志
private bool stopFlag;
/// <summary>
/// 構(gòu)造函數(shù)
/// </summary>
public RollingFileAppender ()
{
this.filePath = Path.Combine (logRootPath, "game.log");
if (File.Exists (filePath)) {
this.fileStream = new FileStream (filePath, FileMode.Append);
this.streamWriter = new StreamWriter (this.fileStream);
this.streamWriter.AutoFlush = true;
} else {
if (!Directory.Exists (logRootPath)) {
Directory.CreateDirectory (logRootPath);
}
this.fileStream = new FileStream (filePath, FileMode.Create);
this.streamWriter = new StreamWriter (this.fileStream);
this.streamWriter.AutoFlush = true;
}
this.writeList = new List<LogData> ();
this.waitList = new List<LogData> ();
this.lockObj = new object ();
this.stopFlag = false;
// 開始執(zhí)行
MultiThreadMgr.AddAsyncTask (this);
}
/// <summary>
/// 記錄日志
/// </summary>
/// <param name="log">Log.</param>
/// <param name="logData">Log data.</param>
public void Log (LogData logData)
{
lock (lockObj) {
waitList.Add (logData);
Monitor.PulseAll (lockObj);
}
}
/// <summary>
/// 關(guān)閉執(zhí)行
/// </summary>
public override void Close ()
{
this.stopFlag = true;
if (null != this.fileStream) {
this.fileStream.Close ();
}
}
/// <summary>
/// 開始運行
/// </summary>
public override void Run ()
{
while (!stopFlag) {
lock (lockObj) {
if (waitList.Count == 0) {
Monitor.Wait (lockObj);
}
this.writeList.AddRange (this.waitList);
this.waitList.Clear ();
}
foreach (LogData data in writeList) {
// 寫日志
this.streamWriter.WriteLine (String.Format ("{0}#{1}#{2}", System.DateTime.Now.ToString (TIME_FORMATER), data.Tag, data.Log));
// 寫堆棧
if (null != data.Track) {
this.streamWriter.WriteLine (data.Track);
}
// 判斷是否觸發(fā)策略
HandleTriggerEvent ();
}
}
}
/// <summary>
/// 處理Trigger事件
/// </summary>
private void HandleTriggerEvent() {
if (this.fileStream.Length >= maxFileSize) {
// 文件超過大小橄碾，重頭開始寫
this.streamWriter.Close ();
this.fileStream.Close ();
// 重新開始寫
this.fileStream = new FileStream (this.filePath, FileMode.Create);
this.streamWriter = new StreamWriter (this.fileStream);
this.streamWriter.AutoFlush = true;
}
}
}
LogData定義
/// <summary>
/// Log的具體內(nèi)容
/// </summary>
public class LogData
{
/// <summary>
/// Log具體內(nèi)容
/// </summary>
/// <value>The log.</value>
public string Log{ get; set; }
/// <summary>
/// Log標(biāo)記
/// </summary>
/// <value>The tag.</value>
public string Tag{ get; set; }
/// <summary>
/// Log堆棧信息
/// </summary>
/// <value>The track.</value>
public string Track{ get; set; }
}
該實現(xiàn)用到了上一篇講到的Unity多線程管理卵沉，基本思路如下：
- 雙隊列颠锉，一個隊列用于添加日志內(nèi)容，一個隊列用于寫日志
- 超過文件大小史汗，重頭開始寫
我對外暴露一個Log接口琼掠，實現(xiàn)如下：
public class Log
{
// logAppender
private ILogAppender logAppender;
/// <summary>
/// 日志等級，為不同輸出配置用
/// </summary>
public const int DEBUG = 0;
public const int INFO = 1;
public const int WARNING = 2;
public const int ERROR = 3;
public const int FATAL = 4;
// Log實例
protected static Log instance = null;
/// <summary>
/// 獲取實例
/// </summary>
/// <value>The instance.</value>
public static Log Instance {
get{
if (null == instance) {
instance = new Log ();
}
return instance;
}
}
/// <summary>
/// 設(shè)置日志級別
/// </summary>
/// <value>The log level.</value>
public int LogLevel {
get;
set;
}
/// <summary>
/// 構(gòu)造函數(shù)
/// </summary>
private Log() {
LogLevel = INFO;
logAppender = new RollingFileAppender();
}
/// <summary>
/// debug Log
/// </summary>
/// <param name="log">Log.</param>
public void debug(object log) {
if (LogLevel > DEBUG) {
return;
}
LogData data = new LogData ();
data.Log = log.ToString();
data.Tag = "DEBUG";
logAppender.Log (data);
}
/// <summary>
/// info Log
/// </summary>
/// <param name="log">Log.</param>
public void info(object log) {
if (LogLevel > INFO) {
return;
}
LogData data = new LogData ();
data.Log = log.ToString();
data.Tag = "INFO";
logAppender.Log (data);
}
/// <summary>
/// warn Log
/// </summary>
/// <param name="log">Log.</param>
public void warn(object log) {
if (LogLevel > WARNING) {
return;
}
LogData data = new LogData ();
data.Log = log.ToString();
data.Tag = "WARN";
logAppender.Log (data);
}
/// <summary>
/// warn Log
/// </summary>
/// <param name="log">Log.</param>
public void warn(object log, string track) {
if (LogLevel > WARNING) {
return;
}
LogData data = new LogData ();
data.Log = log.ToString();
data.Tag = "WARN";
data.Track = track;
logAppender.Log (data);
}
/// <summary>
/// warn Log
/// </summary>
/// <param name="log">Log.</param>
public void warn(object log, Exception e) {
if (LogLevel > WARNING) {
return;
}
LogData data = new LogData ();
data.Log = log.ToString();
data.Tag = "WARN";
data.Track = GetExceptionTrack(e);
logAppender.Log (data);
}
/// <summary>
/// error Log
/// </summary>
/// <param name="log">Log.</param>
public void error(object log) {
if (LogLevel > ERROR) {
return;
}
LogData data = new LogData ();
data.Log = log.ToString();
data.Tag = "ERROR";
logAppender.Log (data);
}
/// <summary>
/// error Log
/// </summary>
/// <param name="log">Log.</param>
public void error(object log, string track) {
if (LogLevel > ERROR) {
return;
}
LogData data = new LogData ();
data.Log = log.ToString();
data.Tag = "ERROR";
data.Track = track;
logAppender.Log (data);
}
/// <summary>
/// error Log
/// </summary>
/// <param name="log">Log.</param>
public void error(object log, Exception e) {
if (LogLevel > ERROR) {
return;
}
LogData data = new LogData ();
data.Log = log.ToString();
data.Tag = "ERROR";
data.Track = GetExceptionTrack(e);
logAppender.Log (data);
}
/// <summary>
/// error Log
/// </summary>
/// <param name="log">Log.</param>
public void fatal(object log) {
LogData data = new LogData ();
data.Log = log.ToString();
data.Tag = "FATAL";
logAppender.Log (data);
}
/// <summary>
/// error Log
/// </summary>
/// <param name="log">Log.</param>
public void fatal(object log, string track) {
LogData data = new LogData ();
data.Log = log.ToString();
data.Tag = "FATAL";
data.Track = track;
logAppender.Log (data);
}
/// <summary>
/// error Log
/// </summary>
/// <param name="log">Log.</param>
public void fatal(object log, Exception e) {
LogData data = new LogData ();
data.Log = log.ToString();
data.Tag = "FATAL";
data.Track = GetExceptionTrack(e);
logAppender.Log (data);
}
/// <summary>
/// 獲取異常堆棧
/// </summary>
/// <returns>The exception track.</returns>
/// <param name="e">E.</param>
private string GetExceptionTrack(Exception e) {
StringBuilder builder = new StringBuilder (120);
builder.Append (e.Message).Append("\n");
if (!string.IsNullOrEmpty (e.StackTrace)) {
builder.Append (e.StackTrace);
}
return builder.ToString ();
//
// StackTrace stackTrace = e.StackTrace;
// StackFrame[] stackFrames = stackTrace.GetFrames ();
// foreach (StackFrame frame in stackFrames) {
// builder.Append ("\t at ")
// .Append (frame.GetFileName())
// .Append (".")
// .Append(frame.GetMethod())
// .Append(":")
// .Append(frame.GetFileLineNumber())
// .Append("\n");
// }
// return builder.ToString ();
}
}
后續(xù)改進
- 多Appender支持停撞，至少要擴展ConsoleAppender
- 可配置
