Monitor your .NET MAUI mobile app

Review the requirements

Before you install our .NET MAUI agent, make sure your app meets these version requirements:

• .NET version 7.0 or higher
• For Android-native apps: Android 7 (API 24) or higher
• For iOS-native apps:
  • iOS 11 or higher
  • Latest release of Xcode

Add the .NET MAUI agent to your project

First, you'll need to add our agent, a NuGet package, to your MAUI project:

1. Open your .NET MAUI solution, select the project you want to add the agent to, and open its context menu.
2. Click Add > Add NuGet packages, then select NewRelic.MAUI.Plugin.

Copy your application token from the 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. Go to one.newrelic.com, click Add data, then click Mobile.
2. Select your .NET MAUI app.
3. Go to Settings > Application and copy the displayed Application token.

You'll add this application token in the next step.

Add our agent configuration file to your .NET MAUI project

In your project, open App.xaml.cs and add the following code:

using NewRelic.MAUI.Plugin;
...
    public App ()
    {
      InitializeComponent();
      MainPage = new AppShell();

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

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

Make sure you paste your application token(s) into appToken = "" in the code above. If you deployed your hybrid app to both iOS and Android platforms, you'll need to add two separate tokens: one for iOS and one for Android.

(Android only) Add permissions

If you have an Android-native app, you'll need to add INTERNET and ACCESS_NETWORK_STATE permissions in your Platforms/Android/AndroidManifest.xml file:

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