Xamarin：如何通过C#代码读取第三方库的应用日志

这个问题我之前帮朋友处理过，得按Android和iOS两个平台分开说，因为原生第三方库的日志输出机制在俩平台上完全不一样：

Android原生库基本都是通过android.util.Log输出日志的，我们可以通过两种方式捕获：

• 优先用系统日志回调：Xamarin/.NET MAUI提供了直接监听Android原生日志的事件，能捕获所有通过系统Log输出的内容，包括第三方库的：

  // 在Android项目的MainApplication.cs的OnCreate方法里注册
  Android.Runtime.AndroidEnvironment.LogMessage += (sender, args) =>
  {
      // 解析日志信息：级别、标签、内容
      string logContent = $"[{args.Priority}] {args.Tag}: {args.Message}";
      // 这里可以把日志存到本地文件、上传服务器，或者输出到自己的调试面板
      Debug.WriteLine($"捕获到原生日志: {logContent}");
  };
  

  这种方式不需要额外权限，是最省心的方案。
• 读取LogCat输出（备选）：如果上面的方式没生效，可以直接启动logcat进程捕获输出，但注意Android 11及以上需要READ_LOGS权限，且普通应用可能无法获取该权限：

  using System.Diagnostics;
  
  // 在合适的地方启动日志读取进程
  var logcatProcess = new Process
  {
      StartInfo = new ProcessStartInfo
      {
          FileName = "logcat",
          Arguments = "-v time", // 带上时间戳格式
          RedirectStandardOutput = true,
          UseShellExecute = false,
          CreateNoWindow = true
      }
  };
  
  logcatProcess.OutputDataReceived += (sender, args) =>
  {
      if (!string.IsNullOrEmpty(args.Data))
      {
          Debug.WriteLine($"LogCat输出: {args.Data}");
      }
  };
  
  logcatProcess.Start();
  logcatProcess.BeginOutputReadLine();
  

  别忘了在AndroidManifest.xml中添加权限：

  <uses-permission android:name="android.permission.READ_LOGS" />
  

iOS原生库的日志分两种：NSLog输出到标准错误流，os_log输出到系统日志，对应两种捕获方式：

• 重定向标准错误流（针对NSLog）：NSLog的内容会输出到stderr，我们可以重定向这个流来捕获：

  using System;
  using System.IO;
  using ObjCRuntime;
  
  // 在iOS项目的AppDelegate.cs的FinishedLaunching方法里调用
  public static void CaptureNSLogs()
  {
      // 获取stderr的句柄并创建读取流
      IntPtr stderrHandle = Stdio.stderr;
      var logReader = new StreamReader(new UnixStream(stderrHandle));
      
      // 异步读取日志
      _ = Task.Run(async () =>
      {
          string line;
          while ((line = await logReader.ReadLineAsync()) != null)
          {
              Debug.WriteLine($"捕获到NSLog日志: {line}");
          }
      });
  }
  

• 读取系统日志（针对os_log）：如果第三方库用的是os_log，就得读取系统日志，但iOS 14及以上需要特殊权限，且App Store审核可能受限，适合调试用：

  using Foundation;
  using OSLog;
  
  // 读取最近5分钟的系统日志，可根据需要调整时间范围
  public static void ReadOSLogs()
  {
      var logStore = OSLogStore.Default;
      var startTime = DateTime.Now.AddMinutes(-5);
      // 可以通过subsystem或category筛选第三方库的日志，不知道的话可以先去掉条件捕获所有日志
      var filterPredicate = NSPredicate.FromFormat("subsystem CONTAINS[c] '第三方库的subsystem'");
      
      foreach (var entry in logStore.GetEntries(startTime, filterPredicate))
      {
          if (entry is OSLogEntryLog logEntry)
          {
              string logContent = $"[{logEntry.Date}] {logEntry.Subsystem}.{logEntry.Category}: {logEntry.Message}";
              Debug.WriteLine(logContent);
          }
      }
  }
  

• 如果第三方库用的是自定义日志输出（不是平台原生的Log/NSLog/os_log），那得反编译原生库看看它的日志接口，然后通过C#绑定实现对应的回调接口，注册到库中才能捕获。
• 如果你用的是.NET MAUI，把对应平台的代码放到Platforms/Android/MainApplication.cs和Platforms/iOS/AppDelegate.cs的启动逻辑里就行。

内容的提问来源于stack exchange，提问作者Vitaliy Mykhaylovskiy