Installer le plugin New Relic pour les applications instantanées Android

Les applications instantanéesAndroid permettent à l'utilisateur d'utiliser rapidement vos applications sans installation. Avec la Android version 5.17.0 de l'agent et supérieure, vous pouvez utiliser New Relic pour détecter et instrumenter tous les modules de fonctionnalités pour une application instantanée.

Utilisez cette documentation avec les procédures New Relic standard pour installer des applications Android avec Gradle et Android Studio. Après avoir suivi les procédures d'installation standard, suivez ces étapes supplémentaires pour les applications instantanées Android.

Terminologie

Cette procédure utilise les termes suivants qui sont spécifiques au plug-in Android Instant Apps :

• Module:Toute classe de package et/ou collection de ressources
• APK:Un module qui regroupe les ressources des applications et les classes DEX
• Feature module:Un module allégé qui ne contient qu'un sous-ensemble de l'APK total

Installer le plugin

Pour installer le plugin New Relic pour les applications instantanées Android :

1. Suivez d’abord les étapes de la documentation Installer des applications Android avec Gradle et Android Studio .

2. Appliquez le plugin d'agent dans chaque fichier de build Gradle du projet.

3. Répertoriez l’agent Android comme une dépendance.

4. Démarrez l'agent à partir de chaque classe d'activité dans la fonctionnalité qui pourrait être chargée latéralement via une intention de lien d'actif numérique (par exemple, mobile.example.com/signin).

   Exemple de build.gradle minimal

   apply plugin: 'com.android.[application|library|feature|instantapp]'
   apply plugin: 'newrelic'
   
   dependencies {
       implementation "com.newrelic.agent.android:android-agent:${project.agentVersion}"
   }

   Copier

5. Passez en revue les considérations relatives à l’instrumentation.

Instrumentation

Lorsque vous créez une application instantanée, tenez compte des considérations suivantes concernant les APK :

Prise en charge de ProGuard et Dexguard

Le plugin Android Studio Gradle masquera toute configuration de build où minifyEnabled est défini sur true. Dans ces conditions, l'agent New Relic transmettra la carte ProGuard générée pour le build au crash collecteur, étiquetée avec un ID de build unique généré par l'agent.

L'obfuscation est mieux configurée dans l'application ou le projet d'application instantanée qui inclut d'autres modules en tant que dépendance. Les modules peuvent configurer ProGuard selon les besoins.

Dépannage de l'auto-instrumentation

Si vous ne savez pas si l'agent est auto-instrumenté dans un projet d'application instantanée, essayez d'exécuter ces étapes :

1. Créez l'application avec l'option debug (-d, --debug) et capturez le log de génération.

2. Recherchez dans le log des preuves d'applications instantanées en recherchant l'un de ces termes :

   • This appears to be an Instant App

     Copier

   • BuildId[1a2b34c5-def6-7890-g123-h4567890a]

     Copier

3. L'agent ajoutera un attribut nommé 'instantApp' à l'attribut de session de l'application si l'application semble être une application instantanée.