Monitorez votre application mobile Flutter

Examiner les exigences

Avant d'installer l'agent Flutter, assurez-vous que votre application Flutter répond à ces exigences de version :

• Flutter 2.5.0 ou supérieur

• Versions Dart 2.16.2 ou supérieures, jusqu'à la version 3.0.0 non incluse

• Pour les applications natives Android :

  • API Android 24 ou supérieur
  • Voir les exigences natives d'Android

• Pour les applications natives iOS :

  • Voir les exigences natives iOS

Ajoutez l'agent Flutter à votre projet

Tout d’abord, vous devrez ajouter l’agent Flutter à votre projet Dart. Dans votre pubspec.yaml, ajoutez ce qui suit à dependencies:

dependencies:
  newrelic_mobile: 0.0.1

Copiez votre jeton d'application

Le jeton d'application est utilisé par New Relic pour authentifier les données de votre application Flutter. 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 Flutter.

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

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

Configurez votre projet Flutter

Dans votre projet Flutter, ouvrez main.dart et ajoutez le code suivant :

import 'package:newrelic_mobile/newrelic_mobile.dart';

var appToken = "";
if (Platform.isAndroid) {
  appToken = "ANDROID_APP_TOKEN"; // Replace with your application token copied from the New Relic UI.
} else if (Platform.isIOS) {
  appToken ="IOS_APP_TOKEN"; // Replace with your application token copied from the New Relic UI.
}

Config config = Config(
  accessToken: appToken,
  //Android Specific
  // Optional: Enable or disable collection of event data.
  analyticsEventEnabled: true,
  // Optional: Enable or disable reporting successful HTTP requests to the MobileRequest event type.
  networkErrorRequestEnabled: true,
  // Optional: Enable or disable reporting network and HTTP request errors to the MobileRequestError event type.
  networkRequestEnabled: true,
  // Optional: Enable or disable crash reporting.
  crashReportingEnabled: true,
  // Optional: Enable or disable interaction tracing. Trace instrumentation still occurs, but no traces are harvested. This will disable default and custom interactions.
  interactionTracingEnabled: true,
  // Optional: Enable or disable capture of HTTP response bodies for HTTP error traces and MobileRequestError events.
  httpResponseBodyCaptureEnabled: true,
  // Optional: Enable or disable agent logging.
  loggingEnabled: true,
  // iOS specific
  // Optional: Enable or disable automatic instrumentation of WebViews
  webViewInstrumentation: true,
  //Optional: Enable or disable Print Statements as Analytics Events
  printStatementAsEventsEnabled : true,
  // Optional: Enable or disable automatic instrumentation of HTTP Request
  httpInstrumentationEnabled:true,
  // Optional: Enable or disable reporting data using different endpoints for US government clients
  fedRampEnabled: false,
  // Optional: Enable or disable offline data storage when no internet connection is available.
  offlineStorageEnabled: true,
  // iOS Specific
  // Optional: Enable or disable background reporting functionality.
  backgroundReportingEnabled: false,
  // iOS Specific
  // Optional: Enable or disable to use our new, more stable, event system for iOS agent.
  newEventSystemEnabled: false,
  // Optional: Enable or disable distributed tracing.
  distributedTracingEnabled: true,
);

NewrelicMobile.instance.start(config, () {
  runApp(MyApp());
});

class MyApp extends StatelessWidget {
  ...
}

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) Configurez votre application Android

Si vous disposez d'une application native Android, vous devrez effectuer les modifications suivantes :

1. Ajoutez les modifications suivantes pour appliquer le plugin Gradle :

   Si votre projet utilise le plugin DSL (Flutter 3.16 ou supérieur), apportez les modifications suivantes :

2. Dans android/settings.gradle:

   plugins {
       id "dev.flutter.flutter-plugin-loader" version "1.0.0"
       id "com.android.application" version "7.4.2" apply false
       id "org.jetbrains.kotlin.android" version "1.7.10" apply false
       id "com.newrelic.agent.android" version "7.5.1" apply false // <-- include this
   }

   Copier

3. Dans android/app/build.gradle:

   plugins {
       id "com.android.application"
       id "kotlin-android"
       id "dev.flutter.flutter-gradle-plugin"
       id "com.newrelic.agent.android"  //<-- include this
   }

   Copier

• Ou, si votre projet est plus ancien, vous pouvez utiliser l'ID de plugin legacy newrelic en ajoutant ce snippet:

  buildscript {
    ...
    repositories {
      ...
      mavenCentral()
    }
    dependencies {
      ...
      classpath "com.newrelic.agent.android:agent-gradle-plugin:7.5.1"
    }
  }

  Copier

  Appliquez le plugin NewRelic en haut du fichier android/app/build.gradle :

  apply plugin: "com.android.application"
  apply plugin: 'newrelic' // <-- include this

  Copier

  2. Dans votre fichier AndroidManifest.xml , ajoutez les autorisations suivantes :

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

     Copier