Android では、画面の向きやサイズ変更の制限を宣言するアプリに対して、互換モードが有効になります。互換性モードを使用すると、大画面デバイスや折りたたみ式折りたたみ式スマートフォンで許容されるアプリの動作が保証されますが、ユーザビリティは最適とはなりません。
アプリごとのオーバーライドを使用すると、デバイス メーカーは、ユーザー エクスペリエンスを改善したり、特定のデバイスでアプリが動作しなくなるのを防ぐためにアプリの動作を変更できます。
参照デバイス
以下のデバイスでは、アプリで適切にサポートされていない異常な構成や構成があるため、アプリごとのオーバーライドが必要になる場合があります。
- タブレット: Google Pixel Tablet など、一部のタブレットでは自然な向きが横向きです。
Display#getRotation()がSurface.ROTATION_0を返す場合、デバイスは自然な向きです。アプリでROTATION_0が縦向きであると想定すると、アプリのレイアウトやカメラ プレビューがデバイスのディスプレイと一致しないことがあります。 - 横向きの折りたたみ式デバイス: Google Pixel Fold などの一部の折りたたみ式デバイスは、折りたたむと縦向きになり、展開すると横向きになります。展開した向きが縦向きであるとアプリで想定している場合、ループのちらつきやレイアウトの問題が発生する可能性があります。
- 折りたたみ式折りたたみ式スマートフォン: 折りたたまれた折りたたみ式スマートフォンは通常、縦向きです。ただし、折りたたんだ状態では、通常、横向きでは画面が小さくなります。アプリはディスプレイのさまざまな向きを識別し、対応する必要があります。
互換性に関する一般的な問題
互換性の問題は、主にアプリの向きの制限、サイズ変更やアスペクト比の制限、カメラ プレビューの向きの誤った処理、API の誤用により発生します。
レターボックス表示
レターボックス表示にすると、アプリは画面の中央に配置されます。大画面の場合は、アクセスしやすいように片方の側に寄せて表示されます。使用されていないディスプレイ領域（アプリの側面または上下）には、マット（単色のバーまたはぼかし壁紙）が表示されます。
レターボックス表示は、大画面のデバイスでよく発生します。これは、デバイスのディスプレイの寸法やアスペクト比が、ほとんどのアプリが標準スマートフォン向けに設計されているものとは異なるためです。
図 1. アプリが縦向きに制限されているため、横向きのタブレットや折りたたみ式デバイスではレターボックス表示されます。
問題
画面の向きやアスペクト比が固定されているか、サイズ変更ができないため、アプリがすべてのディスプレイ構成をサポートしているわけではありません。
アプリの向きとサイズ変更を制御する構成設定は次のとおりです。
screenOrientation: アプリの固定の向きを指定します。アプリはActivity#setRequestedOrientation()を使用して、実行時に向きを設定することもできます。resizeableActivity: さまざまなディメンションのウィンドウに合わせてシステムがアプリのサイズを変更できるかどうかを示します。Android 11（API レベル 30）以前では、アプリがマルチ ウィンドウ モードをサポートするかどうかを指定します。Android 12（API レベル 31）以降では、アプリが小画面（画面幅 600 dp 未満）でマルチウィンドウ モードをサポートするかどうかを指定します。Android 12 以降では、この設定に関係なく、アプリは大画面（画面幅 600 dp 以上）でのマルチウィンドウ モードをサポートします。maxAspectRatio: アプリがサポートする最大アスペクト比を指定します。maxAspectRatioを設定できるのは、resizeableActivityがfalseに設定されているアプリのみです。minAspectRatio: アプリがサポートする最小アスペクト比を指定します。minAspectRatioを設定できるのは、resizeableActivityがfalseに設定されているアプリのみです。
アプリが縦向きに制限されているため、横向きのデバイスでは使用できません。
最適化
アプリは、すべてのデバイスとマルチウィンドウ モードのディスプレイの向きとサイズをサポートする必要があります。アプリのレイアウトとアプリ マニフェスト ファイルから、画面の向きと固定アスペクト比の制限をすべて削除します。
アプリはデバイスのすべての向きをサポートします。
互換性の対応策
画面の向きまたはアスペクト比が固定されているアプリが、アプリがウィンドウ サイズまたは画面の向きを直接サポートしていないウィンドウで実行される場合、Android では、継続性を維持するためにアプリがレターボックス表示されます。
Android 12（API レベル 31）以降、12L（API レベル 32）では、レターボックス表示のアプリに対してさまざまな機能強化が行われています。デバイス メーカーが UI の機能強化を実装します。この改善を活用するために、アプリを追加開発する必要はありません。
Android 12（API レベル 31）では、デバイス メーカーが設定できる以下の外観が強化されました。
- 角丸: アプリ ウィンドウの角が洗練された印象になっています。
- システムバーの透明度: アプリの上に重なるステータスバーとナビゲーション バーは半透明になり、バーのアイコンがレターボックスの背景の上に常に表示されます。
- アスペクト比の設定が可能: アプリのアスペクト比を調整して、アプリの外観を改善できます。
図 2. UI の機能が強化されたレターボックス表示のアプリ
12L（API レベル 32）では、次のような機能が改善されています。
構成可能な配置: デバイス メーカーは、大画面の場合にアプリをディスプレイの左側または右側に配置して、操作を容易にできます。
再起動ボタンのデザイン変更: デバイス メーカーは、サイズ互換モードの再起動ボタンのデザインを刷新して、ユーザーにわかりやすくすることができます。
Android 13（API レベル 33）では、レターボックス表示したアプリを画面上に配置したり、分割画面モードでレターボックス表示したりする方法について、ユーザー向けダイアログが追加されています。
図 3. ユーザー向け情報ダイアログが表示された、レターボックス表示のアプリ。
サイズ互換モード
サイズ互換モードは、再起動コントロールを含むレターボックス表示です。このコントロールにより、ユーザーはアプリを再起動してディスプレイを再描画できます。Android は、サイズ変更不可と判断されたアプリに対して、サイズ互換モードを呼び出します。アクティビティのディメンションと互換性のないディスプレイ コンテナにアクティビティが移動すると、システムはアプリを再スケーリングして、少なくとも 1 つのディメンションがデバイスのディスプレイに収まるようにすることがあります。
たとえば、次のようなデバイス設定を変更すると、サイズ互換モードがトリガーされます。
- デバイスの回転
- 折りたたみ式デバイスの折りたたみと展開
- 全画面モードと分割画面モードの切り替え
問題
通常、サイズ互換モードは、画面の向きまたはアスペクト比が制限され、サイズ変更不可に設定（またはシステムによって決定）されているアクティビティに適用されます。
次のいずれかの条件を満たすアプリは、サイズ変更可能とみなされ、サイズ互換モードにはなりません。
resizeableActivity="true"でサイズ変更が可能である- ピクチャー イン ピクチャー（PIP）モードをサポートしている
- 埋め込まれている
- アプリごとの
FORCE_RESIZE_APPオーバーライドがデバイス メーカーによって適用されている（アプリが設定したプロパティは無視されます）
アプリがいずれかの条件を満たしていない場合は、サイズ変更不可とみなされ、サイズ互換モードになる可能性があります。
マルチウィンドウ モードで、サイズ変更できないアプリがクラッシュします。
最適化
アプリはすべてのディスプレイ サイズをサポートする必要があります。アプリ マニフェストで <activity> 要素または <application> 要素の android:resizeableActivity 属性を true に設定し、アプリをサイズ変更可能にします。アプリのレスポンシブ/アダプティブ レイアウトを設計します。詳しくは、各種の画面サイズのサポートとマルチウィンドウのサポートをご覧ください。
アプリがすべてのウィンドウ サイズで動作します。
互換性の対応策
アプリを再スケーリングして少なくとも 1 つのディメンションがディスプレイ ウィンドウに収まるようにすることで、レターボックス アプリの表示を改善できるとシステムが判断した場合、Android はアプリをサイズ互換モードにします。システムは、アプリプロセスを再作成する再起動コントロールを表示し、アクティビティを再作成してディスプレイを再描画します。プロセスとスレッドの概要もご覧ください。
縦向き専用のアプリが横向きでレターボックス表示され、再起動コントロールにより再スケーリングされています。
ちらつきループ
アプリがすべてのディスプレイの向きをサポートしていない場合、構成の変更の発生時に新しい向きを繰り返しリクエストして、ディスプレイがちらつく、またはアプリが無限に回転する無限ループが生じることがあります。
問題
Android 12（API レベル 31）以降では、デバイス メーカーは、アプリが指定した画面の向きの制限を無視し、代わりにその制限を使用して互換モードを適用するようにデバイスを設定できます。たとえば、折りたたみ式デバイスは、デバイスの横向きのタブレット サイズの内部画面にアクティビティが表示される場合、アクティビティの android:screenOrientation="portrait" 設定を無視することがあります。
アプリの向きの制限が無視される場合、アプリは Activity#setRequestedOrientation() を呼び出して画面の向きをプログラムで設定できます。アプリが構成の変更を処理していない場合、この呼び出しによりアプリの再起動がトリガーされます（構成の変更を処理するをご覧ください）。再起動すると、アプリの向きの制限が再び無視され、アプリが setRequestedOrientation() の呼び出しを繰り返し、その呼び出しによってアプリの再起動がトリガーされるという自己永続ループが発生します。
また、デバイス画面の自然な向き（Android によって決定される通常の向き）が横向きである場合にも、この問題が発生することがあります。つまり、Display#getRotation() を呼び出すと、デバイスのアスペクト比が横向きであるのに、Surface.ROTATION_0 が返されます。これまで、アプリは Display.getRotation() =
Surface.ROTATION_0 がデバイスが縦向きになっていることを想定していましたが、一部の折りたたみ式デバイスのインナー ディスプレイや一部のタブレットなどでは、そうでない場合もあります。
折りたたみ式インナー ディスプレイで横向きになっているアプリは、画面の回転を確認して ROTATION_0 の値を受け取り、デバイスの自然な向きが縦向きであると想定し、setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT
) を呼び出してアプリのレイアウトを再構成します。アプリが（横向きで）再起動すると、画面の回転を再度確認し、ROTATION_0 の値を受け取り、setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT) を呼び出して、無限ループを続行する場合があります。
横向き専用のアプリを縦向きで表示すると、Activity#setRequestedOrientation() が繰り返し呼び出されます。
最適化
アプリが以下のことを行わないようにする必要があります。
- アクティビティの
onCreate()メソッドでActivity#setRequestedOrientation()を使用してデフォルトの向きを設定する。構成の未処理の変更によって画面の向きのリクエストが予期せずトリガーされる可能性があるため - デバイスの自然な向き（
ROTATION_0）が縦向きであると想定する - 現在のウィンドウ サイズに関係のないシグナル（
Display#getRotation()、FoldingFeatureの有無、非推奨 API など）に基づいて画面の向きを設定します。
アプリは構成の変更を処理し、画面の向きの制限がないため、ちらつきループに陥ることはありません。
互換性の対応策
Android は、次の状況で Activity#setRequestedOrientation() の呼び出しを無視します。
前回のメソッド呼び出しからアクティビティがすでに再起動されている、またはカメラ互換力の回転処理が有効になっている（下記のカメラ プレビューを参照）。
デバイス メーカーは、
OVERRIDE_ENABLE_COMPAT_IGNORE_REQUESTED_ORIENTATIONを使用してこの動作をアプリに適用できます。アクティビティが 1 秒間に 3 回以上画面の向きのリクエストを行った。これは、ループが発生したことを示しています。Android はループ内の 2 つのリクエストのうち、アプリの表示領域を最大化するリクエストを使用します。
デバイス メーカーは、
OVERRIDE_ENABLE_COMPAT_IGNORE_ORIENTATION_REQUEST_WHEN_LOOP_DETECTEDを使用してこの動作をアプリに適用できます。
カメラ プレビュー
タブレット、ノートパソコン、折りたたみ式ディスプレイでは、カメラアプリのカメラ プレビュー（またはビューファインダー）がずれたり、歪んだりすることがあります。
問題
Android 互換性定義ドキュメントには、カメラのイメージ センサーの向きは、「カメラの長辺と画面の長辺が一致するように向きを調整しなければならない」と記載されています。
多くの場合、アプリはデバイスの向きとカメラのセンサーの向きを縦向きと想定しますが、これは標準のスマートフォンでは妥当な想定です。ただし、タブレットやノートパソコン、およびそれらのカメラセンサーの自然な向きは横向きである可能性があります。また、折りたたみ式などの新しいフォーム ファクタでは、自然な向きが複数存在し、複数のカメラセンサーで向きが異なることがあります。
アプリが想定していないカメラの向きでアクティビティを開始したり、別のカメラやデバイス画面（折りたたみ式用）を切り替えると、カメラ プレビューの位置がずれたり、歪んだりすることがあります。
大画面の折りたたみ式デバイスで、カメラ プレビューの位置がずれたり、歪んだりします。
最適化
カメラアプリは、正しく調整、拡大縮小されたカメラ プレビューを表示するために、デバイスの向きとカメラセンサーの向きを正しく識別して管理する必要があります。アプリは、デバイスの回転、センサーの回転、画面またはウィンドウのアスペクト比を計算し、その結果をカメラ プレビューに適用する必要があります。詳しくは、カメラ プレビューとカメラのビューファインダーのご紹介をご覧ください。
デバイスのすべての向きで、カメラ プレビューが正しく調整され、拡大縮小されます。
互換性の対応策
Display#getRotation() が Surface.ROTATION_0 を返す場合、デバイスは自然な向きです。システムはデバイスの自然な向きから CameraCharacteristics.SENSOR_ORIENTATION を計算します。Android は、縦向き限定のアプリの縦向きウィンドウを、デバイスの自然な向きに合わせます。ほとんどのアプリが想定しています。また、センサーの向きが横向きで、カメラ プレビューが縦向きの場合は、カメラセンサーの画像を切り抜きます。具体的な回避策は次のとおりです。
縦向き限定のアプリでカメラ プレビューを強制的に回転する: 縦向きに制限されているアプリでは、デバイスの自然な向きとカメラセンサーの向きが縦向きであることを前提としています。ただし、Android 12（API レベル 31）以降では、デバイス メーカーが画面の向きの指定を無視した場合、複数のデバイスの向きでアプリを実行できます。
縦向き限定のアプリがカメラに接続されている場合、Android はアプリを強制的に回転させ、アプリの縦向きのウィンドウをデバイスの自然な向きに合わせます。
一部のタブレット（参照デバイスを参照）では、デバイスの自然な向きに合わせて、アプリの縦向きのウィンドウが回転し、縦向きの全画面表示になります。アプリは強制回転後に全画面表示されます。
タブレット - 縦向き限定のアプリが強制的に回転されます。
折りたたみ式デバイスの横向きのインナー画面（リファレンス デバイスを参照）では、開いた状態の自然な向きに合わせて、縦向き専用のアクティビティが横向きに回転します。強制回転後、アプリはレターボックス表示されます。
折りたたみ式 - 縦向き限定のアプリが強制的に回転されます。また、アプリはレターボックス表示されます。
内部の前面カメラの切り抜き: 一部の折りたたみ式デバイスでは、内部の前面カメラセンサーが横向きになっています。Android は、折りたたみ式インナー ディスプレイでカメラ プレビューを強制的に回転させるだけでなく、インナーフロント（横向き）カメラの画角を切り抜いて、センサーがデバイスの向きとは反対のビューをキャプチャできるようにします。
カメラ プレビューの強制更新: 強制回転の後、システムはアクティビティ メソッド
onStop()とonStart()（デフォルト）、またはonPause()とonResume()（アプリごとの OVERRIDE_CAMERA_COMPAT_ENABLE_REFRESH_VIA_PAUSE オーバーライドにより適用）を順繰りに表示して、カメラ プレビューが正しく表示されるようにします。アスペクト比のスケーリング: 強制回転されたカメラ プレビューのアスペクト比が、高い最小アスペクト比に動的に変更されます。これにより、カメラ プレビューが適切にスケーリングされます。
アプリがカメラ プレビューを正しく処理していれば、アプリ デベロッパーはこれらの回避策をオーバーライドできます。アプリごとのオーバーライドをご覧ください。
よく誤用される API
Android でマルチウィンドウ モードなどの機能や折りたたみ式デバイスなどのデバイスのサポートが追加されたため、以前の API は非推奨になり、すべてのディスプレイ サイズとデバイス フォーム ファクタで動作する最新の API に置き換えられました。ただし、下位互換性のために、非推奨の API も引き続き使用できます。
一部の View API は、デベロッパーが十分に理解していない特別な目的のために設計されています。
問題
デベロッパーは非推奨の Display API を引き続き使用し、API がデバイスの表示領域の境界ではなくアプリの境界を返すものと誤って想定します。また、デベロッパーが一般的なディスプレイの指標を取得するために、誤って特別な用途の View API を使用することもあります。その結果、アプリ ウィンドウのサイズ変更イベント後に UI 要素を再配置すると計算が不正確になり、レイアウトの問題が発生します。
非推奨でよく誤用される Display API:
詳しくは、マルチウィンドウのサポートをご覧ください。
誤用される View API:
非推奨の API がアプリの境界を誤って計算し、アプリのコンテンツが画面外に出てしまいます。
最適化
UI 要素の配置に、物理的なディスプレイ サイズを使用しないでください。WindowMetrics に基づいて、次の WindowManager API などの API にアプリを移行します。
プラットフォーム:
Jetpack:
API はアプリ ウィンドウの指標を正しく計算します。
互換性の対応策
2 つのオーバーライドは、非推奨の Display API と誤用された View API を調整して、アプリの境界を返すようにしました（Display API の ALWAYS_SANDBOX_DISPLAY_APIS と、View API の OVERRIDE_SANDBOX_VIEW_BOUNDS_APIS）。ALWAYS_SANDBOX_DISPLAY_APIS は、サイズ互換モードの対象となるアプリにもデフォルトで適用されます。
透明アクティビティ
透明アクティビティは、透明な背景スタイルの結果です。以下に例を示します。
<style name="Transparent" parent="AppTheme">
<item name="android:windowIsTranslucent">true</item>
<item name="android:windowBackground">@android:color/transparent</item>
</style>
Theme.MaterialComponents.Dialog などのダイアログに関連するテーマには、アクティビティを透明にするスタイルを含めることができます。
透明アクティビティは、使用可能なディスプレイ領域をすべてカバーしているわけではなく、使用可能なディスプレイ領域がデバイスの回転、デバイスの折りたたみと展開、マルチ ウィンドウ モードなどの構成変更によって変わる可能性があるため、管理が難しくなります。
問題
透明アクティビティは、タスク アクティビティ スタック内で、透明アクティビティの下にある最初の不透明アクティビティの境界に従う必要があります。ただし、権限ダイアログを起動する不透明アクティビティは、トランポリン（別のアクティビティを起動した後、消えるアクティビティ）となる場合があるため、システムは透過的な権限ダイアログ アクティビティを起動したトランポリン アクティビティの境界を決定できません。
アクティビティがトランポリンから起動されたため、ダイアログの位置がずれています。
最適化
透明アクティビティは、タスクのアクティビティ スタック内で、その下にある不透明アクティビティのうち最上位のものから制約を継承します。不透明アクティビティは、アクティビティの作成から破棄まで、透明アクティビティのライフサイクル全体で使用できるようにする必要があります。このため、トランポリン アクティビティから権限リクエストを開始しないでください。
トランポリン アクティビティが権限リクエストを起動した場合、ユーザーに権限ダイアログが表示されないことがあります。これは、ユーザーがダイアログに応答する前にトランポリン アクティビティが破棄され、ダイアログ アクティビティのディメンションと位置が正しく計算されていない可能性があるためです。
アプリは常に、ユーザーが権限に関する決定を行うまで表示されたままの状態になっているアクティビティから権限リクエストを開始する必要があります。
角丸
スタイルが背景の透明度を指定する場合、またはアクティビティのコンテンツが使用可能なディスプレイ領域を埋めない場合、アクティビティを透明にできます。透明なアクティビティが使用可能なディスプレイ領域を埋める場合、デバイス メーカーによる設定時に、システムにより角丸がアクティビティに自動的に適用されます。ただし、使用可能なスペースが透明なアクティビティ（権限ダイアログなど）で埋められない場合は、角を丸くするかどうかを決める必要があります。
使用可能なディスプレイ領域を権限ダイアログが埋めることはありません。ダイアログのレイアウトでは通常、LayoutParams.MATCH_PARENT ではなく LayoutParams.WRAP_CONTENT を使用するためです。
表示される起動アクティビティの上に角の丸みが正しく配置されたダイアログ。
互換性の対応策
ユーザーがダイアログに応答するまで、ダイアログ アクティビティを起動するアクティビティを表示したままにする。
システムにより、透明アクティビティは、アクティビティ スタック内で透明アクティビティの下にある最初の不透明アクティビティから、以下に関連する制約を含むすべての制約を継承するようにします。
- サイズ互換モード
- 向き
- アスペクト比
Unity ゲーム
Unity ゲームは Android 全画面モードまたはマルチウィンドウ モードで動作します。ただし、アプリがマルチウィンドウ モードになると、多くの Unity ゲームはフォーカスを喪失し、コンテンツの描画を停止します。
問題
Unity は Unity 2019.4 に Resizable Window オプションを追加し、Android でマルチウィンドウ モードをサポートしました。しかし、初期実装はマルチウィンドウ モードでのアクティビティのライフサイクルに正しく反応せず、アプリがフォーカスを失ったときに UnityPlayer が再生を一時停止していました。プレーヤーにより、黒い画面、またはゲームの最後のフリーズしたフレームがレンダリングされました。ゲームプレイは、ユーザーが画面をタップした場合にのみ再開されます。Unity エンジンを使用する多くのアプリでこの問題に直面し、マルチウィンドウ モードでは黒いウィンドウとしてレンダリングされます。
ゲームがマルチウィンドウ モードでフォーカスを喪失し、黒いウィンドウとしてレンダリングされます。
最適化
Unity を 2019.4.40 以降にアップグレードして、ゲームを再エクスポートします。Android Player 設定で Resizable Window オプションをオンのままにしておきます。そうしないと、ゲームがマルチウィンドウ モードで完全に表示されている場合でも、フォーカスされていないときはゲームが一時停止します。
フォーカスされていない場合でも、ゲームがマルチウィンドウ モードでコンテンツを正しくレンダリングします。
互換性の対応策
デバイス メーカーは、アプリごとの OVERRIDE_ENABLE_COMPAT_FAKE_FOCUS オーバーライドを適用して、マルチウィンドウ モードでアプリに疑似フォーカス イベントを提供できます。オーバーライドすると、アクティビティはコンテンツを再描画できるようになり、ブラックアウトされなくなります。
互換性の問題がないかアプリをテストする
アプリをテストして、さまざまなフォーム ファクタでどのように動作するかを確認するには、次のリソースを活用します。
- デバイス ストリーミング: Google データセンターでホストされている本番環境デバイス（参照デバイスを含む）でアプリをテストするには、Firebase による Android デバイス ストリーミング をご覧ください。
- Android Studio Hedgehog のエミュレータ: 参照デバイス用のエミュレータを作成する方法については、仮想デバイスの作成と管理をご覧ください。
- Android Studio のサイズ変更可能なエミュレータ: 仮想デバイスへのアクセスについては、Android Emulator 上でアプリを実行するをご覧ください。
レターボックス表示になっているか
各アクティビティが、アプリで使用可能なディスプレイ領域をすべて使用できることを確認してください。まず、テストフォルダで次のコードを宣言します。
Kotlin
fun Activity.isLetterboxed() : Boolean {
if (isInMultiWindowMode) return false
val wmc = WindowMetricsCalculator.getOrCreate()
val currentBounds = wmc.computeCurrentWindowMetrics(this).bounds
val maxBounds = wmc.computeMaximumWindowMetrics(this).bounds
val isScreenPortrait = maxBounds.height() > maxBounds.width()
return if (isScreenPortrait) {
currentBounds.height() < maxBounds.height()
} else {
currentBounds.width() < maxBounds.width()
}
}
Java
public boolean isLetterboxed(Activity activity) {
if (activity.isInMultiWindowMode()) {
return false;
}
WindowMetricsCalculator wmc = WindowMetricsCalculator.getOrCreate();
Rect currentBounds = wmc.computeCurrentWindowMetrics(activity).getBounds()
Rect maxBounds = wmc.computeMaximumWindowMetrics(activity).getBounds();
boolean isScreenPortrait = maxBounds.height() > maxBounds.width();
return (isScreenPortrait)
? currentBounds.height() < maxBounds.height()
: currentBounds.width() < maxBounds.width();
}
次に、テストを実行して動作をアサートし、ターゲット アクティビティがレターボックス表示されていないことを確認します。
Kotlin
@get:Rule
val activityRule = ActivityScenarioRule(MainActivity::class.java)
@Test
fun activity_launched_notLetterBoxed() {
activityRule.scenario.onActivity {
assertThat(it.isLetterboxed()).isFalse()
}
}
Java
@Rule
public ActivityScenarioRule<MainActivity> rule = new ActivityScenarioRule<>(MainActivity.class);
public void activity_launched_notLetterBoxed() {
try (ActivityScenario<MainActivity> scenario = ActivityScenario.launch(MainActivity.class)) {
scenario.onActivity(activity -> {
assertThat(isLetterboxed(activity)).isFalse();
});
}
}
理想的には、この種のテストは合格するまで実行し、アプリのアクティビティがアプリで使用可能なディスプレイ領域全体を占有していることをアサートします。すべてのデバイスタイプでアプリをテストして、動作が一貫していることを確認します。
アプリごとのオーバーライド
Android には、アプリの構成済み動作を変更するオーバーライドが用意されています。たとえば、FORCE_RESIZE_APP オーバーライドは、アプリ マニフェストで resizeableActivity="false" が指定されている場合でも、サイズ互換モードをバイパスし、ディスプレイ サイズに合わせてアプリのサイズを変更するようシステムに指示します。
デバイス メーカーは、特定の大画面デバイス上の一部のアプリまたはすべてのアプリにオーバーライドを適用します。Android 14（API レベル 34）以降では、ユーザーはデバイスの設定からアプリにオーバーライドを適用できます。
アプリごとのユーザー オーバーライド
Android 14 以降では、ユーザーが設定メニューでアプリのアスペクト比を変更できます。参照デバイスなどの大画面デバイスでは、メニューを実装します。
メニューには、デバイスにインストールされているすべてのアプリのリストが表示されます。ユーザーはアプリを選択し、アプリのアスペクト比を 3:4、1:1、全画面など、デバイスのメーカーが設定した値に設定します。ユーザーは、アプリ マニフェストで指定されているアプリのデフォルトにアスペクト比をリセットすることもできます。
アプリで次の PackageManager.Property タグを設定すると、互換性のオーバーライドをオプトアウトできます。
PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE
ユーザー アスペクト比の互換性のオーバーライドをオプトアウトするには、このプロパティをアプリ マニフェストに追加し、値を
falseに設定します。<application> <property android:name="android.window. PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE" android:value="false" /> </application>アプリは、デバイスの設定でアプリのリストから除外されます。ユーザーはアプリのアスペクト比をオーバーライドできません。
このプロパティを
trueに設定しても効果はありません。PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE
ユーザー アスペクト比の互換性のオーバーライドの全画面オプションを無効にするには、このプロパティをアプリ マニフェストに追加し、値を
falseに設定します。<application> <property android:name="android.window.PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE" android:value="false" /> </application>全画面オプションが、デバイス設定のアスペクト比オプションのリストから削除されます。ユーザーはアプリに全画面表示のオーバーライドを適用できません。
このプロパティを
trueに設定しても効果はありません。
すべての画面向けにアプリを最適化する: アプリにアスペクト比の制限を設定しないでください。ウィンドウ サイズクラスを使用して、利用可能な表示スペースの大きさに基づいてさまざまなレイアウトをサポートします。
デバイス メーカーによるアプリごとのオーバーライド
デバイス メーカーは、一部のデバイスでアプリごとにオーバーライドを適用します。参照デバイスはデフォルトで一部のオーバーライドをさまざまなアプリに適用できます。
アプリはほとんどのオーバーライドをオプトアウトできます（下記のアプリごとのオーバーライドの表をご覧ください）。
互換性フレームワークを使用すると、オーバーライドを有効または無効にしてアプリをテストできます（互換性フレームワーク ツールをご覧ください）。有効にすると、オーバーライドがアプリ全体に適用されます。
Android Debug Bridge（adb）を使用して、オーバーライドを有効または無効にし、アプリに適用するオーバーライドを確認することもできます。
オーバーライドを有効または無効にする方法は次のとおりです。
adb shell am compat enable/disable <override name/id> <package>
参照デバイスについて、アプリに適用されるオーバーライドを確認します。
adb shell dumpsys platform_compat | grep <package name>
次の表に、使用可能なオーバーライドと、アプリがオーバーライドに依存する必要がないようにアプリを最適化する方法のガイダンスを示します。一部のオーバーライドをオプトアウトするには、アプリ マニフェストにプロパティ フラグを追加します。
| アプリごとのオーバーライド | |||
|---|---|---|---|
| 種類 | 名前 | ID | 説明 |
| サイズ変更 | FORCE_RESIZE_APP | 174042936 | 構成変更時にアプリのサイズ互換モードをバイパスします。 |
| FORCE_NON_RESIZE_APP | 181136395 | 構成を変更するとアプリを強制的にサイズ互換モードにします。 | |
| アスペクト比 | OVERRIDE_MIN_ASPECT_RATIO | 174042980 | 他のアスペクト比のオーバーライドを適用するには、ゲートキーパーのオーバーライドを有効にする必要があります。 |
| OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY | 203647190 | 有効（デフォルト）に設定した場合、スコープが縦向き限定のアクティビティにオーバーライドされます。 | |
| OVERRIDE_MIN_ASPECT_RATIO_MEDIUM | 180326845 | 最小アスペクト比を 3:2 に変更します。 | |
| OVERRIDE_MIN_ASPECT_RATIO_LARGE | 180326787 | 最小アスペクト比を 16:9 に変更します。 | |
| OVERRIDE_MIN_ASPECT_RATIO_TO_ALIGN_WITH_SPLIT_SCREEN | 208648326 | 最小アスペクト比をディスプレイ サイズの 50%（分割画面のアスペクト比）に変更します。 | |
| OVERRIDE_MIN_ASPECT_RATIO_EXCLUDE_PORTRAIT_FULLSCREEN | 218959984 | 最小アスペクト比のオーバーライドを無効にし、デバイスが縦向きのときにアプリが全画面表示されるようにします。 | |
| 向き | OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT | 265452344 | アクティビティの向きが未定義の場合、向きが縦向きになるようにオーバーライドします。 |
| OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR | 265451093 | アクティビティの向きが未定義の場合、向きを nosensor（デバイスの自然な向きを使用）にオーバーライドします。 |
|
| OVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE | 266124927 | 横向き限定のアプリを 180 度回転します。 | |
| OVERRIDE_ANY_ORIENTATION | 265464455 | 任意の向きのオーバーライドを有効にします。 | |
| OVERRIDE_ORIENTATION_ONLY_FOR_CAMERA | 265456536 | 向きのオーバーライドのスコープを、アプリがカメラに接続している場合に限定します。 | |
| OVERRIDE_USE_DISPLAY_LANDSCAPE_NATURAL_ORIENTATION | 255940284 | タスクが全画面表示の場合（レターボックス表示の場合も含む）に、ディスプレイを自然な横向きで固定します。 | |
| OVERRIDE_ENABLE_COMPAT_IGNORE_REQUESTED_ORIENTATION | 254631730 | 回転の無限ループを避けるため、アプリからの向きのリクエストは無視されます。 | |
| OVERRIDE_ENABLE_COMPAT_IGNORE_ORIENTATION_REQUEST_WHEN_LOOP_DETECTED | 273509367 | アクティビティが再起動されている間、向きのリクエストの繰り返しを無視します。アプリが 1 秒以内に 2 つ以上の新しい画面の向きをリクエストしていることを Android が検出した場合、システムはこれを回転無限ループとみなし、オーバーライドを適用します。 | |
| OVERRIDE_RESPECT_REQUESTED_ORIENTATION | 236283604 | デバイス メーカーが画面の向きのリクエストを無視する設定を無効にすることで、レターボックス表示されないようにします。 | |
| サンドボックス API | NEVER_SANDBOX_DISPLAY_APIS | 184838306 | Display API の動作が変更されないようにします。 |
| ALWAYS_SANDBOX_DISPLAY_APIS | 185004937 | アプリ内の Display API が強制的にアプリの境界を返すようにします。Display API は論理ディスプレイ領域の境界を返しますが、場合によっては、Display API がアプリの境界を返すものとアプリが想定するため、UI の問題が発生することがあります。 |
|
| OVERRIDE_SANDBOX_VIEW_BOUNDS_APIS | 237531167 | アプリで使用される View API が強制的にアプリの境界を返すようにします。View API は論理ディスプレイ領域の境界を返しますが、場合によっては、View API がアプリの境界を返すものとアプリが想定するため、UI の問題が発生することがあります。 |
|
| カメラ互換性 | OVERRIDE_CAMERA_COMPAT_DISABLE_FORCE_ROTATION | 263959004 | 強制回転をオフにします。デフォルトでは、カメラ プレビューが開いているときに、向きが固定されているすべてのカメラアプリが強制的に回転します。 |
| OVERRIDE_CAMERA_COMPAT_DISABLE_REFRESH | 264304459 | カメラ プレビューが強制回転されたときに適用されるデフォルトのハード更新を削除します。 | |
| OVERRIDE_CAMERA_COMPAT_ENABLE_REFRESH_VIA_PAUSE | 264301586 | カメラ プレビューが強制的に回転されると、ハード更新がソフト更新に切り替わります。これにより、強制回転中の状態を保持できます。デフォルトでは、カメラ プレビューが強制的に回転されると、Android はハード更新を適用します。ハード更新を行うと、アプリが以前の状態をキャッシュに保存する方法によっては、アプリの状態が失われたり、停止したりする問題が発生することがあります。 | |
| OVERRIDE_CAMERA_LANDSCAPE_TO_PORTRAIT | 250678880 | 内部の前面カメラの画像バッファを切り抜きます。オーバーライドを無効にすると、内部の前面カメラの切り抜きが解除され、カメラ プレビューの画角が広がります。一部の折りたたみ式デバイス（参照デバイスを参照）では、インナーの前面カメラを使用している場合、デフォルトですべてのカメラアプリのカメラ プレビューが切り抜かれます。 | |
| その他 | OVERRIDE_ENABLE_COMPAT_FAKE_FOCUS | 263259275 | 分割画面モードでアプリがフォーカスを喪失したときにアプリが黒く表示されないようにします。アプリは、フォーカスされてから、アプリのコンテンツを描画します。そのため、アプリはフリーズしたり、黒く表示されることがあります。このオーバーライドにより、Android はアプリに偽のフォーカス イベントを送信して、アプリにコンテンツの描画を再開するようシグナルを送ることができます。 |
FORCE_RESIZE_APP
オーバーライドが適用されるパッケージを強制的にサイズ変更可能にします。アプリをマルチウィンドウ モードにできるかどうかは変更されませんが、画面のサイズ変更時にサイズ互換モードに入らずにアプリのサイズを変更できるようになります。
アプリでオーバーライドと同じ結果を得る方法
アプリ マニフェストで、android:resizeableActivity 属性を true に設定するか、android:resizeableActivity=false でマルチウィンドウ モードを無効にしながらサイズ変更をサポートするには、android.supports_size_changes メタデータ フラグを true に設定します。
アプリを最適化する方法
レスポンシブ/アダプティブ レイアウトを使用して、アプリがすべてのディスプレイ サイズとアスペクト比に適応できるようにします。各種の画面サイズのサポートをご覧ください。
オーバーライドを無効化またはオプトアウトする方法
プロパティ フラグ PROPERTY_COMPAT_ALLOW_RESIZEABLE_ACTIVITY_OVERRIDES を false に設定します。
オーバーライドを調整するプロパティ フラグ
<property android:name="android.window.PROPERTY_COMPAT_ALLOW_RESIZEABLE_ACTIVITY_OVERRIDES"
android:value="true|false"/>
オーバーライドをテストする adb コマンド
オーバーライドを適用してアプリのサイズを変更可能にするには:
adb shell am compat enable FORCE_RESIZE_APP <package>
オーバーライドを削除するには:
adb shell am compat disable FORCE_RESIZE_APP <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
FORCE_NON_RESIZE_APP
オーバーライドが適用されるパッケージを強制的にサイズ変更不可にして、構成変更時にサイズ互換モードになります。
アプリでオーバーライドと同じ結果を得る方法
アプリ マニフェストで android:resizeableActivity 属性と android.supports_size_changes メタデータ フラグの両方を false に設定し、向きまたはアスペクト比の制限を宣言します。
アプリを最適化する方法
サイズ変更時に正常に動作するすべてのアプリでは、android:resizeableActivity または android.supports_size_changes を true に設定する必要があります。それ以外のアプリは、サイズ変更時に適切に動作するように改善する必要があります。android:resizeableActivity をご覧ください。
オーバーライドを無効化またはオプトアウトする方法
プロパティ フラグ PROPERTY_COMPAT_ALLOW_RESIZEABLE_ACTIVITY_OVERRIDES を false に設定します。
オーバーライドを調整するプロパティ フラグ
<property android:name="android.window.PROPERTY_COMPAT_ALLOW_RESIZEABLE_ACTIVITY_OVERRIDES"
android:value="true|false"/>
オーバーライドをテストする adb コマンド
オーバーライドを適用してアプリのサイズを変更できないようにするには:
adb shell am compat enable FORCE_NON_RESIZE_APP <package>
オーバーライドを削除するには:
adb shell am compat disable FORCE_NON_RESIZE_APP <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_MIN_ASPECT_RATIO
指定された最小アスペクト比を強制的に適用するすべてのオーバーライドのゲートキーパー。
アプリでオーバーライドと同じ結果を得る方法
android:minAspectRatio をアクティビティ単位またはアプリ単位で設定します。
アプリを最適化する方法
アプリにアスペクト比の制限を設定しないでください。アプリがさまざまな画面サイズをサポートしていることを確認してください。ウィンドウ サイズクラスを使用すると、アプリの画面上のスペースの大きさに基づいてさまざまなレイアウトをサポートできます。Compose WindowSizeClass API と WindowSizeClass API の表示をご覧ください。
オーバーライドを無効化またはオプトアウトする方法
アスペクト比の制限を指定するか、プロパティ フラグ PROPERTY_COMPAT_ALLOW_MIN_ASPECT_RATIO_OVERRIDE を false に設定します。
オーバーライドを調整するプロパティ フラグ
<property android:name="android.window.PROPERTY_COMPAT_ALLOW_MIN_ASPECT_RATIO_OVERRIDE"
android:value="false"/>
オーバーライドをテストする adb コマンド
オーバーライドを適用するには:
adb shell am compat enable OVERRIDE_MIN_ASPECT_RATIO <package>
オーバーライドを削除するには:
adb shell am compat disable OVERRIDE_MIN_ASPECT_RATIO <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY
縦向き限定のアクティビティに対して、指定された最小アスペクト比を強制するアプリの設定を制限します。デフォルトで有効になっており、OVERRIDE_MIN_ASPECT_RATIO も有効になっている場合にのみ有効になります。
アプリでオーバーライドと同じ結果を得る方法
OVERRIDE_MIN_ASPECT_RATIO をご覧ください。
アプリを最適化する方法
OVERRIDE_MIN_ASPECT_RATIO をご覧ください。
オーバーライドを無効化またはオプトアウトする方法
OVERRIDE_MIN_ASPECT_RATIO をご覧ください。
オーバーライドを調整するプロパティ フラグ
OVERRIDE_MIN_ASPECT_RATIO をご覧ください。
オーバーライドをテストする adb コマンド
オーバーライドを適用するには:
adb shell am compat enable OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY <package>
オーバーライドを削除するには:
adb shell am compat disable OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_MIN_ASPECT_RATIO_MEDIUM
アクティビティの最小アスペクト比を中程度の値（3:2）に設定します。
アプリでオーバーライドと同じ結果を得る方法
OVERRIDE_MIN_ASPECT_RATIO をご覧ください。
アプリを最適化する方法
OVERRIDE_MIN_ASPECT_RATIO をご覧ください。
オーバーライドを無効化またはオプトアウトする方法
OVERRIDE_MIN_ASPECT_RATIO をご覧ください。
オーバーライドを調整するプロパティ フラグ
OVERRIDE_MIN_ASPECT_RATIO をご覧ください。
オーバーライドをテストする adb コマンド
オーバーライドを適用するには:
adb shell am compat enable OVERRIDE_MIN_ASPECT_RATIO_MEDIUM <package>
オーバーライドを削除するには:
adb shell am compat disable OVERRIDE_MIN_ASPECT_RATIO_MEDIUM <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_MIN_ASPECT_RATIO_LARGE
アクティビティの最小アスペクト比を大きな値（16:9）に設定します
アプリでオーバーライドと同じ結果を得る方法
OVERRIDE_MIN_ASPECT_RATIO をご覧ください。
アプリを最適化する方法
OVERRIDE_MIN_ASPECT_RATIO をご覧ください。
オーバーライドを無効化またはオプトアウトする方法
OVERRIDE_MIN_ASPECT_RATIO をご覧ください。
オーバーライドを調整するプロパティ フラグ
OVERRIDE_MIN_ASPECT_RATIO をご覧ください。
オーバーライドをテストする adb コマンド
オーバーライドを適用するには:
adb shell am compat enable OVERRIDE_MIN_ASPECT_RATIO_LARGE <package>
オーバーライドを削除するには:
adb shell am compat disable OVERRIDE_MIN_ASPECT_RATIO_LARGE <package>`
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_MIN_ASPECT_RATIO_TO_ALIGN_WITH_SPLIT_SCREEN
分割画面のアスペクト比の使用を有効にします。レターボックス表示を回避して、分割画面モードで使用可能なすべてのスペースを使用することをアプリに許可します。
アプリでオーバーライドと同じ結果を得る方法
OVERRIDE_MIN_ASPECT_RATIO をご覧ください。
アプリを最適化する方法
OVERRIDE_MIN_ASPECT_RATIO をご覧ください。
オーバーライドを無効化またはオプトアウトする方法
OVERRIDE_MIN_ASPECT_RATIO をご覧ください。
オーバーライドを調整するプロパティ フラグ
OVERRIDE_MIN_ASPECT_RATIO をご覧ください。
オーバーライドをテストする adb コマンド
オーバーライドを適用するには:
adb shell am compat enable OVERRIDE_MIN_ASPECT_RATIO_TO_ALIGN_WITH_SPLIT_SCREEN <package>
オーバーライドを削除するには:
adb shell am compat disable OVERRIDE_MIN_ASPECT_RATIO_TO_ALIGN_WITH_SPLIT_SCREEN <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_MIN_ASPECT_RATIO_EXCLUDE_PORTRAIT_FULLSCREEN
使用可能なすべての画面スペースを使用するには、縦向きの全画面表示の最小アスペクト比のオーバーライドを無効にします。
アプリでオーバーライドと同じ結果を得る方法
OVERRIDE_MIN_ASPECT_RATIO をご覧ください。
アプリを最適化する方法
OVERRIDE_MIN_ASPECT_RATIO をご覧ください。
オーバーライドを無効化またはオプトアウトする方法
OVERRIDE_MIN_ASPECT_RATIO をご覧ください。
オーバーライドを調整するプロパティ フラグ
OVERRIDE_MIN_ASPECT_RATIO をご覧ください。
オーバーライドをテストする adb コマンド
オーバーライドを適用するには:
adb shell am compat enable OVERRIDE_MIN_ASPECT_RATIO_EXCLUDE_PORTRAIT_FULLSCREEN <package>
オーバーライドを削除するには:
adb shell am compat disable OVERRIDE_MIN_ASPECT_RATIO_EXCLUDE_PORTRAIT_FULLSCREEN <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT
パッケージ内のすべてのアクティビティに対して縦向きを有効にします。OVERRIDE_ANY_ORIENTATION が有効になっていない限り、オーバーライドはアクティビティで他の固定の向きが指定されていない場合のみ使用されます。
アプリでオーバーライドと同じ結果を得る方法
activity:screenOrientation マニフェスト属性を設定するか、Activity#setRequestedOrientation() API を使用します。
アプリを最適化する方法
アプリはすべての画面の向きをサポートする必要があります。画面の向きの変更は構成変更であり、システムにアプリの破棄と再作成を行うか、自分で構成変更を管理するかの 2 つの方法があります。構成の変更を自分で管理する場合は、ViewModel を使用してアプリの状態を保持できます。ごくまれに、小さいディスプレイでのみ画面の向きをロックすることもできますが、その場合は、ユーザーが必要に応じてアプリを回転させる場合と比べてスケーリングが妨げられる可能性があります。Android 12L 以降では、固定の画面の向きをデバイス設定でオーバーライドできます。構成変更の処理とすべての画面の向きのサポートについて詳しくは、構成の変更を処理する、ViewModel の概要、スマートフォンではアプリの向きが制限されるが、大画面デバイスでは制限されないをご覧ください。
オーバーライドを無効化またはオプトアウトする方法
プロパティ フラグ PROPERTY_COMPAT_ALLOW_ORIENTATION_OVERRIDE を false に設定します。
オーバーライドを調整するプロパティ フラグ
<property android:name="android.window.PROPERTY_COMPAT_ALLOW_ORIENTATION_OVERRIDE"
android:value="true|false"/>
オーバーライドをテストする adb コマンド
オーバーライドを適用するには:
adb shell am compat enable OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT <package>
オーバーライドを削除するには:
adb shell am compat disable OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR
パッケージ内のすべてのアクティビティに対して nosensor の向きを有効にします。OVERRIDE_ANY_ORIENTATION が有効になっていない限り、オーバーライドはアクティビティで他の固定の向きが指定されていない場合のみ使用されます。
アプリでオーバーライドと同じ結果を得る方法
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。
アプリを最適化する方法
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。
オーバーライドを無効化またはオプトアウトする方法
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。
オーバーライドを調整するプロパティ フラグ
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。```
オーバーライドをテストする adb コマンド
オーバーライドを適用するには:
adb shell am compat enable OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR <package>
オーバーライドを削除するには:
adb shell am compat disable OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE
パッケージ内のすべてのアクティビティに対して reverseLandscape の向きを有効にします。OVERRIDE_ANY_ORIENTATION が有効になっていない限り、オーバーライドはアクティビティで他の固定の向きが指定されていない場合のみ使用されます。
アプリでオーバーライドと同じ結果を得る方法
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。
アプリを最適化する方法
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。
オーバーライドを無効化またはオプトアウトする方法
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。
オーバーライドを調整するプロパティ フラグ
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。
オーバーライドをテストする adb コマンド
オーバーライドを適用するには:
adb shell am compat enable OVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE <package>
オーバーライドを削除するには:
adb shell am compat disable OVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_ANY_ORIENTATION
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT、OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR、OVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE の各オーバーライドにより、すべての向きをオーバーライドできます。
アプリでオーバーライドと同じ結果を得る方法
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。
アプリを最適化する方法
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。
オーバーライドを無効化またはオプトアウトする方法
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。
オーバーライドを調整するプロパティ フラグ
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。
オーバーライドをテストする adb コマンド
オーバーライドを適用するには:
adb shell am compat enable OVERRIDE_ANY_ORIENTATION <package>
オーバーライドを削除するには:
adb shell am compat disable OVERRIDE_ANY_ORIENTATION <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_ORIENTATION_ONLY_FOR_CAMERA
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT、OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR、OVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE の各オーバーライドが、カメラ接続がアクティブな場合にのみ有効になるよう制限します。
アプリでオーバーライドと同じ結果を得る方法
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。
アプリを最適化する方法
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。
オーバーライドを無効化またはオプトアウトする方法
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。
オーバーライドを調整するプロパティ フラグ
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。
オーバーライドをテストする adb コマンド
オーバーライドを適用するには:
adb shell am compat enable OVERRIDE_ORIENTATION_ONLY_FOR_CAMERA <package>
オーバーライドを削除するには:
adb shell am compat disable OVERRIDE_ORIENTATION_ONLY_FOR_CAMERA <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_USE_DISPLAY_LANDSCAPE_NATURAL_ORIENTATION
次の条件を満たす場合、ディスプレイの向きを自然な横向きに制限します。
- アクティビティが全画面表示である
- オプトアウト コンポーネント プロパティ
PROPERTY_COMPAT_ALLOW_DISPLAY_ORIENTATION_OVERRIDEが有効になっていない - ディスプレイでデバイス メーカーの画面の向きのリクエストを無視する設定が有効になっている
- ディスプレイの自然な向きが横向きである
アプリでオーバーライドと同じ結果を得る方法
該当なし。この問題はアプリケーション ロジックで解決する必要があります。
アプリを最適化する方法
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。
オーバーライドを無効化またはオプトアウトする方法
プロパティ フラグ PROPERTY_COMPAT_ALLOW_DISPLAY_ORIENTATION_OVERRIDE を false に設定します。
オーバーライドを調整するプロパティ フラグ
<property android:name="android.window.PROPERTY_COMPAT_ALLOW_DISPLAY_ORIENTATION_OVERRIDE"
android:value="true|false"/>
オーバーライドをテストする adb コマンド
オーバーライドを適用するには:
adb shell am compat enable OVERRIDE_USE_DISPLAY_LANDSCAPE_NATURAL_ORIENTATION <package>
オーバーライドを削除するには:
adb shell am compat disable OVERRIDE_USE_DISPLAY_LANDSCAPE_NATURAL_ORIENTATION <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_ENABLE_COMPAT_IGNORE_REQUESTED_ORIENTATION
アプリの再起動時またはアクティブなカメラ互換処理がある場合に、アプリが Activity#setRequestedOrientation() を呼び出したときにアプリの向きの更新をスキップする互換性ポリシーを有効にします。
アプリでオーバーライドと同じ結果を得る方法
プロパティ フラグ PROPERTY_COMPAT_IGNORE_REQUESTED_ORIENTATION を true に設定します。
アプリを最適化する方法
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。
オーバーライドを無効化またはオプトアウトする方法
プロパティ フラグ PROPERTY_COMPAT_IGNORE_REQUESTED_ORIENTATION を false に設定します。
オーバーライドを調整するプロパティ フラグ
<property android:name="android.window.PROPERTY_COMPAT_IGNORE_REQUESTED_ORIENTATION"
android:value="true|false"/>
オーバーライドをテストする adb コマンド
オーバーライドを適用するには:
adb shell am compat enable OVERRIDE_ENABLE_COMPAT_IGNORE_REQUESTED_ORIENTATION <package>
オーバーライドを削除するには:
adb shell am compat disable OVERRIDE_ENABLE_COMPAT_IGNORE_REQUESTED_ORIENTATION <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_ENABLE_COMPAT_IGNORE_ORIENTATION_REQUEST_WHEN_LOOP_DETECTED
アクティビティが固定の向きに対してレターボックス表示されていない場合に、アプリが 1 秒間に 3 回以上 Activity#setRequestedOrientation() を呼び出した場合にアプリがリクエストした向きを無視する互換性ポリシーを有効にします。
アプリでオーバーライドと同じ結果を得る方法
該当なし。この問題はアプリケーション ロジックで解決する必要があります。
アプリを最適化する方法
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。
オーバーライドを無効化またはオプトアウトする方法
プロパティ フラグ PROPERTY_COMPAT_ALLOW_IGNORING_ORIENTATION_REQUEST_WHEN_LOOP_DETECTED を false に設定します。
オーバーライドを調整するプロパティ フラグ
<property android:name="android.window.PROPERTY_COMPAT_ALLOW_IGNORING_ORIENTATION_REQUEST_WHEN_LOOP_DETECTED"
android:value="false"/>
オーバーライドをテストする adb コマンド
オーバーライドを適用するには:
adb shell am compat enable OVERRIDE_ENABLE_COMPAT_IGNORE_ORIENTATION_REQUEST_WHEN_LOOP_DETECTED <package>
オーバーライドを削除するには:
adb shell am compat disable OVERRIDE_ENABLE_COMPAT_IGNORE_ORIENTATION_REQUEST_WHEN_LOOP_DETECTED <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_RESPECT_REQUESTED_ORIENTATION
デバイス メーカーがディスプレイ領域またはディスプレイ全体で有効にできる画面の向きのリクエスト動作の無視からパッケージを除外します。
アプリでオーバーライドと同じ結果を得る方法
該当なし。この問題はアプリケーション ロジックで解決する必要があります。
アプリを最適化する方法
OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。
オーバーライドを無効化またはオプトアウトする方法
オプトアウトはできません。デバイス メーカーが画面の向きのリクエストを無視する設定が有効になっているデバイスにアプリが対応していない場合、オーバーライドを無効にすると危険が生じる可能性があります。オーバーライドを無効にするには、Android デベロッパー リレーションズにお問い合わせください。
オーバーライドを調整するプロパティ フラグ
このオーバーライドにプロパティ フラグはありません。
オーバーライドをテストする adb コマンド
オーバーライドを適用するには:
adb shell am compat enable OVERRIDE_RESPECT_REQUESTED_ORIENTATION <package>
オーバーライドを削除するには:
adb shell am compat disable OVERRIDE_RESPECT_REQUESTED_ORIENTATION <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
NEVER_SANDBOX_DISPLAY_APIS
レターボックス表示またはサイズ互換モードのアクティビティの場合、パッケージに Display API サンドボックスが適用されなくなります。Display API は引き続きディスプレイ領域の境界を指定します。
アプリでオーバーライドと同じ結果を得る方法
サイズ変更可能なアクティビティを宣言するには、android:resizeableActivity マニフェスト属性を true に設定するか、android.supports_size_changes メタデータ フラグを true に設定します。
アプリを最適化する方法
完全にサイズ変更可能であると宣言しているアプリでは、UI 要素の配置にディスプレイ サイズを使用しないでください。WindowMetrics を提供する最新の API にアプリを移行します。Jetpack Compose を使用している場合は、WindowSizeClass API を利用して、現在のディスプレイ上のアプリの画面領域に基づいて UI を描画します。ウィンドウ サイズクラスをご覧ください。
オーバーライドを無効化またはオプトアウトする方法
オプトアウトはできません。非推奨の API から移行してください。
オーバーライドを調整するプロパティ フラグ
このオーバーライドにプロパティ フラグはありません。
オーバーライドをテストする adb コマンド
オーバーライドを適用するには:
adb shell am compat enable NEVER_SANDBOX_DISPLAY_APIS <package>
オーバーライドを削除するには:
adb shell am compat disable NEVER_SANDBOX_DISPLAY_APIS <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
ALWAYS_SANDBOX_DISPLAY_APIS
ウィンドウ モードに関係なく、パッケージに常に Display API サンドボックス化が適用されます。Display API では常にアプリの境界が設定されます。
アプリでオーバーライドと同じ結果を得る方法
サイズ変更不可のアクティビティを宣言するには、android:resizeableActivity 属性を false に設定するか、android.supports_size_changes メタデータ フラグを false に設定します。
アプリを最適化する方法
完全にサイズ変更可能であると宣言しているアプリでは、UI 要素の配置にディスプレイ サイズを使用しないでください。非推奨の API から、WindowMetrics を提供する最新の API にアプリを移行します。WindowMetricsCalculator をご覧ください。
オーバーライドを無効化またはオプトアウトする方法
オプトアウトはできません。非推奨の API から移行してください。
オーバーライドを調整するプロパティ フラグ
このオーバーライドにプロパティ フラグはありません。
オーバーライドをテストする adb コマンド
オーバーライドを適用するには:
adb shell am compat enable ALWAYS_SANDBOX_DISPLAY_APIS <package>
オーバーライドを削除するには:
adb shell am compat disable ALWAYS_SANDBOX_DISPLAY_APIS <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_SANDBOX_VIEW_BOUNDS_APIS
パッケージが次の View API をアクティビティの境界でサンドボックス化するよう設定します。
アプリでオーバーライドと同じ結果を得る方法
デバイス ディスプレイの境界とデバイス ディスプレイに対する相対オフセットではなく、アプリ ウィンドウの境界とアプリ ウィンドウに対する相対オフセットを提供する API を使用して、アプリコードの問題を解決します。
アプリを最適化する方法
アプリでは、レターボックス表示とマルチウィンドウ モードがアプリに適用される可能性を考慮し、View API を使用する必要があります。WindowMetricsCalculator をご覧ください。
オーバーライドを無効化またはオプトアウトする方法
プロパティ フラグ PROPERTY_COMPAT_ALLOW_SANDBOXING_VIEW_BOUNDS_APIS を false に設定します。
オーバーライドを調整するプロパティ フラグ
<property android:name="android.window.PROPERTY_COMPAT_ALLOW_SANDBOXING_VIEW_BOUNDS_APIS"
android:value="false"/>
オーバーライドをテストする adb コマンド
オーバーライドを適用するには:
adb shell am compat enable OVERRIDE_SANDBOX_VIEW_BOUNDS_APIS <package>
オーバーライドを削除するには:
adb shell am compat disable OVERRIDE_SANDBOX_VIEW_BOUNDS_APIS <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_CAMERA_COMPAT_DISABLE_FORCE_ROTATION
強制回転を無効にします。一部のアプリでユーザー エクスペリエンスが向上します。
アプリでオーバーライドと同じ結果を得る方法
プロパティ フラグ PROPERTY_CAMERA_COMPAT_ALLOW_FORCE_ROTATION を false に設定します。
アプリを最適化する方法
キャッシュされたカメラセンサーの向きやデバイス情報を使用しないでください。カメラの互換性に関するガイダンスについては、カメラのビューファインダーの概要とカメラアプリでサイズ変更可能なサーフェスをサポートするをご覧ください。
オーバーライドを無効化またはオプトアウトする方法
プロパティ フラグ PROPERTY_CAMERA_COMPAT_ALLOW_FORCE_ROTATION を true に設定します。
オーバーライドを調整するプロパティ フラグ
<property android:name="android.window.PROPERTY_CAMERA_COMPAT_ALLOW_FORCE_ROTATION"
android:value="true|false"/>
オーバーライドをテストする adb コマンド
オーバーライドを適用して、強制回転を解除するには:
adb shell am compat enable OVERRIDE_CAMERA_COMPAT_DISABLE_FORCE_ROTATION <package>
オーバーライドを解除して、強制回転を発生させるには:
adb shell am compat disable OVERRIDE_CAMERA_COMPAT_DISABLE_FORCE_ROTATION <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_CAMERA_COMPAT_DISABLE_REFRESH
強制回転後にアクティビティの更新を無効にします。更新によってアプリの状態が喪失した場合のユーザー エクスペリエンスが向上します。
アプリでオーバーライドと同じ結果を得る方法
プロパティ フラグ PROPERTY_CAMERA_COMPAT_ALLOW_REFRESH を false に設定します。
アプリを最適化する方法
OVERRIDE_CAMERA_COMPAT_DISABLE_FORCE_ROTATION をご覧ください。
オーバーライドを無効化またはオプトアウトする方法
プロパティ フラグ PROPERTY_CAMERA_COMPAT_ALLOW_REFRESH を true に設定します。
オーバーライドを調整するプロパティ フラグ
<property android:name="android.window.PROPERTY_CAMERA_COMPAT_ALLOW_REFRESH"
android:value="true|false"/>
オーバーライドをテストする adb コマンド
オーバーライドを適用して、アクティビティの更新を解除するには:
adb shell am compat enable OVERRIDE_CAMERA_COMPAT_DISABLE_REFRESH <package>
オーバーライドを解除して、アクティビティの更新を許可するには:
adb shell am compat disable OVERRIDE_CAMERA_COMPAT_DISABLE_REFRESH <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_CAMERA_COMPAT_ENABLE_REFRESH_VIA_PAUSE
適用先のパッケージが、カメラ互換強制回転の後、onResume() → onPause() → onResume() ではなく、onResume() → onStop() → onResume() のサイクルでアクティビティの更新を実行するように設定します。
アプリでオーバーライドと同じ結果を得る方法
プロパティ フラグ PROPERTY_CAMERA_COMPAT_ENABLE_REFRESH_VIA_PAUSE を true に設定します。
アプリを最適化する方法
OVERRIDE_CAMERA_COMPAT_DISABLE_FORCE_ROTATION をご覧ください。
オーバーライドを無効化またはオプトアウトする方法
プロパティ フラグ PROPERTY_CAMERA_COMPAT_ENABLE_REFRESH_VIA_PAUSE を false に設定します。
オーバーライドを調整するプロパティ フラグ
<property android:name="android.window.PROPERTY_CAMERA_COMPAT_ENABLE_REFRESH_VIA_PAUSE"
android:value="true|false"/>
オーバーライドをテストする adb コマンド
オーバーライドを適用するには:
adb shell am compat enable OVERRIDE_CAMERA_COMPAT_ENABLE_REFRESH_VIA_PAUSE <package>
オーバーライドを削除するには:
adb shell am compat disable OVERRIDE_CAMERA_COMPAT_ENABLE_REFRESH_VIA_PAUSE <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_CAMERA_LANDSCAPE_TO_PORTRAIT
カメラの縦向きがデバイスの自然な向きと一致しない場合、カメラ出力が反対方向に切り抜かれます。多くのアプリはこの状況を処理せず、引き伸ばされた画像を表示します。
アプリでオーバーライドと同じ結果を得る方法
プロパティ フラグ PROPERTY_COMPAT_OVERRIDE_LANDSCAPE_TO_PORTRAIT を true に設定します。
アプリを最適化する方法
OVERRIDE_CAMERA_COMPAT_DISABLE_FORCE_ROTATION をご覧ください。
オーバーライドを無効化またはオプトアウトする方法
プロパティ フラグ PROPERTY_COMPAT_OVERRIDE_LANDSCAPE_TO_PORTRAIT を false に設定します。
オーバーライドを調整するプロパティ フラグ
<property android:name="android.camera.PROPERTY_COMPAT_OVERRIDE_LANDSCAPE_TO_PORTRAIT"
android:value="true|false"/>
オーバーライドをテストする adb コマンド
オーバーライドを適用して、内部の前面カメラの切り抜きを適用するには:
adb shell am compat enable OVERRIDE_CAMERA_LANDSCAPE_TO_PORTRAIT <package>
オーバーライドを解除して、内部の前面カメラの切り抜きを解除するには:
adb shell am compat disable OVERRIDE_CAMERA_LANDSCAPE_TO_PORTRAIT <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_DISABLE_MEDIA_PROJECTION_SINGLE_APP_OPTION
アプリがアプリの画面共有をオプトアウトできないようにします（メディア プロジェクションをご覧ください）。アプリが createConfigForDefaultDisplay() API を悪用して全画面キャプチャを強制し、全画面でキャプチャされますがアプリの画面共有ではキャプチャされない通知の内容や、ウィンドウ モードに関係なくすべてのアプリを公開することでユーザーのプライバシーを危険にさらす場合に実装されます。
アプリでオーバーライドと同じ結果を得る方法
デフォルトのメディア プロジェクション動作（Android 14、API レベル 34、createScreenCaptureIntent() で実装）を許可します。これにより、ユーザーはウィンドウ モードに関係なく、全画面表示と単一のアプリ ウィンドウのどちらを共有するかを決定できます。または、createConfigForUserChoice() の呼び出しから返された MediaProjectionConfig 引数を使用して createScreenCaptureIntent(MediaProjectionConfig) を呼び出します。
アプリを最適化する方法
メディア プロジェクション（Android 14 ではデフォルトの動作）中に、デバイスのディスプレイ全体を共有するか、アプリ ウィンドウを共有するかをユーザーが選択できるようにします。
マルチ ウィンドウ モードをサポートするには、アプリをサイズ変更可能（resizeableActivity="true"）にします。
オーバーライドを無効化またはオプトアウトする方法
ユーザーのプライバシーが重要であるため、アプリでこのオーバーライドを無効にしたりオプトアウトしたりすることはできません。
オーバーライドを調整するプロパティ フラグ
なし。
オーバーライドをテストする adb コマンド
オーバーライドを適用して、部分的な画面共有のオプトアウト（つまり、部分的な画面共有の有効化）をキャンセルするには:
adb shell am compat enable OVERRIDE_DISABLE_MEDIA_PROJECTION_SINGLE_APP_OPTION <package>
オーバーライドを解除して、部分的な画面共有をアプリがオプトアウトできるようにするには:
adb shell am compat disable OVERRIDE_DISABLE_MEDIA_PROJECTION_SINGLE_APP_OPTION <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
OVERRIDE_ENABLE_COMPAT_FAKE_FOCUS
分割画面モードで、フォーカスされていないアプリに対して偽のフォーカスを送信できるようになります。一部のゲームエンジンは、アプリのコンテンツを描画する前にフォーカスの取得を待機します。偽のフォーカスは、アプリが再開してまだフォーカスされていない場合に、アプリが黒く塗りつぶされた状態にならないようにするのに役立ちます。
アプリでオーバーライドと同じ結果を得る方法
プロパティ フラグ PROPERTY_COMPAT_ENABLE_FAKE_FOCUS を true に設定します。
アプリを最適化する方法
アプリで複数の画面の向きと構成の変更を適切に処理できる場合は、この問題を回避できます。大画面のアプリの品質に関するガイドラインに沿って、アプリを大画面に対応させます。
Unity ゲームエンジンを実行している場合は、バージョン 2019.4.40 以降にアップグレードして、ゲームを再エクスポートします。Android Player 設定で Resizable Window オプションをオンのままにします。
オーバーライドを無効化またはオプトアウトする方法
プロパティ フラグ PROPERTY_COMPAT_ENABLE_FAKE_FOCUS を false に設定します。
オーバーライドを調整するプロパティ フラグ
<property android:name="android.window.PROPERTY_COMPAT_ENABLE_FAKE_FOCUS"
android:value="true|false"/>
オーバーライドをテストする adb コマンド
オーバーライドを適用するには:
adb shell am compat enable OVERRIDE_ENABLE_COMPAT_FAKE_FOCUS <package>
オーバーライドを削除するには:
adb shell am compat disable OVERRIDE_ENABLE_COMPAT_FAKE_FOCUS <package>
注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。
参考情報
- 大画面のアプリの品質に関するガイドライン
- アプリの中核品質に関するガイドライン