Monitor su aplicación móvil .NET MAUI

Revisa los requisitos

Antes de instalar nuestro agente .NET MAUI, asegúrese de que su aplicación cumpla con estos requisitos de versión:

• .NET versión 7.0 o superior
• Para aplicaciones nativas de Android: Android 7 (API 24) o superior
• Para aplicaciones nativas de iOS:
  • iOS 16 o superior, utilizando la última versión de Xcode

Agregue el agente .NET MAUI a su proyecto

Primero, deberá agregar nuestro agente, un paquete NuGet, a su proyecto MAUI:

1. Abra su solución .NET MAUI, seleccione el proyecto al que desea agregar el agente y abra su menú contextual.
2. Haga clic en Add > Add NuGet packages y luego seleccione NewRelic.MAUI.Plugin.

Copie el token de su aplicación desde la UI

The application token is used for New Relic to authenticate your .NET MAUI app's data.

To view and copy your application token in the New Relic UI:

1. Vaya a one.newrelic.com, haga clic en Integrations & Agents y luego haga clic en Mobile.

2. Seleccione su aplicación .NET MAUI.

3. Vaya a Settings > Application y copie el Application token mostrado.

   Agregará este token de aplicación en el siguiente paso.

Agregue nuestro archivo de configuración del agente a su proyecto .NET MAUI

En su proyecto, abra MauiProgram.cs y agregue el siguiente código:

using NewRelic.MAUI.Plugin;

...
  public static MauiApp CreateMauiApp()
  {
    var builder = MauiApp.CreateBuilder();
    builder
      .UseMauiAppApp_()_
      .ConfigureFonts(fonts =>
      {
        fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
        fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
      });

    builder.ConfigureLifecycleEvents(AppLifecycle => {
      #if ANDROID
      AppLifecycle.AddAndroid(android => android
        .OnCreate((activity, savedInstanceState) => StartNewRelic()));
      #endif

      #if IOS
      AppLifecycle.AddiOS(iOS => iOS.WillFinishLaunching((_,__) => {
        StartNewRelic();
        return false;
      }));
      #endif
    });

    return builder.Build();
  }

  private static void StartNewRelic()
  {
    CrossNewRelic.Current.HandleUncaughtException();
    // Set optional agent configuration
    // Options are: crashReportingEnabled, loggingEnabled, logLevel, collectorAddress, 
    // crashCollectorAddress, analyticsEventEnabled, networkErrorRequestEnabled, 
    // networkRequestEnabled, interactionTracingEnabled, webViewInstrumentation, 
    // fedRampEnabled, offlineStorageEnabled, newEventSystemEnabled, backgroundReportingEnabled
    // AgentStartConfiguration agentConfig = new AgentStartConfiguration(crashReportingEnabled:false);

    if (DeviceInfo.Current.Platform == DevicePlatform.Android)
    {
      CrossNewRelic.Current.Start("APP_TOKEN_HERE");
      // Start with optional agent configuration
      // CrossNewRelic.Current.Start("APP_TOKEN_HERE", agentConfig);
    } 
    else if (DeviceInfo.Current.Platform == DevicePlatform.iOS)
    {
      CrossNewRelic.Current.Start("APP_TOKEN_HERE");
      // Start with optional agent configuration
      // CrossNewRelic.Current.Start("APP_TOKEN_HERE", agentConfig);
    }
  }

Asegúrese de pegar token de su aplicación en appToken = "<APP-TOKEN-HERE>" en el código anterior. Si implementa su aplicación híbrida en la plataforma iOS y Android, deberá agregar dos tokens separados: uno para iOS y otro para Android.

Evento de seguimiento de pantalla

The .NET MAUI mobile plugin allows you to track navigation events within the .NET MAUI Shell. There are two ways to initialize this depending on your app's startup timing in App.xaml.cs.

Option 1: In the App Constructor You can call the tracking method directly in the constructor immediately after setting the MainPage.

public App()
{
  InitializeComponent();
  MainPage = new AppShell();
  CrossNewRelic.Current.TrackShellNavigatedEvents();
}

Option 2: In the OnStart Method (Recommended for timing/NullReferenceException issues) If your application shell is not fully initialized during the constructor execution, calling the navigation tracker may result in a System.NullReferenceException. To avoid this, move the call into the MAUI OnStart() lifecycle method:

public App()
{
  InitializeComponent();
  MainPage = new AppShell();
}

protected override void OnStart()
{
  base.OnStart();
  CrossNewRelic.Current.TrackShellNavigatedEvents();
}

Se recomienda llamar a este método al iniciar el agente. Estos eventos sólo se registrarán una vez completada la navegación. Puede encontrar estos datos a través del explorador de datos en MobileBreadcrumb (bajo el nombre ShellNavigated) o mediante una consulta NRQL:

SELECT * FROM MobileBreadcrumb WHERE name = 'ShellNavigated' SINCE 24 HOURS AGO

La ruta de navegación contendrá tres atributos:

• Current: El URI de la página actual.
• Source: El tipo de navegación que ocurrió.
• Previous: El URI de la página anterior. Esto no existirá si la página anterior era nula.