このページは Cloud Translation API によって翻訳されました。

適応型の推奨事項と禁止事項

アダプティブアプリは、デバイスの画面全体、マルチウィンドウモードのサイズ変更可能なウィンドウ、縦向きと横向き、折りたたみ式デバイスの折りたたみ状態と展開状態など、あらゆるサイズのディスプレイをサポートします。

構成設定と API の簡単なリストを使用して、適応型アプリを構築できます。ただし、古い設定や API の中には、アダプティブアプリと互換性がない設定や API があり、使用を避ける必要があります。

サイズ変更

アダプティブアプリは、アプリのサイズ変更とマルチウィンドウモードをサポートしています。

<activity> マニフェスト要素と <application> マニフェスト要素の resizeableActivity 属性は、Android 11（API レベル 30）以前でマルチウィンドウモードを有効または無効にします。Android 12（API レベル 31）以降では、大画面は属性に関係なくマルチウィンドウモードをサポートします。詳細については、マルチウィンドウモードをサポートするをご覧ください。

✓ 推奨

アプリがマルチウィンドウやマルチタスクのシナリオに参加できるようにして、ユーザーの生産性と満足度を高めましょう。

アプリが 24 より前の API レベルをターゲットとしている場合は resizeableActivity="true" を設定します。それ以外の場合は、設定する必要はありません。Android 7.0（API レベル 24）以降では、デフォルトで true になります。

✗ 禁止

どの API レベルにも resizeableActivity="false" を設定しないでください。マルチウィンドウモードを使用するユースケースからアプリを除外しないでください。

向き

適応型アプリは、ディスプレイのサイズやウィンドウ処理モードに関係なく、縦向きと横向きをサポートします。

screenOrientation マニフェスト設定は、アクティビティの向きを制限します。

✓ 推奨

アプリマニフェストから screenOrientation の設定を削除します。

アプリの向きをロックしても、ウィンドウサイズが変更されることはありません。アプリのサイズは、マルチウィンドウモードに入ったとき、デバイスが折りたたまれたとき、またはデスクトップタイプのウィンドウのサイズが変更されたときに変更されます。アプリは、screenOrientation 属性の設定に関係なく、ウィンドウサイズの変更をサポートする必要があります。

✗ 禁止

アクティビティの向きを制限しない。向きをロックするアプリは、大画面デバイスと互換性のないウィンドウサイズでレターボックス表示されます。

レターボックス表示のアプリは、タブレット、折りたたみ式デバイス、ChromeOS デバイスの Google Play で見つけにくくなります。

アスペクト比

画面とウィンドウのサイズが異なるため、アスペクト比もさまざまです（縦長、正方形、横長など）。

マニフェストの minAspectRatio と maxAspectRatio の設定では、アプリのアスペクト比をハードコード値に制限します。

✓ 推奨

相対的な寸法に関係なく、ディスプレイに収まるようにアプリを調整します。

アプリマニフェストから minAspectRatio と maxAspectRatio の設定を削除します。または、アプリのサイズ変更が可能で、アスペクト比が自動的に調整されるようにします（サイズ変更可能のセクションを参照）。

✗ 禁止

アプリの相対的なサイズを制御しようとしないでください。アプリのアスペクト比と互換性のないアスペクト比の画面またはウィンドウでアプリが実行されている場合、アプリはレターボックス表示されます。

Android 14（API レベル 34）以降では、ユーザーはアプリのアスペクト比をオーバーライドして、レターボックス表示されたアプリを拡大し、利用可能なディスプレイ領域を埋めることができます。デバイスの互換モードをご覧ください。

ウィンドウのサイズ

さまざまなディスプレイサイズに合わせてレイアウトを最適化することが、アダプティブデザインの基本的な前提です。アダプティブアプリは、デバイスの画面サイズではなく、アプリのウィンドウサイズに重点を置いています。アプリが全画面表示の場合、アプリウィンドウはデバイスの画面になります。

ウィンドウサイズクラスは、アプリウィンドウのサイズを決定して分類する体系的な方法を提供します。アプリのウィンドウサイズクラスが変更されたときにレイアウトを変更して、アプリを適応させます。

✓ 推奨

ウィンドウサイズクラスに基づいてアプリのウィンドウサイズを評価する。

ウィンドウサイズクラスを特定するには、Compose Material 3 アダプティブライブラリの currentWindowAdaptiveInfo() トップレベル関数を使用します。詳細については、アダプティブアプリを作成するをご覧ください。

✗ 禁止

ウィンドウサイズのクラス定義と組み込み API の有用性を無視しないでください。非推奨の API を使用してウィンドウサイズを計算しないでください。

サポート終了 API

古いプラットフォーム API はアプリウィンドウを正しく測定しません。デバイスの画面を測定する API もあれば、システム装飾を除外する API もあります。

✓ 推奨

WindowManager#getCurrentWindowMetrics() と WindowMetrics#getBounds() を使用して、アプリウィンドウのサイズを取得します。WindowMetrics#getDensity() を使用して表示密度を取得します。

✗ 禁止

ウィンドウのサイズを特定するために、非推奨の Display API を使用しないでください。

getSize(): Android 11（API レベル 30）で非推奨
getMetrics(): Android 11（API レベル 30）で非推奨
getRealSize(): Android 12（API レベル 31）で非推奨
getRealMetrics(): Android 12（API レベル 31）で非推奨

Compose

Jetpack Compose は、アダプティブ UI 開発用に設計されています。XML、レイアウトファイル、リソース修飾子はありません。Kotlin ベースのステートレスコンポーザブル（UI を記述する Column、Row、Box など）と、UI 要素に動作を追加する修飾子（offset、padding、size など）。

✓ 推奨

Compose でビルドします。最新の機能とリリースに関する最新情報を入手する。

✗ 禁止

古いテクノロジーに依存しないでください。アプリが時代遅れにならないようにする。

Compose マテリアル 3 適応ライブラリ

Compose マテリアル 3 アダプティブライブラリには、アダプティブアプリの開発を容易にするコンポーネントと API が用意されています。

✓ 推奨

アプリを適応性のあるものにするには、次の API を使用します。

NavigationSuiteScaffold: アプリウィンドウのサイズクラスに応じて、ナビゲーションバーとナビゲーションレールの間で切り替えます。
ListDetailPaneScaffold: リストと詳細の正規レイアウトを実装します。レイアウトをアプリのウィンドウサイズに合わせて調整します。
SupportingPaneScaffold: サポートペインの正規レイアウトを実装します。

✗ 禁止

最初から作り直す必要はありません。すべての Jetpack Compose ライブラリが提供するデベロッパーの生産性向上を逃さないでください。

レイアウト

ユーザーは、補足コンテンツや高度なコントロールによって、利用可能なディスプレイ領域を最大限に活用することをアプリに期待しています。

アダプティブアプリは、ディスプレイの変化（特に、アプリウィンドウのサイズの変化やデバイスの向きの変化）に基づいてレイアウトを最適化します。

✓ 推奨

ウィンドウサイズが変更されたときに UI コンポーネントを変更し、利用可能なディスプレイ領域を活用します。たとえば、コンパクトウィンドウサイズで使用されるボトムナビゲーションバーを、中程度のウィンドウと拡大ウィンドウの縦型ナビゲーションレールに置き換えます。すべてのディスプレイでアクセスできるようにダイアログを再配置しました。

コンテンツをペインに整理して、リスト詳細や補助ペインなどのマルチペインレイアウトを有効にし、動的コンテンツの表示を可能にします。

✓ 推奨される回答: リストアクティビティと詳細アクティビティを、デュアルペインレイアウトで表示します。

✗ 禁止

コンテンツペインを使用していない場合は、使用可能なディスプレイ領域を埋めるために UI 要素を伸ばすだけにしないでください。長い行のテキストは読みづらい。伸ばされたボタンはデザインが悪いように見えます。Modifier.fillMaxWidth を使用する場合は、それがすべてのディスプレイサイズで適切な動作であると想定しないでください。