Android Instant Apps用New Relicプラグインのインストール

Android インスタントアプリ は、ユーザーがインストールすることなく、素早くアプリケーションを使用することができます。Android エージェント バージョン 5.17.0 以上であれば、New Relic を使ってインスタントアプリのすべての機能モジュールを検出し、インスツルメントすることができます。

Gradle と Android Studio を使って Android アプリを インストールするには、New Relic の標準的な手順と合わせてこのドキュメントを使用してください 。標準的なインストール手順に従った後、Android インスタントアプリの場合は、以下の追加手順に従ってください。

用語解説

本手順では、Android Instant Appsプラグインに特有の以下の用語を使用しています。

• Module

  : パッケージ化されたクラスおよび/またはリソースコレクション

• APK

  : アプリのリソースとDEX化されたクラスをパッケージ化するモジュール

• Feature module

  : 全体のAPKのサブセットのみを含むスリム化されたモジュール

プラグインのインストール

Android Instant Apps用のNew Relicプラグインをインストールする。

1. まず、 Install Android apps with Gradle and Android Studio のドキュメントの手順に従ってください。

2. すべてのプロジェクトのGradleビルドファイルにエージェントプラグインを適用します。

3. Androidエージェントを依存関係にあるものとしてリストアップします。

4. Digital Asset Link インテント (mobile.example.com/signin など) を介してサイドロードできる機能の各アクティビティ クラスからエージェントを開始します。

   最小限の build.gradle の例

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

   コピー

5. インスツルメンテーションのための考慮事項を確認する.

計装

インスタントアプリをインストルメント化する場合、APKでは以下の点に注意してください。

プロガード、デックスガード対応

Android Studio Gradleプラグインは、 minifyEnabledがtrueに設定されているビルド構成を難読化します。このような状況では、New Relicエージェントは、ビルド用に生成されたProGuardマップを、エージェントによって生成された一意のビルドIDでタグ付けされたクラッシュコレクターに転送します。

難読化の設定は、他のモジュールを依存関係に含むアプリケーションまたはインスタントアプリのプロジェクトで行うのが最適です。モジュールは必要に応じてProGuardを構成することができます。

オートインストルメントのトラブルシューティング

エージェントがインスタントアプリのプロジェクトを自動計測しているかどうかわからない場合は、以下の手順を実行してみてください。

1. debug （ -d 、 --debug ）オプションを使用してアプリをビルドし、ビルドログをキャプチャします。

2. 次のいずれかの用語を検索して、インスタントアプリの証拠をログに残します。

   • This appears to be an Instant App

     コピー

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

     コピー

3. アプリがインスタントアプリのように見える場合、エージェントは'instantApp'という名前の属性をアプリのセッション属性に追加します。