Monitorez votre application mobile .NET MAUI

Examiner les exigences

Avant d'installer notre agent .NET MAUI, assurez-vous que votre application répond à ces exigences de version :

• .NET version 7.0 ou supérieure

• Pour les applications natives Android : Android 7 (API 24) ou version ultérieure

• Pour les applications natives iOS :

  • iOS 11 ou supérieur
  • Dernière sortie de Xcode

Ajoutez l'agent .NET MAUI à votre projet

Tout d’abord, vous devrez ajouter notre agent, un package NuGet, à votre projet MAUI :

1. Ouvrez votre solution .NET MAUI, sélectionnez le projet auquel vous souhaitez ajouter l’agent et ouvrez son menu contextuel.
2. Cliquez sur Add > Add NuGet packages, puis sélectionnez NewRelic.MAUI.Plugin.

Copiez votre jeton d'application depuis l'interface utilisateur

Le jeton d'application est utilisé par New Relic pour authentifier les données de votre application .NET MAUI. Pour afficher et copier votre jeton d'application dans l'interface utilisateur de New Relic :

1. Allez à one.newrelic.com, cliquez sur Integrations & Agents, puis cliquez sur Mobile.

2. Sélectionnez votre application .NET MAUI.

3. Allez dans Settings > Application et copiez le Application token affiché.

   Vous ajouterez ce jeton d’application à l’étape suivante.

Ajoutez notre fichier de configuration d'agent à votre projet .NET MAUI

Dans votre projet, ouvrez MauiProgram.cs et ajoutez le code suivant :

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

Assurez-vous de coller vos jetons d'application dans appToken = "<APP-TOKEN-HERE>" dans le code ci-dessus. Si vous lancez votre application hybride sur les plateformes iOS et Android , vous devrez ajouter deux jetons distincts : un pour iOS et un pour Android.

Événement de suivi d'écran

Le plugin mobile .NET MAUI vous permet de suivre les événements de navigation dans le shell .NET MAUI. Pour cela, il vous suffit d'appeler la commande suivante dans App.xaml.cs:

public App()
{
  InitializeComponent();

  MainPage = new AppShell();
  CrossNewRelic.Current.TrackShellNavigatedEvents();
}

Il est recommandé d'appeler cette méthode lors du démarrage de l'agent. Ces événements ne seront enregistrés qu'une fois la navigation terminée. Vous pouvez trouver ces données via l'explorateur de données dans MobileBreadcrumb (sous le nom ShellNavigated) ou par une requête NRQL :

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

Le fil d'Ariane contiendra trois attributs :

• Current: L'URI de la page actuelle.
• Source:Le type de navigation qui a eu lieu.
• Previous: L'URI de la page précédente. Cela n'existera pas si la page précédente était nulle.

(Android uniquement) Ajouter des autorisations

Si vous avez une application native Android, vous devrez ajouter les autorisations INTERNET et ACCESS_NETWORK_STATE dans votre fichier Platforms/Android/AndroidManifest.xml :

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