互換性フレームワークの変更(Android 15)

図 1. 開発者向けオプションの [アプリの互換性の変更] 画面に、切り替え可能な変更の一覧が表示されています。

このページでは、Android 15 の互換性フレームワークに含まれる切り替え可能な変更について説明します。Android 15 をサポートし、ターゲットとするアプリのテストとデバッグを行うには、このリストを開発者向けオプションおよび ADB コマンドと組み合わせて使用してください。

以下に、互換性フレームワーク ツールでできることをいくつか示します。

  • アプリの targetSdkVersion を実際には変更せずに、ターゲット固有の変更をテストする。切り替えを使用して、特定のターゲット固有の動作変更を強制的に有効にし、既存のアプリに対する影響を評価できます。
  • 特定の変更にテストを集中させる。切り替えを使用することで、テスト対象以外のターゲット固有の変更をすべて無効にできます。これにより、一度にすべてのターゲット固有の変更に対処する必要がなくなります。
  • adb を介して切り替えを管理する。adb コマンドを使用すると、切り替え可能な変更を自動テスト環境で有効または無効にできます。
  • 標準の変更 ID を使用して迅速にデバッグする。切り替え可能な変更にはそれぞれ一意の ID と名前が付けられており、ログ出力から問題の根本原因を速やかにデバッグできます。

各ユースケースでのツールの使用方法について詳しくは、互換性フレームワーク ツールをご覧ください。

互換性フレームワークに含まれる動作変更

このセクションでは、Android 15 関連の変更の互換性フレームワークに含まれる切り替え可能な変更と、一般的なアプリのテストに役立つ切り替え可能な変更について説明します。

変更リストはデフォルトの状態でフィルタできます。

Android 15 の互換性フレームワークの切り替え可能な変更

CAMERA_MIC_INDICATORS_NOT_PRESENT

変更 ID: 162547999
デフォルトの状態: すべてのアプリで無効。

このデバイスがカメラとマイクのインジケーターをサポートしていることを示します。変更 ID が存在しない場合、CompatChanges#isChangeEnabled メソッドは true を返すため、値は false になります。

DOWNSCALED

変更 ID: 168419799
デフォルトの状態: すべてのアプリで無効。

この変更は、アプリごとのすべてのバッファ ダウンスケーリング変更のゲートキーパーです。この変更を有効にすると、次のスケーリング ファクタを適用できます。

この変更がアプリ パッケージに対して有効になっている場合、アプリは有効な最大のスケーリング ファクタに強制的にサイズ変更されます。たとえば、80% と 70% の両方(DOWNSCALE_80DOWNSCALE_70)が有効になっている場合は 80% が使用されます。この変更と DOWNSCALED_INVERSE の両方が有効になっている場合、DOWNSCALED_INVERSE が優先され、スケーリング ファクタが逆に適用されます。

DOWNSCALED_INVERSE

変更 ID: 273564678
デフォルトの状態: すべてのアプリで無効。

この変更は、アプリごとのすべてのバッファ逆ダウンスケーリング変更のゲートキーパーです。この変更を有効にすると、次のスケーリング ファクタが逆方向に適用されます(つまり、解像度がアップスケールされます)。

この変更がアプリ パッケージに対して有効になっている場合、アプリは有効な最小のスケーリング ファクタに強制的にサイズ変更されます。たとえば、80% と 70%(DOWNSCALE_80DOWNSCALE_70)の両方が有効な場合は 80% が使用されます。逆方向に適用した場合、80% のスケーリング ファクタは 125% に等しくなります。これは、70% のスケーリング ファクタを逆に適用した場合に適用される 142.86% よりも小さいためです。この変更と DOWNSCALED の両方が有効になっている場合、DOWNSCALED_INVERSE が優先され、スケーリング ファクタが逆に適用されます。

DOWNSCALE_30

変更 ID: 189970040
デフォルトの状態: すべてのアプリで無効。

DOWNSCALED も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリでは実際のディスプレイの垂直解像度と水平解像度の 30% のディスプレイで実行されていると認識されます。DOWNSCALED_INVERSE も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリでは実際のディスプレイの垂直解像度と水平解像度が 333.33% のディスプレイで実行されていると認識されます。

DOWNSCALE_35

変更 ID: 189969749
デフォルトの状態: すべてのアプリで無効。

DOWNSCALED も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリは実際のディスプレイの垂直解像度と水平解像度の 35% のディスプレイで実行されていると認識します。DOWNSCALED_INVERSE も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリは実際のディスプレイの垂直解像度と水平解像度の 285.71% のディスプレイで実行されていると認識します。

DOWNSCALE_40

変更 ID: 189970038
デフォルトの状態: すべてのアプリで無効。

DOWNSCALED も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリでは実際のディスプレイの垂直解像度と水平解像度の 40% のディスプレイで実行されていると認識されます。DOWNSCALED_INVERSE も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリは実際のディスプレイの垂直解像度と水平解像度の 250% のディスプレイで実行されていると認識します。

DOWNSCALE_45

変更 ID: 189969782
デフォルトの状態: すべてのアプリで無効。

DOWNSCALED も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリは実際のディスプレイの垂直解像度と水平解像度の 45% のディスプレイで実行されていると認識します。DOWNSCALED_INVERSE も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリは実際のディスプレイの垂直解像度と水平解像度の 222.22% のディスプレイで実行されていると認識します。

DOWNSCALE_50

変更 ID: 176926741
デフォルトの状態: すべてのアプリで無効。

DOWNSCALED も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリでは実際のディスプレイの垂直解像度と水平解像度の 50% のディスプレイで実行されていると認識されます。DOWNSCALED_INVERSE も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリは実際のディスプレイの垂直解像度と水平解像度の 200% のディスプレイで実行されていると認識します。

DOWNSCALE_55

変更 ID: 189970036
デフォルトの状態: すべてのアプリで無効。

DOWNSCALED も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリは実際のディスプレイの垂直解像度と水平解像度の 55% のディスプレイで実行されていると認識します。DOWNSCALED_INVERSE も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリは実際のディスプレイの垂直解像度と水平解像度の 181.82% のディスプレイで実行されていると認識します。

DOWNSCALE_60

変更 ID: 176926771
デフォルトの状態: すべてのアプリで無効。

DOWNSCALED も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリでは実際のディスプレイの垂直解像度と水平解像度の 60% のディスプレイで実行されていると認識されます。DOWNSCALED_INVERSE も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリでは実際のディスプレイの垂直解像度と水平解像度が 166.67% のディスプレイで実行されていると認識されます。

DOWNSCALE_65

変更 ID: 189969744
デフォルトの状態: すべてのアプリで無効。

DOWNSCALED も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリでは実際のディスプレイの垂直解像度と水平解像度の 65% のディスプレイで実行されていると認識されます。DOWNSCALED_INVERSE も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリは実際のディスプレイの垂直解像度と水平解像度の 153.85% のディスプレイで実行されていると認識します。

DOWNSCALE_70

変更 ID: 176926829
デフォルトの状態: すべてのアプリで無効。

DOWNSCALED も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリでは実際のディスプレイの垂直解像度と水平解像度の 70% のディスプレイで実行されていると認識されます。DOWNSCALED_INVERSE も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリは実際のディスプレイの垂直解像度と水平解像度の 142.86% のディスプレイで実行されていると認識します。

DOWNSCALE_75

変更 ID: 189969779
デフォルトの状態: すべてのアプリで無効。

DOWNSCALED も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリは実際のディスプレイの垂直解像度と水平解像度の 75% のディスプレイで実行されていると認識します。DOWNSCALED_INVERSE も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリでは実際のディスプレイの垂直解像度と水平解像度が 133.33% のディスプレイで実行されていると認識されます。

DOWNSCALE_80

変更 ID: 176926753
デフォルトの状態: すべてのアプリで無効。

DOWNSCALED も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリでは実際のディスプレイの垂直解像度と水平解像度の 80% のディスプレイで実行されていると認識されます。DOWNSCALED_INVERSE も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリは実際のディスプレイの垂直解像度と水平解像度の 125% のディスプレイで実行されていると認識します。

DOWNSCALE_85

変更 ID: 189969734
デフォルトの状態: すべてのアプリで無効。

DOWNSCALED も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリは実際のディスプレイの垂直解像度と水平解像度の 85% のディスプレイで実行されていると認識します。DOWNSCALED_INVERSE も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリは実際のディスプレイの垂直解像度と水平解像度の 117.65% のディスプレイで実行されていると認識します。

DOWNSCALE_90

変更 ID: 182811243
デフォルトの状態: すべてのアプリで無効。

DOWNSCALED も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリは実際のディスプレイの垂直解像度と水平解像度の 90% のディスプレイで実行されていると認識します。DOWNSCALED_INVERSE も有効になっている場合、パッケージに対してこの変更を有効にすると、アプリは実際のディスプレイの垂直解像度と水平解像度の 111.11% のディスプレイで実行されていると認識します。

ENFORCE_STRICT_QUERY_BUILDER

変更 ID: 143231523
デフォルトの状態: すべてのアプリで無効。

有効にすると、SQLiteQueryBuilder はすべての CalendarProvider2 クエリの選択に対し、悪意のある引数がないか検証します。

FGS_BOOT_COMPLETED_RESTRICTIONS

変更 ID: 296558535
デフォルトの状態: Android 15 以上をターゲットとするアプリで有効。

有効にすると、以下を除くすべてのタイプで、フォアグラウンド サービスのバックグラウンドが BOOT_COMPLETED ブロードキャストから開始されます。

この変更について詳しくは、Android 15 の動作変更ページで、 フォアグラウンド サービスを起動する BOOT_COMPLETED ブロードキャスト レシーバの制限に関するセクションをご覧ください。

FORCE_DISABLE_HEVC_SUPPORT

変更 ID: 174227820
デフォルトの状態: すべてのアプリで無効。

アプリが HEVC メディア機能のサポートを強制的に無効にします。 アプリは、サポートされているメディア機能をマニフェストで宣言する必要がありますが、このフラグを使用すると、アプリが HEVC をサポートしないように強制できるため、HEVC でエンコードされたメディアにアクセスする際に、コード変換を強制適用できます。このフラグを設定すると、アプリの OS レベルのデフォルトがオーバーライドされます。デフォルトでは無効になっています。つまり、OS のデフォルトが優先されます。このフラグと FORCE_ENABLE_HEVC_SUPPORT の両方が有効になっている場合、OS は両方のフラグを無視します。

FORCE_ENABLE_HEVC_SUPPORT

変更 ID: 174228127
デフォルトの状態: すべてのアプリで無効。

アプリが HEVC メディア機能を強制的にサポートできるようにする場合、アプリは、サポート対象のメディア機能をマニフェストで宣言する必要があります。ただし、このフラグを使用すると、アプリに HEVC のサポートを強制して、HEVC でエンコードされたメディアにアクセスする際のコード変換を回避できます。このフラグを設定すると、アプリの OS レベルのデフォルトがオーバーライドされます。デフォルトでは無効になっています。つまり、OS のデフォルトが優先されます。このフラグと FORCE_DISABLE_HEVC_SUPPORT の両方が有効になっている場合、OS は両方のフラグを無視します。

FORCE_NON_RESIZE_APP

変更 ID: 181146395
デフォルトの状態: すべてのアプリで無効。

適用されるパッケージを強制的にサイズ変更不可にします。

FORCE_RESIZE_APP

変更 ID: 174042936
デフォルトの状態: すべてのアプリで無効。

適用されるパッケージを強制的にサイズ変更可能にします。全画面ウィンドウ モードでのみサイズ変更が可能ですが、アプリを強制的にサイズ変更可能なマルチウィンドウ モードにすることはできません。

GWP_ASAN

変更 ID: 145634846
デフォルトの状態: すべてのアプリで無効。

サンプリングされるネイティブ メモリのバグ検出をアプリで有効にします。

GWP-ASan の使用方法について詳しくは、GWP-ASan ガイドをご覧ください。

NATIVE_HEAP_ZERO_INIT

変更 ID: 178038272
デフォルトの状態: すべてのアプリで無効。

ネイティブ ヒープのメモリ割り当ての自動ゼロ初期化を有効にします。

NATIVE_MEMTAG_ASYNC

変更 ID: 145772972
デフォルトの状態: すべてのアプリで無効。

このプロセスで非同期(ASYNC)メモリタグのチェックを有効にします。 このフラグは、ARM メモリタグ付け拡張機能(MTE)をサポートするハードウェアにのみ影響します。

NATIVE_MEMTAG_SYNC

変更 ID: 177438394
デフォルトの状態: すべてのアプリで無効。

このプロセスで同期(SYNC)メモリタグのチェックを有効にします。 このフラグは、ARM メモリタグ付け拡張機能(MTE)をサポートするハードウェアにのみ影響します。NATIVE_MEMTAG_ASYNC とこのオプションの両方を有効にすると、このオプションが優先され、SYNC モードで MTE が有効になります。

OVERRIDE_ANY_ORIENTATION

変更 ID: 265464455
デフォルトの状態: すべてのアプリで無効。

この変更を有効にすると、アクティビティによってリクエストされた向きに関係なく、次の向きのオーバーライドを適用できます。

OVERRIDE_ANY_ORIENTATION_TO_USER

変更 ID: 310816437
デフォルトの状態: すべてのアプリで無効。

有効にすると、SCREEN_ORIENTATION_USER が有効になり、アクティビティによってリクエストされた向きがオーバーライドされます。このオーバーライドにより、ignoreOrientationRequest が有効になっている大画面デバイスでは、固定された向きのアプリをオーバーライドして全画面表示にできます。

OVERRIDE_CAMERA_RESIZABLE_AND_SDK_CHECK

変更 ID: 191514214
デフォルトの状態: すべてのアプリで無効。

この変更を有効にすると、適用されるパッケージは android:resizeableActivity の現在の値と M 以下のターゲット SDK を無視し、アクティビティはサイズ変更不可と見なされます。この場合、カメラの回転と切り抜きの値は、現在のディスプレイの回転を考慮した必要な補正にのみ依存します。

OVERRIDE_CAMERA_ROTATE_AND_CROP_DEFAULTS

変更 ID: 189229956
デフォルトの状態: すべてのアプリで無効。

この変更を有効にすると、適用されているパッケージでカメラの回転と切り抜きのデフォルトの動作がオーバーライドされ、常に CaptureRequest.SCALER_ROTATE_AND_CROP_NONE が返されます。

OVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE

変更 ID: 266124927
デフォルトの状態: すべてのアプリで無効。

適用先のアプリの SCREEN_ORIENTATION_REVERSE_LANDSCAPE を有効にします。OVERRIDE_ANY_ORIENTATION も有効になっていない限り、SCREEN_ORIENTATION_REVERSE_LANDSCAPE はアクティビティが横向きを指定している場合にのみ使用されます。この変更を有効にすると、横向きが Surface.ROTATION_90 に対応するデバイスと Surface.ROTATION_270 に対応するデバイスとで、アプリの動作をテストできます。

OVERRIDE_MIN_ASPECT_RATIO

変更 ID: 174042980
デフォルトの状態: すべてのアプリで無効。

この変更により、所定の最小アスペクト比を強制的に適用するすべての変更が管理されます。この変更を有効にすると、以下の最小アスペクト比を適用できます。

この変更をアプリ パッケージに対して有効にすると、アプリのマニフェストで指定された最小アスペクト比は、アプリのマニフェスト値よりも大きい場合を除き、有効な最大アスペクト比にオーバーライドされます。

OVERRIDE_MIN_ASPECT_RATIO_EXCLUDE_PORTRAIT_FULLSCREEN

変更 ID: 218959984
デフォルトの状態: すべてのアプリで無効。

有効にすると、使用可能な画面スペースをすべて使用するために、縦向きの全画面表示の最小アスペクト比の制限がオーバーライドされます。

OVERRIDE_MIN_ASPECT_RATIO_LARGE

変更 ID: 180326787
デフォルトの状態: すべてのアプリで無効。

OVERRIDE_MIN_ASPECT_RATIO も有効になっている場合、パッケージに対してこの変更を有効にすると、アクティビティの最小アスペクト比が OVERRIDE_MIN_ASPECT_RATIO_LARGE_VALUE で定義されている大きな値に設定されます。

OVERRIDE_MIN_ASPECT_RATIO_MEDIUM

変更 ID: 180326845
デフォルトの状態: すべてのアプリで無効。

OVERRIDE_MIN_ASPECT_RATIO も有効になっている場合、パッケージに対してこの変更を有効にすると、アクティビティの最小アスペクト比が OVERRIDE_MIN_ASPECT_RATIO_MEDIUM_VALUE で定義されている中程度の値に設定されます。

OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY

変更 ID: 203647190
デフォルトの状態: すべてのアプリで有効。

OVERRIDE_MIN_ASPECT_RATIO も有効になっている場合、この変更により、アクティビティの最小アスペクト比を特定の値(OVERRIDE_MIN_ASPECT_RATIO_LARGEOVERRIDE_MIN_ASPECT_RATIO_MEDIUM など)に強制するその他の変更が、縦向きもアクティビティに設定されることはありません。

OVERRIDE_RESPECT_REQUESTED_ORIENTATION

変更 ID: 236283604
デフォルトの状態: すべてのアプリで無効。

この変更を有効にすると、デバイス メーカーが設定できる画面の向きの制限を無視するよう、適用されるパッケージが除外されます。

OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR

変更 ID: 265451093
デフォルトの状態: すべてのアプリで無効。

適用先のアプリの SCREEN_ORIENTATION_NOSENSOR を有効にします。OVERRIDE_ANY_ORIENTATION も有効になっていない限り、SCREEN_ORIENTATION_NOSENSOR はアクティビティが他の固定の向きを指定していない場合にのみ使用されます。

OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT

変更 ID: 265452344
デフォルトの状態: すべてのアプリで無効。

適用先のアプリの SCREEN_ORIENTATION_PORTRAIT を有効にします。OVERRIDE_ANY_ORIENTATION も有効になっていない限り、SCREEN_ORIENTATION_PORTRAIT はアクティビティが他の固定の向きを指定していない場合にのみ使用されます。

RATE_LIMIT_TOASTS

変更 ID: 174840628
デフォルトの状態: この変更は切り替えができません。互換性フレームワークによってログに記録されるだけです。

Toast.show() 呼び出し回数のレート制限を有効にして、限られた時間内に大量のトーストでユーザーに負担がかかることを防ぎます。特定の期間内に許可された数を超えるトーストを表示しようとすると、トーストは破棄されます。

USE_EXPERIMENTAL_COMPONENT_ALIAS

変更 ID: 196254758
デフォルトの状態: すべてのアプリで無効。

有効にすると、「android」パッケージでコンポーネント エイリアスを使用できるようになります。