Android インスタントアプリ は、ユーザーがインストールすることなく、素早くアプリケーションを使用することができます。Android エージェント バージョン 5.17.0 以上であれば、New Relic を使ってインスタントアプリのすべての機能モジュールを検出し、インスツルメントすることができます。
Gradle と Android Studio を使って Android アプリを インストールするには、New Relic の標準的な手順と合わせてこのドキュメントを使用してください 。標準的なインストール手順に従った後、Android インスタントアプリの場合は、以下の追加手順に従ってください。
用語解説
本手順では、Android Instant Appsプラグインに特有の以下の用語を使用しています。
- モジュール: あらゆるパッケージ化されたクラスおよび/またはリソースコレクション
- APK: アプリのリソースとDEXされたクラスをパッケージ化したモジュール
- 機能モジュール: APK全体のサブセットのみを含むスリム化されたモジュール
プラグインのインストール
Android Instant Apps用のNew Relicプラグインをインストールする。
まず、 Install Android apps with Gradle and Android Studio のドキュメントの手順に従ってください。
すべてのプロジェクトのGradleビルドファイルにエージェントプラグインを適用します。
Androidエージェントを依存関係にあるものとしてリストアップします。
デジタルアセットリンクのインテントを介してサイドロードされる可能性のある機能の各 アクティビティクラス からエージェントを開始します。(例: mobile.example.com/signin )。
計装
インスタントアプリをインストルメント化する場合、APKでは以下の点に注意してください。
インスタントアプリとAPK | コメント |
---|---|
計装 |
|
ProGuardおよびDexguardは、機能およびアプリケーションのAPKをサポートしています。 |
|
プロガード、デックスガード対応
Android Studio Gradle プラグインは、 minifyEnabled
が true
に設定されているビルド構成を難読化します。このような状況では、New Relic エージェントは、ビルド用に生成された ProGuard マップを、エージェントが生成した固有のビルド ID をタグ付けして、クラッシュコレクターに転送します。
難読化の設定は、他のモジュールを依存関係に含むアプリケーションまたはインスタントアプリのプロジェクトで行うのが最適です。モジュールは必要に応じてProGuardを構成することができます。
重要
AndroidアプリでProGuardまたはDexGuardを使用する場合は、手順に従って追加の必要な構成手順を完了してください。詳細については、 ProGuardおよびDexGuardの構成 のドキュメントを参照してください。
オートインストルメントのトラブルシューティング
エージェントがインスタントアプリのプロジェクトを自動計測しているかどうかわからない場合は、以下の手順を実行してみてください。
debug
(-d
,--debug
) オプションでアプリをビルドし、ビルドログを取得します。次のいずれかの用語を検索して、インスタントアプリの証拠をログに残します。
- This appears to be an Instant App
BuildId[1a2b34c5-def6-7890-g123-h4567890a]
エージェントは、アプリがインスタントアプリであると思われる場合、アプリのInsightsセッション属性に
'instantApp'
という属性を追加します。