Fire OSでFire TV対応アプリのKPIを測定する方法

パフォーマンステストとは、互換性、信頼性、速度、応答時間、安定性、リソース使用量といった領域を対象に、Fire OSを実行しているAmazon Fire TVデバイスでアプリをテストするプロセスです。このテストは、アプリのパフォーマンスのボトルネックを特定して対処するために使用できます。パフォーマンステストには、主要業績評価指標（KPI）の収集と評価が含まれます。KPI指標を収集するには、Amazonデバイスで特定の手順を実行した後、ログなどのデバイスリソースを使用して指標を検索または計算します。

アプリをAmazonアプリストアに申請する前に、必ずパフォーマンステストを実行してください。これらのKPIを定期的にトラッキングすると、アプリがスムーズで応答性の高いエクスペリエンスを提供していることを確認できます。

レイテンシとメモリについて

• 「レイテンシ」では、アプリが起動して使用可能になるまでの時間を測定します。ユーザーは、アプリがほぼ瞬時に起動し、コンテンツを操作できるようになるまでの遅延が最小限であることを期待しています。
• 「メモリ」では、アプリがデバイスRAMをどのくらい効率的に使用しているかを測定します。メモリを過度に消費すると、システムによる強制終了やマルチタスクパフォーマンスの低下が発生し、ユーザーエクスペリエンスが低下します。

前提条件

Fire OSでアプリのKPIを測定する前に、以下の準備を完了してください。

1. 開発用コンピューターに次のソフトウェアパッケージをインストールします。
   • Amazon Corretto（英語のみ）
   • Android Studio（セットアップ中にプラットフォームツールをインストールしてください）
   • Appium
2. 次の設定を完了します。
   • JAVA_HOMEフォルダとANDROID_HOMEフォルダのパスを設定します。
   • デバイスで開発者モードを有効にし、USBデバッグを有効にします。手順については、Amazon Fire TVでデバッグを有効にするを参照してください。
   • 次のコマンドを使用して、接続されているデバイスのシリアル番号を取得します。

       adb devices -l
     

3. 次のセクションに目を通します。
   • アプリのKPI指標とガイドライン
   • 起動シナリオ
   • 描画完了マーカー

アプリのKPI指標とガイドライン

次の表は、Fire OS上のFire TV対応アプリについて測定する必要のあるKPI指標の一覧と、それぞれの推奨ガイドラインを示しています。これらの指標は、起動パフォーマンスとメモリ効率を測定するものです。

起動シナリオ

パフォーマンステストでは、次の2種類のアプリ起動シナリオを測定してTTFFとTTFDを評価します。

• コールドスタート - ユーザーがアプリプロセスを強制停止した後またはデバイスを再起動した後にアプリを起動する場合。システムは、すべてのリソースと依存関係をメモリに読み込む必要があります。
• ウォームスタート - 一部のリソースと依存関係が既にメモリ内にある状態で、ユーザーがアプリをバックグラウンド（非アクティブ状態）からフォアグラウンド（アクティブ状態）に移行する場合。

描画完了マーカー

描画完了マーカーは、アプリがユーザー操作を受け付けられる状態になったことを知らせます。マーカーは以下の役割を果たします。

• アプリの必須コンポーネントの読み込みが完了したことを示す。
• ユーザーがアプリの操作を開始できるタイミングを示す。
• TTFDパフォーマンスの測定を支援する。

実装するには、重要なポイントとなる以下の場所で、アクティビティからreportFullyDrawn()を呼び出します。

• コールドスタート - 初期データを読み込んでメイン画面（サインインページまたはホームページ）をレンダリングした後。
• ウォームスタート - アプリがフォアグラウンドに移行した後で応答可能になったとき。

次のサンプルコードは、描画完了マーカーを追加する方法を示しています。

• Java
• Kotlin

public class MainActivity extends Activity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        getWindow().getDecorView().post(() -> {
            reportFullyDrawn();
        });
    }
}

class MainActivity : Activity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        window.decorView.post { reportFullyDrawn() }
    }
}

ADBとAtraceによるKPIの測定

Android Debug Bridge（ADB）とAtraceを使用して、Fire OSを実行しているFire TVデバイスで各KPIを測定します。

テスト戦略

テストでは、アプリランチャーインテントまたはMonkeyツールを使用して、アプリの起動と強制停止を数回繰り返します。各イテレーションで、Atraceログのキャプチャ、ナビゲーションアクションの実行、タイマー値のキャプチャ、メモリ使用量のキャプチャを強制停止前に行います。

Amazonでは、少なくとも以下の回数のイテレーションを実行することを推奨しています。

テストするデバイス

複数のFire OSバージョンをテスト対象とするために、以下のリファレンスデバイスでテストを実行します。

コールドスタートKPI

コールドスタートKPIでは、アプリプロセスを強制停止した後またはデバイスを再起動した後に、アプリの起動時のパフォーマンスを測定します。

TTFF - コールドスタート

1. アプリを強制停止します。

    adb -s <DSN> shell am force-stop <パッケージ名>
   

2. Atraceを起動します。

    adb shell atrace -o /sdcard/atrace.capture -t 15 -b 32000 -a <パッケージ名> gfx input am view wm
   

3. アプリを起動します。

    adb -s <DSN> shell monkey --pct-syskeys 0 -p <パッケージ名> -c android.intent.category.LEANBACK_LAUNCHER 1
   

4. 30秒間待ちます。
5. Atraceログを取得します。

    adb -s <DSN> pull /sdcard/atrace.capture ./atrace_cold_<イテレーション>.txt
   

6. 時間差を計算します。
   • 開始マーカー： AMS.startActivityAsUser
   • 終了マーカー：eglSwapBuffersWithDamageKHR
7. アプリを強制停止します。
8. 手順1～7を50回繰り返します。

TTFD - コールドスタート

TTFF - コールドスタートと同じ手順に従いますが、次のマーカーを使用します。

• 開始マーカー： AMS.startActivityAsUser
• 終了マーカー： Activity.reportFullyDrawn（アプリのPIDに一致するもの）

10回繰り返します。

ウォームスタートKPI

ウォームスタートKPIでは、一部のリソースが既にメモリ内にある状態で、アプリをバックグラウンドからフォアグラウンドに移行するときのアプリのパフォーマンスを測定します。

TTFF - ウォームスタート

1. アプリを起動し、[ホーム] を押してバックグラウンドに送ります。
2. Atraceを起動します。
3. Monkeyツールを使用してアプリを起動します（アプリをフォアグラウンドに移動します）。
4. 30秒間待ちます。
5. Atraceログを取得します。
6. 時間差を計算します。
   • 開始マーカー： AMS.startActivityAsUser
   • 終了マーカー：eglSwapBuffersWithDamageKHR
7. [ホーム] ボタンを押して、アプリをバックグラウンドに送ります。
8. 手順2～7を50回繰り返します。

TTFD - ウォームスタート

TTFF - ウォームスタートと同じ手順に従いますが、終了マーカーとしてActivity.reportFullyDrawnを使用します。

10回繰り返します。

フォアグラウンドメモリKPI

フォアグラウンドメモリKPIでは、アプリがアクティブに実行され、コンテンツを再生している間のアプリのメモリ消費量をキャプチャします。

1. アプリをダウンロードしてインストールし、必要に応じてアプリにサインインします。
2. アプリを強制停止します。
3. Monkeyツールを使用してアプリを起動します。
4. ビデオコンテンツを10分間再生します。
5. 120秒間待ちます。
6. フォアグラウンドメモリをキャプチャします。

    adb -s <DSN> shell dumpsys meminfo <パッケージ名>
   

7. アプリを強制停止します。
8. 手順2～7を5回繰り返します。

dumpsys meminfoから出力される [PSS Total] が主要な指標です。

バックグラウンドメモリKPI

バックグラウンドメモリKPIでは、バックグラウンドに移行した後のアプリのメモリ消費量をキャプチャします。RAMが不足すると、バックグラウンドメモリ使用量の多いアプリほど、システムによって強制終了される可能性が高くなります。

1. アプリをダウンロードしてインストールし、必要に応じてアプリにサインインします。
2. アプリを起動し、ビデオコンテンツを10分間再生します。
3. [ホーム] ボタンを押して、アプリをバックグラウンドに送ります。
4. 60秒間待ちます。
5. バックグラウンドメモリをキャプチャします。

    adb -s <DSN> shell cat /proc/<PID>/statm
   

6. 手順2～5を5回繰り返します。

ガイドラインの要約

次の表は、各KPIで推奨されるガイドラインと測定のイテレーション回数をまとめたものです。

KPIの健全性の評価

アプリのKPIの結果が推奨ガイドラインに適合するかどうかを評価するには、次のインジケーターを使用します。

ツール

次のツールは、Fire TVデバイスでアプリのKPIの測定とモニタリングを行うために役立ちます。

• Android Debug Bridge（ADB）- Fire TVデバイスとやり取りするためのコマンドラインツール。
• Atrace/Systrace - パフォーマンスマーカーをキャプチャするためのシステムトレースユーティリティ。
• Monkeyツール - 自動テストのためのアプリランチャー。
• Appium - テスト自動化フレームワーク。
• Maestro - メモリ／再生シナリオに使用できるスクリプトベースのUI自動化ツール。
• Android Studio Profiler - CPU、メモリ、ネットワークのリアルタイムのプロファイリング。
• アプリ健全性インサイトダッシュボード - 公開中のアプリの指標を追跡するための開発者コンソールのダッシュボード。

関連トピック

• Fire TV向けのアプリのパフォーマンススクリプト
• adbコマンドの詳細については、AndroidデベロッパードキュメントのAndroid Debug Bridge（adb）を参照してください。
• Fire TVデバイスでのその他のテストについては、テスト基準グループ2a： Fire TVデバイスでのアプリの動作を参照してください。

Last updated: 2026年7月23日