互換性フレームワークの変更（Android 13）

ALWAYS_SANDBOX_DISPLAY_APIS

ウィンドウ モードに関係なく、適用されるパッケージを常に Display API サンドボックス化します。Display API は、常にアプリ境界を提供するようになります。

この変更について詳しくは、Display#getRealSize と getRealMetrics: 非推奨化とサンドボックス化をご覧ください。

CAMERA_MIC_INDICATORS_NOT_PRESENT

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

DEFER_BOOT_COMPLETED_BROADCAST_CHANGE_ID

Android 13 以上をターゲットとするアプリの場合、UID 内のプロセスが初めて開始されるまで、LOCKED_BOOT_COMPLETED および BOOT_COMPLETED ブロードキャストを延期します。

DOWNSCALED

この変更により、アプリごとのバッファのダウンスケーリング変更が管理されます。この変更を無効にすると、以下のスケーリング ファクタは機能しなくなります。

• DOWNSCALE_30
• DOWNSCALE_35
• DOWNSCALE_40
• DOWNSCALE_45
• DOWNSCALE_50
• DOWNSCALE_55
• DOWNSCALE_60
• DOWNSCALE_65
• DOWNSCALE_70
• DOWNSCALE_75
• DOWNSCALE_80
• DOWNSCALE_85
• DOWNSCALE_90

アプリのパッケージでこの変更が有効になっている場合、アプリは、有効になっている最大のスケーリング ファクタに強制的に変更されます。たとえば、80% と 70% の両方が有効になっている場合は 80% が使用されます。

DOWNSCALE_30

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

DOWNSCALE_35

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

DOWNSCALE_40

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

DOWNSCALE_45

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

DOWNSCALE_50

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

DOWNSCALE_55

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

DOWNSCALE_60

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

DOWNSCALE_65

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

DOWNSCALE_70

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

DOWNSCALE_75

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

DOWNSCALE_80

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

DOWNSCALE_85

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

DOWNSCALE_90

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

DYNAMIC_RECEIVER_EXPLICIT_EXPORT_REQUIRED

Android 13 以上をターゲットとするアプリの場合、保護されていないブロードキャストのレシーバをコードで登録する際に Context.RECEIVER_EXPORTED または Context.RECEIVER_NOT_EXPORTED を明示的に設定することが必須になりました。

この変更について詳しくは、コンテキスト登録されたレシーバのエクスポートの安全性の強化に関するセクションをご覧ください。

FORCE_DISABLE_HEVC_SUPPORT

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

FORCE_ENABLE_HEVC_SUPPORT

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

FORCE_NON_RESIZE_APP

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

FORCE_RESIZE_APP

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

KEYSTORE_OPERATION_CREATION_MAY_FAIL

有効にすると、キーストア オペレーションの作成が新しいプルーニング戦略に沿って失敗することがあります。以前、キーストアは暗号オペレーションの作成が常に成功するという前提で動作していました。しかし、KeyMint バックエンドのオペレーション スロット数には限りがあります。

オペレーション スロットが「無限」にあるという外観を維持するため、使用可能なオペレーション スロットがない場合、キーストア デーモンは最後に使用されてから最も時間の経ったオペレーションをプルーニングしていました。その結果、良好なオペレーションが途中で終了することがありました。これにより、AndroidKeystore はサービス拒否（DoS）と意図しないライブロックが発生するリスクにさらされました。たとえば、電源管理の最適化により複数のアプリが同時に起動して暗号オペレーションを実行しようとした場合、それらは互いのオペレーションを終了する処理を開始し、進行しなくなります。

ライブロックの解消や DoS の阻止を実現するため、プルーニング戦略が変更され、少数のオペレーション スロットを短時間のみ使用するクライアントが優先されるようになりました。その結果、非アクティブ状態が 5 秒を超えない単一のオペレーションは、ほとんど常にプルーニング戦略によって妨げられることなく完了するようになります。ファイル システムの暗号化に関連するオペレーションの中には、そのようなオペレーションすらプルーニングするものがありますが、そうしたケースは非常にまれです。この新しいプルーニング戦略オペレーションの副作用として、クライアントのプルーニング能力が既存のすべてのオペレーションよりも低い場合、作成が失敗する可能性があります。

プルーニング戦略: 適切な候補を見つけるため、呼び出し元と個々の既存のオペレーションのマルスを計算します。マルスとは、プルーニング能力（呼び出し元）またはプルーニング抵抗力（既存のオペレーション）の逆数です。呼び出し元がオペレーションをプルーニングできるためには、自分よりも高いマルスを持つオペレーションを見つける必要があります。プルーニング戦略について詳しくは、operation.rs の実装をご覧ください。Android 11（API レビュー 30）以下では、KeyStore2 はキーストア デーモンをポーリングして空いているオペレーション スロットを探します。Android 11（API レビュー 30）以下をターゲットとするアプリの場合、暗号と署名のオブジェクトの初期化は常に成功するように見えますが、オペレーションを取得する時間が長くなる可能性があります。すべての Android バージョンで、より公平なオペレーション スロットのスケジューリングが実現され、オペレーションを正常に完了できる可能性が高くなります。

NATIVE_HEAP_ZERO_INIT

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

NATIVE_MEMTAG_ASYNC

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

NATIVE_MEMTAG_SYNC

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

NEVER_SANDBOX_DISPLAY_APIS

適用されるパッケージを、レターボックスまたは SCM アクティビティに対して Display API サンドボックス化しないようにします。Display API は、今後も引き続き DisplayArea 境界を提供します。

この変更について詳しくは、Display#getRealSize と getRealMetrics: 非推奨化とサンドボックス化をご覧ください。

NOTIFICATION_LOG_ASSISTANT_CANCEL

Android 13 以上をターゲットとするアプリの場合、アシスタントからの通知がキャンセルされる理由として一般的な REASON_LISTENER_CANCEL を使用する代わりに、より具体的な理由を示して、リスナーが簡単に理解できるようにします。

NOTIFICATION_PERM_CHANGE_ID

Android 13 以上をターゲットとするアプリに対して、実行時の権限または通知に関連する動作変更を有効にします。

この変更について詳しくは、新しく導入された通知に関する実行時の権限のページをご覧ください。

OVERRIDE_CAMERA_RESIZABLE_AND_SDK_CHECK

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

OVERRIDE_CAMERA_ROTATE_AND_CROP_DEFAULTS

この変更 ID が有効になっている場合、適用されるパッケージでデフォルトのカメラの回転と切り抜きの動作がオーバーライドされ、常に CaptureRequest.SCALER_ROTATE_AND_CROP_NONE が返されるようになります。デフォルトの動作と、すべてのオーバーライドの組み合わせを以下の表で説明します。

OVERRIDE_MIN_ASPECT_RATIO

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

• OVERRIDE_MIN_ASPECT_RATIO_LARGE
• OVERRIDE_MIN_ASPECT_RATIO_MEDIUM
• OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY

アプリのパッケージでこの変更が有効になっている場合、アプリのマニフェストで指定されている最小のアスペクト比が、最大の有効なアスペクト比よりも優先されます（アプリのマニフェスト値の方が大きい場合を除く）。

OVERRIDE_MIN_ASPECT_RATIO_LARGE

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

OVERRIDE_MIN_ASPECT_RATIO_MEDIUM

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

OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY

OVERRIDE_MIN_ASPECT_RATIO も有効になっている場合、パッケージでこの変更を有効にすると、画面の向きが縦向きのアクティビティに対する、アクティビティの最小アスペクト比を強制的に特定の値（OVERRIDE_MIN_ASPECT_RATIO_LARGE や OVERRIDE_MIN_ASPECT_RATIO_MEDIUM など）にする他の変更が制限されます。

RATE_LIMIT_TOASTS

Toast.show() 呼び出し数のレート制限を有効にして、限られた時間内の過剰なトーストでユーザーに過度の負荷をかけないようにします。特定の時間枠で許可された数よりも多いトーストを表示しようとすると、トーストは破棄されます。

SUPPORT_DEREGISTERING_LOSING_PDN_STATE

Android 13 以上をターゲットとするアプリに対して、API で状態 DEREGISTERING_REASON_LOSING_PDN をサポートします（DelegateRegistrationState#addDeregisteringFeatureTag と DelegateRegistrationState#getDeregisteringFeatureTags など）。

SUPPORT_PUBLISHING_STATE

Android 13 以上をターゲットとするアプリに対して、API で状態 publishing をサポートします（RcsUceAdapter#PUBLISH_STATE_PUBLISHINGsupport など）。

SUPPORT_REGISTERING_DELEGATE_STATE

Android 13 以上をターゲットとするアプリに対して、API で状態 REGISTERING をサポートします（DelegateRegistrationState#addRegisteringFeatureTags と DelegateRegistrationState#getRegisteringFeatureTagssupport など）。