jaraio.MauiRemoteLoggingClient 1.0.0

.NET MAUI Remote Log Viewer

A high-performance, real-time remote logging solution for .NET MAUI, perfect for debugging issues in released applications.

This project streams logs from your app—whether on a test emulator or a user's device—to a standalone desktop server. It allows you to capture and analyze errors, warnings, and trace information that you can't reproduce in a local debugging session.

Key Features

Server (Electron App)

• Live Log Stream: View logs instantly as they arrive.
• Log Filtering: Toggle between All, Error,Warn, Info, and Trace levels.
• Dark Mode UI: Clean, dark-themed interface that's easy on the eyes.
• Utilities: Includes line numbers, auto-scroll, clear logs, and export to .txt.
• Status: Shows server status (Offline, Running, Error) and port.

Client (.NET MAUI Service)

• High-Performance & Non-Blocking: Uses System.Threading.Channels for a lock-free, asynchronous producer-consumer pattern. This ensures that logging never blocks your app's UI thread or impacts performance, making it safe for release builds.
• Resilient Connection: Automatically retries connection to the server if it's lost, with configurable delay.
• Clean Integration: Registers and configures the service with a single, clean line in MauiProgram.cs.

How to Use

1. Server (Desktop App)

1. Navigate to the project directory in your terminal.
2. Run npm install to install Electron and its dependencies.
3. Run npm start to launch the server application.
4. Click "Start Server" (default port is 8080).

2. Client (.NET MAUI App)

1. Add RemoteLoggingClientService.cs to your .NET MAUI project.

2. In MauiProgram.cs, register the service using the new extension method. This is the only setup required.

   using MauiRemoteLogging; // Add the namespace for your service
   
   public static class MauiProgram
   {
       public static MauiApp CreateMauiApp()
       {
           var builder = MauiApp.CreateBuilder();
           builder
               .UseMauiApp<App>()
               .ConfigureFonts(fonts =>
               {
                   // ...
               });
   
           // Add this line to register the logging service
           // Use your server's local IP and the port from the Electron app
           builder.ConfigureRemoteLogging("YOUR_SERVER_IP_HERE", 8080);
   
           // ... register other services
   
           return builder.Build();
       }
   }
   

3. Inject IRemoteLoggingClientService into any ViewModel or service and start logging.

   using MauiRemoteLogging; // Use the correct namespace
   
   public class MyViewModel
   {
       private readonly IRemoteLoggingClientService _logger;
   
       public MyViewModel(IRemoteLoggingClientService logger)
       {
           _logger = logger;
       }
   
       public void DoSomething()
       {
           // Use the new EnqueueLog method
           _logger.EnqueueLog(LogLevel.Info, "MyViewModel", "Button was clicked!", null, "DoSomething");
   
           try
           {
               // ... code that might fail
           }
           catch (Exception ex)
           {
               _logger.EnqueueLog(LogLevel.Error, "MyViewModel", "Something bad happened.", ex, "DoSomething");
           }
       }
   }
   

Tech Stack

• Server: Electron, Node.js (TCP Server), Tailwind CSS
• Client: .NET C#, TcpClient, System.Threading.Channels