Monitor seu aplicativo móvel .NET MAUI

Revise os requisitos

Antes de instalar nosso agente .NET MAUI, certifique-se de que seu aplicativo atenda a estes requisitos de versão:

• .NET versão 7.0 ou superior
• Para aplicativos nativos do Android: Android 7 (API 24) ou superior
• Para aplicativos nativos do iOS:
  • iOS 16 ou superior, usando a versão mais recente do Xcode

Adicione o agente .NET MAUI ao seu projeto

Primeiro, você precisará adicionar nosso agente, um pacote NuGet, ao seu projeto MAUI:

1. Abra sua solução .NET MAUI, selecione o projeto ao qual deseja adicionar o agente e abra seu menu de contexto.
2. Clique em Add > Add NuGet packages e selecione NewRelic.MAUI.Plugin.

Copie o token do seu aplicativo da interface

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. Vá para one.newrelic.com, clique em Integrations & Agents e depois clique em Mobile.

2. Selecione seu aplicativo .NET MAUI.

3. Vá para Settings > Application e copie o Application token exibido.

   Você adicionará esse token de aplicativo na próxima etapa.

Adicione nosso arquivo de configuração do agente ao seu projeto .NET MAUI

No seu projeto, abra MauiProgram.cs e adicione o seguinte 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);
    }
  }

Certifique-se de colar o(s) token(s) do seu aplicativo em appToken = "<APP-TOKEN-HERE>" no código acima. Se você implantar seu aplicativo híbrido nas plataformas iOS e Android, precisará adicionar dois tokens separados: um para iOS e outro para Android.

Evento de rastreamento de tela

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();
}

Recomenda-se chamar esse método ao iniciar o agente. Estes eventos só serão registrados após a conclusão da navegação. Você pode encontrar esses dados por meio do explorador de dados em MobileBreadcrumb (sob o nome ShellNavigated) ou por meio de uma consulta NRQL:

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

As trilhas conterão três atributos:

• Current: O URI da página atual.
• Source: O tipo de navegação que ocorreu.
• Previous: O URI da página anterior. Isso não existirá se a página anterior for nula.