Monitor tu aplicación móvil Flutter

Revisa los requisitos

Antes de instalar el agente Flutter, asegúrese de que su aplicación Flutter cumpla con estos requisitos de versión:

• Flutter 2.5.0 o superior

• Versiones de Dart 2.16.2 o superiores, hasta la 3.0.0 (pero sin incluirla)

• Para aplicaciones nativas de Android:

  • API de Android 24 o superior
  • Ver los requisitos nativos de Android

• Para aplicaciones nativas de iOS:

  • Ver requisitos nativos de iOS

Agrega el agente Flutter a tu proyecto

Primero, deberás agregar el agente Flutter a tu proyecto de dardos. En su pubspec.yaml, agregue lo siguiente a dependencies:

dependencies:
  newrelic_mobile: 0.0.1

Copie el token de su aplicación

El token de la aplicación se utiliza para que New Relic autentique los datos de su aplicación Flutter. Para ver y copiar el token de su aplicación en la UI de New Relic:

1. Vaya a one.newrelic.com, haga clic en Integrations & Agents y luego haga clic en Mobile.

2. Selecciona tu aplicación Flutter.

3. Vaya a Settings > Application y copie el Application token mostrado.

   Agregará este token de aplicación en el siguiente paso.

Configura tu proyecto Flutter

En tu proyecto Flutter, abre main.dart y agrega el siguiente código:

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 {
  ...
}

Asegúrese de pegar token de su aplicación en appToken = "" en el código anterior. Si implementa su aplicación híbrida en la plataforma iOS y Android, deberá agregar dos tokens separados: uno para iOS y otro para Android.

(Solo para Android) Configura tu aplicación de Android

Si tienes una aplicación nativa de Android, deberás realizar los siguientes cambios:

1. Agregue los siguientes cambios para aplicar el complemento Gradle:

   Si su proyecto emplea el complemento DSL (Flutter 3.16 o superior), realice los siguientes cambios:

2. En 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
   }

   Copia

3. En 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
   }

   Copia

• O, si su proyecto es más antiguo, puede usar el ID del complemento legacy newrelic agregando este fragmento:

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

  Copia

  Aplique el complemento NewRelic en la parte superior del archivo android/app/build.gradle :

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

  Copia