R8 でアプリの最適化を有効にする

android skills add --skill r8-analyzer

ユーザー エクスペリエンスを向上させるには、アプリをできるだけ小さく、高速になるように最適化する必要があります。R8 というアプリ オプティマイザは、未使用のコードやリソースを削除し、コードを書き換えてランタイム パフォーマンスを最適化することで、アプリを効率化します。ユーザーにとって、これは次のようなメリットがあります。

• 起動時間を短縮
• メモリ使用量の削減
• レンダリングとランタイム パフォーマンスの向上
• ANR の減少

R8 の最適化の概要

R8 は、複数フェーズのプロセスを使用して、アプリのサイズと速度を最適化します。主なオペレーションは次のとおりです。

• コード圧縮（ツリー シェイキングとも呼ばれます）: R8 は、アプリとそのライブラリの依存関係から 到達不能なコードを特定して削除します。R8 は、アプリのエントリ ポイント（マニフェストで定義された Activities や Services など）を分析して、参照されるコードのグラフを作成し、参照されないものをすべて削除します。

• 論理的な最適化: R8 は、実行 効率を向上させ、オーバーヘッドを削減するためにコードを書き換えます。主な手法は次のとおりです。

  • メソッドのインライン化: R8 は、メソッド呼び出しサイトを呼び出されたメソッドの実際の本文 に置き換えます。これにより、関数呼び出しのオーバーヘッドが解消され、R8 でさらに最適化を行うことができます。

  • クラスのマージ: R8 は、クラスとインターフェースのセットを 1 つのクラスに結合します。これにより、アプリ内のクラスの数が減り、メモリ負荷が軽減され、起動速度が向上します。

• 難読化（縮小とも呼ばれます）: DEX ファイルのサイズを小さくするために、R8 はクラス、フィールド、メソッドの名前を短くします（たとえば、 com.example.MyActivity が a.b.a になることがあります）。

Android Gradle プラグイン（AGP）バージョン 8.12.0 以降では、R8 は最適化フェーズの一環としてリソースも最適化します。詳細については、不要なリソースの削除の最適化 をご覧ください。

最適化を有効にする

アプリの最適化を有効にするには、プロジェクトの AGP バージョンに基づいて適切な DSL を使用します。アプリの最適化は、公開前にテストするアプリの最終バージョン（通常はリリースビルド）でのみ有効にすることをおすすめします。最適化によりプロジェクトのビルド時間が長くなり、コードの変更方法によってはデバッグが難しくなる可能性があるためです。

AGP バージョン 9.3 以降の場合

AGP 9.3 以降でアプリの最適化を有効にするには:

• リリースビルドのアプリレベルのビルドスクリプトの optimization ブロックで enable = true を設定します。
• keep ルールを、 src/<variant>/keepRules ソースセットのサフィックス .keep のファイルに追加します。例: src/main/keepRules/custom-rules.keep

android {
    buildTypes {
        release {
            optimization {
                enable = true // Enables code and resource optimizations.
            }
        }
    }
}

android {
    buildTypes {
        release {
            optimization {
                enable = true // Enables code and resource optimizations.
            }
        }
    }
}

AGP バージョン 9.3 より前のレガシー DSL

アプリの最適化を有効にするには、リリースビルドのアプリレベルのビルドスクリプトで isMinifyEnabled = true（コードの最適化の場合） と isShrinkResources = true（リソースの最適化の場合）を設定します。両方の設定を常に有効にすることをおすすめします。

android {
    buildTypes {
        release {

            // Enables code optimizations.
            isMinifyEnabled = true

            // Enables resource shrinking.
            isShrinkResources = true

            proguardFiles(
                // Default file with automatically generated optimization rules.
                getDefaultProguardFile("proguard-android-optimize.txt"),

                ...
            )
            ...
        }
    }
    ...
}

android {
    buildTypes {
        release {

            // Enables code optimizations.
            minifyEnabled = true

            // Enables resource shrinking.
            shrinkResources = true

            // Default file with automatically generated optimization rules.
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt')

            ...
        }
    }
}

R8 の最適化を改善する

R8 のパフォーマンス上のメリットは、R8 が最適化できるコードベースの量に直接関係します。R8 を最大限に活用するには、次のベスト プラクティスに従ってください。

• R8 をフルモードで有効にする
• 難読化、最適化、圧縮を有効にする
• 不要なリソースの削除と不要なリソースの削除の最適化を有効にする
• keep ルールを調整して、クラス、フィールド、 メソッドの最適化を最大限に行えるようにする。

keep ルールを調整するには、R8 構成アナライザを使用します。

R8 構成アナライザを使用すると、次のことができます。

• R8 構成アナライザ レポートで提供される指標をモニタリングして、R8 構成の全体的な品質を追跡し、改善します。
• 最も広範な keep ルール（最適化を最も妨げるルール）を見つける
• それらのルールがどのような最適化を妨げているかを把握して、調整する。

R8 構成アナライザは、AGP バージョン 9.3.0-alpha05 以降、または R8 バージョン 9.3.7-dev 以降で利用できます。詳細については、R8 構成を分析するをご覧ください。

不要なリソースの削除を最適化してアプリをさらに小さくする

AGP バージョン 8.12.0 では、不要なリソースの削除の最適化が導入されました。これは、リソースとコードの最適化を統合して、アプリをさらに小さく、高速にすることを目的としています。 不要なリソースの削除の最適化を行う前は、Android Asset Packaging Tool（AAPT2）が keep ルールを生成し、リソースの削除をコードとは別に行っていたため、相互に参照するアクセス不能なコードやリソースが保持されることがよくありました。

不要なリソースの削除の最適化では、リソースはプログラム コードの一部と見なされ、参照グラフを形成します。コードまたはリソースのコレクションが参照されていない場合、keep ルールで保護されないため、削除できます。

不要なリソースの削除の最適化を有効にする

AGP 8.12 または 8.13 の新しい不要なリソースの削除の最適化パイプラインを有効にするには、プロジェクトの gradle.properties ファイルに以下を追加します。

AGP 9.0.0 以降のバージョンを使用している場合は、android.r8.optimizedResourceShrinking=true を設定する必要はありません。ビルド構成で isShrinkResources = true が有効になっている場合、不要なリソースの削除の最適化が自動的に適用されます。

R8 の最適化設定を確認して構成する

R8 が 最適化機能を最大限に活用できるようにするには、プロジェクトの gradle.properties ファイルに 次の行が存在する場合は削除します。

bash android.enableR8.fullMode=false # Remove this line from your codebase.

アプリの最適化を有効にすると、特に R8 がクラス名またはメソッド名を変更した場合に、スタック トレースがわかりにくくなります。ソースコードに正しく対応するスタック トレースを取得するには、元のスタック トレースを復元するをご覧ください。

R8 が有効になっている場合は、起動パフォーマンスをさらに向上させるために、起動プロファイルも 作成する必要があります。

アプリの最適化を有効にするとエラーが発生する場合は、次の方法で修正できます。

• keep ルールを追加して、一部のコードを変更しないようにする。
• 最適化を段階的に導入する。
• 最適化に適したライブラリを使用するようにコードを 更新する。

ビルド速度の最適化に関心がある場合は、R8 の実行方法を構成するで、環境に基づいて R8 を構成する方法をご覧ください。

AGP と R8 のバージョンによる動作の変更

次の表に、Android Gradle プラグイン（AGP）と R8 コンパイラのさまざまなバージョンで導入された主な機能を示します。