ProfileInstaller

  
ART によって読み取られる事前コンパイル トレースをライブラリが事前取り込みできるようにします。
最新の更新 安定版リリース リリース候補版 ベータ版リリース アルファ版リリース
2024 年 2 月 7 日 1.3.1 - - 1.4.0-alpha01

依存関係の宣言

ProfileInstaller への依存関係を追加するには、Google の Maven リポジトリをプロジェクトに追加する必要があります。詳しくは、Google の Maven リポジトリをご覧ください。

アプリまたはモジュールの build.gradle ファイルに、必要なアーティファクトの依存関係を追加します。

Groovy

dependencies {
    implementation "androidx.profileinstaller:profileinstaller:1.3.1"
}

Kotlin

dependencies {
    implementation("androidx.profileinstaller:profileinstaller:1.3.1")
}

依存関係について詳しくは、ビルド依存関係の追加をご覧ください。

フィードバック

お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

詳細については、Issue Tracker のドキュメントをご覧ください。

バージョン 1.4

バージョン 1.4.0-alpha01

2024 年 2 月 7 日

androidx.profileinstaller:profileinstaller:1.4.0-alpha01 がリリースされました。バージョン 1.4.0-alpha01 に含まれる commit については、こちらをご覧ください

バグの修正

  • プロファイル検証ツールにプロファイルが埋め込まれていない場合のエラー コードを追加しました。(Ifb109b/313928520
  • Android U(API 34)とエミュレータでのシェーダーの削除時に発生するクラッシュを解消しました(I031cab/274314544)。
  • プロファイル インストーラでの Android U のサポートを有効にしました(Iaf177)。
  • Android U でのプロファイル インストーラの現在のプロファイルがプロセス開始時に空で作成されていないことによるエラーを修正しました(Ie3899)。
  • V_015S プロファイル形式でのメソッドのビットマップのコード変換を修正しました。(aosp/2906631)、(aosp/2847740

バージョン 1.3

バージョン 1.3.1

2023 年 5 月 3 日

androidx.profileinstaller:profileinstaller:1.3.1 がリリースされました。バージョン 1.3.1 に含まれる commit については、こちらをご覧ください

バグの修正

  • プロファイル インストーラでの Android U のサポートを有効にしました。(Iaf177
  • Android U でのプロファイル インストーラの現在のプロファイルがプロセス開始時に空で作成されていないことによるエラーを修正しました(Ie3899)。

バージョン 1.3.0

2023 年 3 月 22 日

androidx.profileinstaller:profileinstaller:1.3.0 がリリースされました。バージョン 1.3.0 に含まれる commit については、こちらをご覧ください

1.2.0 以降の重要な変更

  • ProfileInstallReceiverNullPointerException を修正しました。(b/243851384
  • ベースライン プロファイルがコンパイル、スケジュール、または欠落しているかどうかをアプリ内からチェックする ProfileVerifier API を追加しました。(I263a4b/246653809
  • ベースライン プロファイルの生成に含めるための新しいシェル ブロードキャストを追加し、Macrobenchmark でメモリ内のプロファイル データをディスクに完全にフラッシュできるようにしました。これは、Macrobenchmark ライブラリを使用して BaselineProfileRule でベースライン プロファイルをキャプチャし、CompilationMode.Partial(warmupIterations) を使用してプロファイルのパフォーマンスを評価するために必要です。
  • 圧縮ベースライン プロファイルを検出するための診断コードを追加しました。圧縮ベースライン プロファイルは、CPU オーバーヘッドのため、Profileinstaller による Macrobenchmarks または本番環境でのインストールができないため、Studio/AGP Electric Eel または bundletool バージョンに更新して、アプリのビルド時に回避する必要があります。1.13.1I86413b/261998144
  • プロファイルをキャプチャし、シェーダー キャッシュを削除するための Macrobenchmark のフックを追加しました。これは、ルート権限のないデバイスでベースライン プロファイルの生成や、Macrobenchmark を実行するために必要です。(Ie0a7db/250083467b/253094958)(Ia5171b/231455742

バージョン 1.3.0-rc01

2023 年 3 月 8 日

androidx.profileinstaller:profileinstaller:1.3.0-rc01 がリリースされました。最後のベータ版からの変更はありません。バージョン 1.3.0-rc01 に含まれる commit については、こちらをご覧ください

バージョン 1.3.0-beta01

2023 年 2 月 8 日

androidx.profileinstaller:profileinstaller:1.3.0-beta01 がリリースされました。バージョン 1.3.0-beta01 に含まれる commit については、こちらをご覧ください

API の変更

  • 圧縮プロファイルの処理のサポートを削除しました。開いて圧縮解除を行う操作によって起動時の CPU 使用量で数十ミリセカンドの回帰が生じるため、代わりに、間違って圧縮されたベースライン プロファイルを検出するための診断を追加しました。(I86413b/261998144

バージョン 1.3.0-alpha03

2023 年 1 月 11 日

androidx.profileinstaller:profileinstaller:1.3.0-alpha03 がリリースされました。バージョン 1.3.0-alpha03 に含まれる commit については、こちらをご覧ください

バグの修正

  • 圧縮または非圧縮のベースライン プロファイルの処理が可能になりました。(Ic61a0
  • profileinstaller マニフェストのブロードキャスト レジストリを修正し、MacrobenchmarkScope.dropShaderCache() がクラッシュしないようにしました。(I5c728b/258619948

バージョン 1.3.0-alpha02

2022 年 11 月 9 日

androidx.profileinstaller:profileinstaller:1.3.0-alpha02 がリリースされました。バージョン 1.3.0-alpha02 に含まれる commit については、こちらをご覧ください

API の変更

  • 特にウォームアップの繰り返しからプロファイルを使ってコンパイルする場合を念頭に、シェーダー キャッシュを削除するためのベンチマークのフックを追加してコールド スタートアップで一貫したパフォーマンスを確保しました。この更新は、benchmark-macro-junit4:1.2.0-alpha05 以降を使用してコールド スタートアップを測定するために必要です。Benchmark ライブラリの API の変更については、Benchmark 1.2.0-alpha07 のページをご覧ください。(Ia5171b/231455742

バージョン 1.3.0-alpha01

2022 年 10 月 24 日

androidx.profileinstaller:profileinstaller:1.3.0-alpha01 がリリースされました。バージョン 1.3.0-alpha01 に含まれる commit については、こちらをご覧ください

API の変更

  • ベースライン プロファイルがコンパイル済み、スケジュール済み、または欠落しているかどうかをアプリ内から確認する ProfileVerifier API を追加しました。(I263a4b/246653809
  • ベースライン プロファイルの生成に含めるための新しいシェル ブロードキャストを追加し、Macrobenchmark でメモリ内のプロファイル データをディスクに完全にフラッシュできるようにしました。これは、Macrobenchmark ライブラリを使用して BaselineProfileRule でベースライン プロファイルをキャプチャし、CompilationMode.Partial(warmupIterations) を使用してプロファイルのパフォーマンスを評価するために必要です。(Ie0a7db/250083467b/253094958

バージョン 1.2.2

バージョン 1.2.2

2023 年 1 月 11 日

androidx.profileinstaller:profileinstaller:1.2.2 がリリースされました。バージョン 1.2.2 に含まれる commit については、こちらをご覧ください

バグの修正

  • 圧縮または非圧縮のベースライン プロファイルの処理が可能になりました。(Ic61a0

バージョン 1.2.1

バージョン 1.2.1

2022 年 12 月 7 日

androidx.profileinstaller:profileinstaller:1.2.1 がリリースされました。バージョン 1.2.1 に含まれる commit については、こちらをご覧ください

新機能

  • S_V2(API 32)と TIRAMISU(API 33)の profileinstaller を有効にしました。(b/254900303

バージョン 1.2.0

バージョン 1.2.0

2022 年 7 月 27 日

androidx.profileinstaller:profileinstaller:1.2.0 がリリースされました。バージョン 1.2.0 に含まれる commit については、こちらをご覧ください

1.1.0 以降の重要な変更

  • Android 12 以降で使用される ART プロファイル形式のサポートを追加しました。
  • ProfileInstallReceiver に新しい API を追加し、ベースライン プロファイルを使用する場合に Macrobenchmarks でより一貫した結果が得られるようにしました。

バージョン 1.2.0-rc01

2022 年 6 月 15 日

androidx.profileinstaller:profileinstaller:1.2.0-rc01 がリリースされました。バージョン 1.2.0-rc01 に含まれる commit については、こちらをご覧ください

  • このバージョンは androidx.profileinstaller:profileinstaller:1.2.0-beta03 と同一です。

バージョン 1.2.0-beta03

2022 年 6 月 1 日

androidx.profileinstaller:profileinstaller:1.2.0-beta03 がリリースされました。バージョン 1.2.0-beta03 に含まれる commit については、こちらをご覧ください

バージョン 1.2.0-beta02

2022 年 5 月 18 日

androidx.profileinstaller:profileinstaller:1.2.0-beta02 がリリースされました。バージョン 1.2.0-beta02 に含まれる commit については、こちらをご覧ください

  • Compose 1.2.0-beta02 バージョンのサポートのために必要な変更はありません。

バージョン 1.2.0-beta01

2022 年 5 月 11 日

androidx.profileinstaller:profileinstaller:1.2.0-beta01 がリリースされました。バージョン 1.2.0-beta01 に含まれる commit については、こちらをご覧ください

API の変更

  • ProfileInstallReceiver に新しい API を追加し、ベースライン プロファイルを使用する際に Macrobenchmarks でより一貫した結果が得られるようにしました。(If2ae5b/215740637

バグの修正

  • Android 12 以降でメタデータ V_001 形式を使用するときに、プロファイル インストーラで有用性の高いメッセージがスローされるようになりました。(aosp/1978526b/217502387
  • プロファイル インストーラで androidx.startup バージョン 1.1.1 が使用されるようになりました。(aosp/2077099b/229828376

バージョン 1.2.0-alpha02

2022 年 1 月 26 日

androidx.profileinstaller:profileinstaller:1.2.0-alpha02 がリリースされました。バージョン 1.2.0-alpha02 に含まれる commit については、こちらをご覧ください

このバージョンは 1.2.0-alpha01 と同一です。

バージョン 1.2.0-alpha01

2022 年 1 月 12 日

androidx.profileinstaller:profileinstaller:1.2.0-alpha01 がリリースされました。バージョン 1.2.0-alpha01 に含まれる commit については、こちらをご覧ください

新機能

  • Android 12 以降で使用される ART プロファイル形式のサポートを追加しました。

バージョン 1.1.0

バージョン 1.1.0

2022 年 2 月 9 日

androidx.profileinstaller:profileinstaller:1.1.0 がリリースされました。バージョン 1.1.0 に含まれる commit については、こちらをご覧ください

バージョン 1.1.0-rc01

2021 年 12 月 15 日

androidx.profileinstaller:profileinstaller:1.1.0-rc01 がリリースされました。1.1.0-beta04 からの変更はありません。バージョン 1.1.0-rc01 に含まれる commit については、こちらをご覧ください

バージョン 1.1.0-beta04

2021 年 12 月 1 日

androidx.profileinstaller:profileinstaller:1.1.0-beta04 がリリースされました。バージョン 1.1.0-beta04 に含まれる commit については、こちらをご覧ください

バージョン 1.1.0-beta03

2021 年 11 月 17 日

androidx.profileinstaller:profileinstaller:1.1.0-beta03 がリリースされました。バージョン 1.1.0-beta03 に含まれる commit については、こちらをご覧ください

バグの修正

  • Compose 1.1.0-beta03 をサポートするように更新しました。

バージョン 1.1.0-beta02

2021 年 11 月 3 日

androidx.profileinstaller:profileinstaller:1.1.0-beta02 がリリースされました。バージョン 1.1.0-beta02 に含まれる commit については、こちらをご覧ください

バグの修正

  • Compose 1.1.0-beta02 をサポートするように更新しました。

バージョン 1.1.0-beta01

2021 年 10 月 27 日

androidx.profileinstaller:profileinstaller:1.1.0-beta01 がリリースされました。バージョン 1.1.0-beta01 に含まれる commit については、こちらをご覧ください

  • 1.1.0-alpha07 からの変更はありません。

バージョン 1.1.0-alpha07

2021 年 10 月 13 日

androidx.profileinstaller:profileinstaller:1.1.0-alpha07 がリリースされました。バージョン 1.1.0-alpha07 に含まれる commit については、こちらをご覧ください。

新機能

  • Android N で profm のサポートを追加

バージョン 1.1.0-alpha06

2021 年 9 月 29 日

androidx.profileinstaller:profileinstaller:1.1.0-alpha06 がリリースされました。バージョン 1.1.0-alpha06 に含まれる commit については、こちらをご覧ください

バグの修正

  • N、O、O_MR1 における profileinstaller のコード変換の問題を修正しました。(I12d75

バージョン 1.1.0-alpha05

2021 年 9 月 15 日

androidx.profileinstaller:profileinstaller:1.1.0-alpha05 がリリースされました。バージョン 1.1.0-alpha05 に含まれる commit については、こちらをご覧ください

バグの修正

  • Multidex APK の Android Nougat と Android Oreo プロファイルのコード変換を修正しました。

バージョン 1.1.0-alpha04

2021 年 9 月 1 日

androidx.profileinstaller:profileinstaller:1.1.0-alpha04 がリリースされました。バージョン 1.1.0-alpha04 に含まれる commit については、こちらをご覧ください

バグの修正

  • ProfileInstaller を修正し、ベースライン プロファイルを使用するアプリで CompilationMode.BaselineProfile を使って MacroBenchmark を簡単に実行できるようにしました。(I42657b/196074999

バージョン 1.1.0-alpha03

2021 年 8 月 18 日

androidx.profileinstaller:profileinstaller:1.1.0-alpha03 がリリースされました。バージョン 1.1.0-alpha03 に含まれる commit については、こちらをご覧ください

バグの修正

  • ProfileInstaller のスキップの動作を変更して、PackageInfo.lastUpdatedTime をアプリのファイル ディレクトリ内のファイルに記録し、次回実行時のプロファイルのインストール前に比較するようにしました。(Ib93d1
  • P、Q、R デバイスのプロファイル形式を調整し、ART の要件を遵守するようにしました(I84e89

バージョン 1.1.0-alpha02

2021 年 8 月 4 日

androidx.profileinstaller:profileinstaller:1.1.0-alpha02 がリリースされました。バージョン 1.1.0-alpha02 に含まれる commit については、こちらをご覧ください

Compose 1.1.0-alpha01 との互換性を確保するために更新しました。

バージョン 1.1.0-alpha01

2021 年 7 月 21 日

androidx.profileinstaller:profileinstaller:1.1.0-alpha01 がリリースされました。バージョン 1.1.0-alpha01 に含まれる commit については、こちらをご覧ください

バグの修正

  • 特定の状況で厳格モードがトリガーされるバグを修正しました。

バージョン 1.0

バージョン 1.0.4

2021 年 10 月 13 日

androidx.profileinstaller:profileinstaller:1.0.4 がリリースされました。バージョン 1.0.4 に含まれる commit については、こちらをご覧ください

  • Compose 1.0.4 をサポートするように更新しました

バージョン 1.0.3

2021 年 9 月 29 日

androidx.profileinstaller:profileinstaller:1.0.3 がリリースされました。バージョン 1.0.3 に含まれる commit については、こちらをご覧ください

  • Compose 1.0.3 をサポートするように更新しました

バージョン 1.0.2

2021 年 9 月 1 日

androidx.profileinstaller:profileinstaller:1.0.2 がリリースされました。バージョン 1.0.2 に含まれる commit については、こちらをご覧ください

バグの修正

  • P、Q、R デバイスのプロファイルのコード変換を追加しました。この変更により、これらのデバイスではプロファイルがコード変換され、記述したプロファイルが常に ART で使用できるようになります。これらのプラットフォームでは、以前コード変換がスキップされ、ART がソース プロファイルを処理できないことがありました。デベロッパー向け API に変更はありません。

バージョン 1.0.1

2021 年 8 月 4 日

androidx.profileinstaller:profileinstaller:1.0.1 がリリースされました。バージョン 1.0.1 に含まれる commit については、こちらをご覧ください

Compose 1.0.1 との互換性を確保するために更新しました。

バージョン 1.0.0

2021 年 7 月 28 日

androidx.profileinstaller:profileinstaller:1.0.0 がリリースされました。バージョン 1.0.0 に含まれる commit については、こちらをご覧ください

1.0.0 の主な機能

ProfileInstaller は、ライブラリとアプリが「プロファイル ルール」を定義して ART プロファイル情報を APK にバンドルするための新しいライブラリです。このライブラリは、アプリの起動後に該当プロファイルをインストールします。これは、アプリのパフォーマンスの向上に役立ちます。

プロファイル ルールの詳細と仕組みについては、1.0.0-beta01 のリリースノートをご覧ください。

バージョン 1.0.0-rc02

2021 年 7 月 14 日

androidx.profileinstaller:profileinstaller:1.0.0-rc02 がリリースされました。バージョン 1.0.0-rc02 に含まれる commit については、こちらをご覧ください

バージョン 1.0.0-rc01

2021 年 7 月 1 日

androidx.profileinstaller:profileinstaller:1.0.0-rc01 がリリースされました。バージョン 1.0.0-rc01 に含まれる commit については、こちらをご覧ください

これはリリース候補版であり、ベータ版からの変更はありません。

バージョン 1.0.0-beta01

2021 年 6 月 16 日

androidx.profileinstaller:profileinstaller:1.0.0-beta01 がリリースされました。バージョン 1.0.0-beta01 に含まれる commit については、こちらをご覧ください

ライブラリの目的

ProfileInstaller は、ライブラリとアプリが「プロファイル ルール」を定義して ART プロファイル情報を APK にバンドルするための新しいライブラリです。このライブラリは、アプリの起動後に該当プロファイルをインストールします。これは、アプリのパフォーマンスの向上に役立ちます。

このプロファイルのインストールは、androidx.startup ライブラリで行われます。なんらかの理由でプロファイルのインストールを無効にする場合は、マニフェストを変更して削除できます。


       <provider
           android:name="androidx.startup.InitializationProvider"
           android:authorities="${applicationId}.androidx-startup"
           android:exported="false"
           tools:node="merge">
           <meta-data android:name="androidx.profileinstaller.ProfileInstallerInitializer"
                     tools:node="remove" />
       </provider>

これは、アプリの起動要件が複雑で、ProfileInstaller.writeProfile API を使用してプロファイルのインストールを手動でトリガーする必要がある場合、特に便利です。

プロファイル ルールとは

  • ライブラリのプロファイル ルールは、src/main または同等のディレクトリにあるテキスト ファイル baseline-prof.txt で指定します。このファイルでは、1 行に 1 つずつルールを指定します。ここでのルールは、ライブラリ内のメソッドまたはクラスと合致するパターンです。ルールの構文は、人が読める ART プロファイル形式のスーパーセットで、adb shell profman --dump-classes-and-methods ... を使用する際に使用されます。ルールは、メソッドまたはクラスをターゲットとする 2 つの形式のいずれかを使用します。

  • メソッドルールのパターンは次のようになります。

    <FLAGS><CLASS_DESCRIPTOR>-><METHOD_SIGNATURE>
    
  • クラスルールのパターンは次のようになります。

    <CLASS_DESCRIPTOR>
    
  • 上記の <FLAGS> には、このメソッドに「ホット」、「起動」、または「起動後」のフラグを付ける場合にそれぞれ文字 HSP(1 つまたは複数)を入力します。

  • <CLASS_DESCRIPTOR> は、ターゲットとなるメソッドが属するクラスの記述子です。たとえば、クラス androidx.compose.runtime.SlotTable の記述子は、Landroidx/compose/runtime/SlotTable; です。

  • <METHOD_SIGNATURE> はメソッドのシグネチャで、メソッドの名前、パラメータの型、戻り値の型を含みます。たとえば、LayoutNode のメソッド fun isPlaced(): Boolean のシグネチャは、isPlaced()Z です。

  • 1 つのルールに複数のメソッドまたはクラスを含める場合は、これらのパターンにワイルドカード(***?)を使用できます。

ルールの機能

  • フラグ H が付いているメソッドは、このメソッドが「ホット」メソッドであり、事前コンパイルが必要であることを示します。

  • S フラグが付いているメソッドは、このメソッドが起動時に呼び出されるメソッドであり、コンパイルのコストと起動時にメソッドを解釈するコストを回避するために事前コンパイルが必要であることを示します。

  • P フラグが付いているメソッドは、このメソッドが起動後に呼び出されることを示します。

  • このファイルに存在するクラスは、このクラスが起動時に使用されるクラスであり、クラス読み込みのコストを回避するためにヒープで事前割り当てする必要があることを示しています。

ルールの仕組み

  • ライブラリは、AAR アーティファクトにパッケージするルールを定義できます。それらのアーティファクトを含む APK がビルドされると、ルールが結合されます。結合されたルールは、APK に固有のコンパクト バイナリ ART プロファイルをビルドするために使用されます。ART は、アプリの特定のサブセットを事前コンパイルするために、APK がデバイスにインストールされたときにこのプロファイルを利用して、アプリのパフォーマンス(特に初回実行時)を改善できます。なお、これはデバッグ可能なアプリには影響しません。

  • ルールファイルには baseline-prof.txt という名前を付けて、メイン ソースセットのルート ディレクトリに配置する必要があります(AndroidManifset.xml ファイルの兄弟ファイルにする必要があります)。

  • 現時点では、これらのファイルを利用できるのは、Android Gradle プラグイン 7.0 以降を使用し、gradle.properties 内のフラグで有効にしている場合のみです。

    # Enable adding baseline-prof.txt files to AAR artifacts, and binary profiles to APKs
    android.experimental.enableArtProfiles=true
    

プロファイルにはバランスが必要

  • 最良の結果を得るには、起動パスに含まれ、パフォーマンス上重要な役割を果たすメソッドとクラスを正しく優先順位付けするように適切に作成されたプロファイルが必要です。しかし、プロファイルに含めるメソッドまたはクラスの数が多すぎると、メモリ消費とディスク使用に関して実質的にマイナスの影響が生じる可能性があります。したがって、独自のプロファイル ルールを定義する場合は、控えめなルールからスタートすることをおすすめします。