Monitorez votre application mobile Xamarin

Examiner les exigences

Avant d’installer notre agent Xamarin, assurez-vous que votre application répond à ces exigences de version :

• Xamarin.Android 8.0 ou supérieur
• Xamarin.iOS 10.14 ou supérieur
• Pour les applications natives Android, utilisez l'API Android 24 ou supérieure
• Pour les applications natives iOS, utilisez iOS 10

Ajoutez l'agent Xamarin à votre projet

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

1. Ouvrez votre solution Xamarin, sélectionnez le projet Xamarin.Forms auquel vous souhaitez ajouter l’agent et ouvrez son menu contextuel.
2. Cliquez sur Add > Add NuGet packages, puis sélectionnez NewRelic.Xamarin.Plugin. Vous devrez également ajouter notre liaison d’agent iOS à votre projet Xamarin.iOS :
3. Sélectionnez le projet Xamarin.iOS auquel vous souhaitez ajouter l’agent et ouvrez son menu contextuel.
4. Add > Add NuGet packages, puis sélectionnez NewRelic.Xamarin.iOS.Binding.

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 Xamarin. 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 Xamarin.

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 à App.xaml.cs

Dans le fichier App.xaml.cs de votre projet, ajoutez le code suivant :

using NewRelic.Xamarin.Plugin;
...
    public App ()
    {
      InitializeComponent();
      MainPage = new MainPage();
      Application.Current.PageAppearing += OnPageAppearing;
      Application.Current.PageDisappearing += PageDisappearing;
      CrossNewRelicClient.Current.HandleUncaughtException();
      CrossNewRelicClient.Current.TrackShellNavigatedEvents();

      // 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 (Device.RuntimePlatform == Device.Android)
      {
        CrossNewRelicClient.Current.Start("YOUR_APP_TOKEN");
        // Start with optional agent configuration
        // CrossNewRelicClient.Current.Start("YOUR_APP_TOKEN", agentConfig);
      }
      else if (Device.RuntimePlatform == Device.iOS)
      {
        CrossNewRelicClient.Current.Start("YOUR_APP_TOKEN");
        // Start with optional agent configuration
        // CrossNewRelicClient.Current.Start("YOUR_APP_TOKEN", agentConfig);
      }
    }

Assurez-vous de coller vos jetons d'application dans appToken = "" 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.

(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" />