ビューを使用して UI を開発する

注: 可能な限り、View ではなく Compose を使用して UI を構築することをおすすめします。Compose UI をプレビューする方法については、Compose プレビューをご覧ください。

Layout Editor を使用すると、手動でレイアウト XML を記述する代わりに、視覚的に編集できる Design Editor に UI 要素をドラッグするだけで、簡単に View ベースのレイアウトを作成できるようになります。この Design Editor では、さまざまな Android デバイスやバージョンに応じたレイアウトをプレビューできるため、各種の画面サイズで適切に動作するよう、レイアウトのサイズを動的に変更できます。

Layout Editor は、ConstraintLayout を使用してレイアウトを作成する場合に特に便利です。

このページでは、Layout Editor の概要について説明します。レイアウトの基本については、レイアウトをご覧ください。

Layout Editor の概要

Layout Editor は、XML レイアウト ファイルを開くと表示されます。

図 1. Layout Editor。

1. Palette: レイアウトにドラッグできるビューおよびビューグループが格納されています。
2. Component Tree: レイアウト内のコンポーネントの階層を表示します。
3. ツールバー: エディタ内のレイアウトの表示方法を設定したり、レイアウト属性を変更したりするためのボタンが並んでいます。
4. Design Editor: [Design] ビューまたは [Blueprint] ビュー、あるいは両方のビューでレイアウトを編集できます。
5. Attributes: 選択したビューの属性を指定します。
6. View mode: [Code] モード 、[Split] モード 、[Design] モード のいずれかで、レイアウトを表示します。[Split] モードの場合、[Code] ウィンドウと [Design] ウィンドウが同時に表示されます。
7. ズームとパンのコントロール: エディタ内のプレビューのサイズと位置をコントロールします。

XML レイアウト ファイルを開くと、図 1 のように、デフォルトで Design Editor が開きます。Text Editor でレイアウト XML を編集するには、ウィンドウの右上隅にある [Code] ボタン をクリックします。なお、[Code] ビューでレイアウトを編集している間は、[Palette] パネル、[Component Tree] パネル、[Attributes] パネルは使用できません。

ヒント: Design Editor と Text Editor を切り替えるには、Alt（macOS の場合は Control）+ Shift と左右矢印キーを押します。

プレビューの表示方法を変更する

Design Editor の上部にあるボタンを使用して、エディタ内のレイアウトの表示方法を設定できます。

図 2. レイアウトの外観を設定するための Layout Editor ツールバーのボタン。

1. Design と Blueprint: エディタ内でレイアウトを表示する方法を選択します。B を押すと、各ビュータイプを順番に切り替えることができます。
   • [Design] を選択すると、レイアウトのレンダリング プレビューを表示できます。
   • [Blueprint] を選択すると、各ビューのアウトラインだけを表示できます。
   • [Design + Blueprint] を選択すると、両方のビューを並べて表示できます。
2. 画面の向きとレイアウト バリエーション: 画面の向き（横向きまたは縦向き）と、アプリが提供する各種レイアウト（夜間モードなど）用の画面モードを選択します。このメニューには、このページのセクションで説明するように、新しいレイアウト バリエーションを作成するためのコマンドも含まれています。キーボードの O キーを押して画面の向きを変更することもできます。

3. システム UI モード: アプリでダイナミック カラーを有効にしている場合は、壁紙を切り替え、異なるユーザーが選択した壁紙にレイアウトがどのように反応するかを確認できます。最初に、テーマをマテリアル ダイナミック カラーテーマに変更してから、壁紙を変更する必要があります。

4. デバイスタイプとサイズ: デバイスタイプ（スマートフォン、タブレット、Android TV、Wear OS）と画面構成（サイズと密度）を選択します。事前設定済みのデバイスタイプと独自の AVD 定義から選択できます。また、リストから [Add Device Definition] を選択して新しい AVD を追加することもできます（図 3 を参照）。

   • デバイスのサイズを変更するには、レイアウトの右下隅をドラッグします。
   • D を押すと、デバイスリストの中で順番に切り替えることができます。

   このメニューのリファレンス デバイスに対してレイアウトをテストすると、実際のデバイス上のレイアウト状態に合わせてアプリの画面が適切に調整されます。

   

   図 3. リファレンス デバイスが表示されているデバイスリスト。

5. API バージョン: レイアウトをプレビューする Android のバージョンを選択します。使用可能な Android バージョンのリストは、SDK Manager を使用してインストールした SDK プラットフォーム バージョンによって異なります。

6. アプリのテーマ: プレビューに適用する UI テーマを選択します。選択したテーマは、サポートされているレイアウト スタイルでのみ機能します。そのため、このリストの多くのテーマはエラーになります。

7. 言語: UI 文字列の言語を選択します。このリストには、文字列リソースで利用できる言語だけが表示されます。翻訳を編集する場合は、メニューから [Edit Translations] を選択します。翻訳操作の詳細については、Translations Editor を使用して UI をローカライズするをご覧ください。

注: [Layout Variants] から新しいレイアウト ファイルを追加しない限り、ここでの設定は実際のアプリのコードまたはマニフェストには影響しません。影響を受けるのはレイアウト プレビューだけです。

新しいレイアウトを作成する

アプリ用に新しいレイアウトを追加する場合、まず、プロジェクトのデフォルト layout/ ディレクトリ内にデフォルト レイアウト ファイルを作成します。このデフォルト レイアウトは、すべてのデバイス構成に適用されます。デフォルト レイアウトを作成したら、このページのセクションで説明するように、大画面用など、個々のデバイス構成に合わせてレイアウト バリエーションを作成します。

新しいレイアウトの作成は、以下のいずれかの方法で行います。

Android Studio のメインメニューを使用する

1. [Project] ウィンドウで、レイアウトを追加するモジュールをクリックします。
2. メインメニューで、[File] > [New] > [XML] > [Layout XML File] を選択します。
3. 表示されるダイアログで、ファイル名、ルート レイアウト タグ、レイアウトが属するソースセットを指定します。
4. [Finish] をクリックすると、レイアウトが作成されます。

[Project] ビューを使用する

1. [Project] ウィンドウで、[Project] ビューを選択します。
2. レイアウトを追加するレイアウト ディレクトリを右クリックします。
3. 表示されるコンテキスト メニューで、[New] > [Layout Resource File] をクリックします。

[Android] ビューを使用する

1. [Project] ウィンドウで、[Android] ビューを選択します。
2. layout フォルダを右クリックします。
3. 表示されるコンテキスト メニューで、[New] > [Layout Resource File] を選択します。

Resource Manager を使用する

1. Resource Manager で、[Layout] タブを選択します。
2. [+] ボタンをクリックして、[Layout Resource File] をクリックします。

レイアウト バリエーションを使用してさまざまな画面に合わせて最適化する

レイアウト バリエーションとは、特定の画面サイズまたは向きに合わせて既存のレイアウトを最適化したバージョンです。

推奨レイアウト バリエーションを使用する

Android Studio には一般的なレイアウト バリエーションがあらかじめ用意されており、個々のプロジェクトで使用できます。推奨レイアウト バリエーションを使用する手順は次のとおりです。

1. デフォルトのレイアウト ファイルを開きます。
2. ウィンドウの右上にある [Design] アイコンをクリックします。
3. レイアウト ファイルの名前が [レイアウト ファイルの修飾子を切り替えて作成するアクション] プルダウンに表示されます。プルダウンを選択します。
4. プルダウン リストで、[Create Landscape Qualifier] や [Create Tablet Qualifier] などのバリエーションを選択します。

   

   図 4. レイアウト修飾子のプルダウン リスト。

新しいレイアウト ディレクトリが作成されます。

独自のレイアウト バリエーションを作成する

独自のレイアウト バリエーションを作成する手順は次のとおりです。

1. デフォルトのレイアウト ファイルを開きます。
2. ウィンドウの右上にある [Design] アイコンをクリックします。
3. レイアウト ファイルの名前が [レイアウト ファイルの修飾子を切り替えて作成するアクション] プルダウンに表示されます。プルダウンを選択します。

4. プルダウン リストで [リソース修飾子を追加] を選択します。（上の図 4 を参照）。

   [Select Resource Directory] ダイアログが表示されます。

5. [リソース ディレクトリを選択] ダイアログで、バリエーションのリソース修飾子を定義します。

   1. [Available qualifiers] リストから限定子を選択します。
   2. [追加] ボタンをクリックします。
   3. 必要な値を入力します。
   4. 他の限定子を追加するには、この手順を繰り返します。

6. すべての限定子を追加したら、[OK] をクリックします。

同じレイアウトに複数のバリエーションがある場合は、[Action to switch and create qualifiers for layout files] プルダウンからバリエーションを選択して切り替えることができます。

さまざまなディスプレイ用のレイアウトを作成する方法について詳しくは、さまざまなディスプレイサイズをサポートするをご覧ください。

ビューやレイアウトを変換する

ビューは別の種類のビューに、またレイアウトは別の種類のレイアウトに変換できます。

1. エディタ ウィンドウの右上隅にある [Design] ボタンをクリックします。
2. [Component Tree] で、ビューまたはレイアウトを右クリックして、[Convert view] をクリックします。
3. 表示されるダイアログで、新しいタイプのビューまたはレイアウトを選択して、[Apply] をクリックします。

レイアウトを ConstraintLayout に変換する

レイアウトのパフォーマンスを高めるには、古いレイアウトを ConstraintLayout に変換します。ConstraintLayout は、制約ベースのレイアウト システムを使用することで、ネスト ビューグループなしでさまざまなレイアウトを作成できます。

既存のレイアウトを ConstraintLayout に変換する手順は次のとおりです。

1. Android Studio で既存のレイアウトを開きます。
2. エディタ ウィンドウの右上にある [デザイン] アイコンをクリックします。
3. [Component Tree] で、対象のレイアウトを右クリックして、[Convert your-layout-type to ConstraintLayout] をクリックします。

ConstraintLayout の詳細については、ConstraintLayout を使用してレスポンシブ UI を作成するをご覧ください。

Palette 内でアイテムを検索する

[Palette] 内でビューまたはビューグループを名前に基づいて検索するには、[Palette] の上部にある [Search] ボタン をクリックします。あるいは、[Palette] ウィンドウにフォーカスがあれば、いつでもアイテムの名前を入力できます。

頻繁に使用するアイテムは、[Palette] の [Common] カテゴリで見つけることができます。このカテゴリにアイテムを追加するには、[Palette] でビューまたはビューグループを右クリックし、コンテキスト メニューから [Favorite] をクリックします。

Palette からドキュメントを開く

ビューまたはビューグループに関する Android デベロッパー リファレンス ドキュメントを開くには、[Palette] で UI 要素を選択して、Shift+F1 を押します。

ビューまたはビューグループのマテリアル ガイドライン ドキュメントを表示するには、[Palette] で UI 要素を右クリックして、コンテキスト メニューから [Material Guidelines] を選択します。そのアイテムのエントリがない場合は、マテリアル ガイドライン ドキュメントのホームページが開きます。

レイアウトにビューを追加する

レイアウトの作成を開始するには、ビューとビューグループを [Palette] から Design Editor にドラッグします。ビューをレイアウトに配置すると、ビューとその他のレイアウトとの関係を示す情報が Design Editor に表示されます。

ConstraintLayout を使用している場合、制約推測機能と自動接続機能により自動的に制約を作成できます。

ビュー属性を編集する

図 5. [Attributes] パネル。

ビュー属性は、Layout Editor の [Attributes] パネルで編集できます。このウィンドウを使用できるのは、Design Editor が開いているときに限られます。そのため、[Design] モードまたは [Split] モードでレイアウトを表示して使用する必要があります。

ビューを選択（[Component Tree] または Design Editor でビューをクリック）すると、図 5 に示すように、[Attributes] パネルに以下の内容が表示されます。

1. Declared Attributes: レイアウト ファイルで指定された属性のリストが表示されます。属性を追加するには、セクションの上部にある [追加] ボタン をクリックします。
2. Layout: ビューの幅と高さを指定するコントロールが表示されます。ConstraintLayout のビューの場合、このセクションには制約のバイアスも表示され、ビューで使用されている制約がリスト表示されます。ConstraintLayout を使用してビューのサイズを制御する方法については、ビューのサイズを調整するをご覧ください。
3. Common Attributes: 選択したビューの共通属性がリスト表示されます。利用可能な属性をすべて表示するには、ウィンドウの下部にある [All Attributes] セクションを展開します。
4. 検索: 特定のビュー属性を検索できます。

5. 各属性値の右側にあるアイコンは、その属性値がリソース参照であるかどうかを示します。このインジケーターは、値がリソース参照の場合は塗りつぶし状態 になり、値がハードコードされている場合は枠線だけの状態 になります。これにより、ハードコードされた値を一目で把握できます。

   いずれの状態でもインジケーターをクリックすると、[Resources] ダイアログが開き、対応する属性のリソース参照を選択できます。

6. 属性値の周囲が赤色でハイライト表示されている場合は、値にエラーがあることを示します。たとえば、エラーはレイアウト定義属性の無効なエントリを示している可能性があります。

   オレンジ色でハイライト表示されている場合は、値に警告があることを示します。たとえば、リソース参照の値が期待される属性にハードコードされた値が使用されていると、警告が表示されます。

ビューにサンプルデータを追加する

Android のレイアウトの多くはランタイム データに依存するため、アプリの設計段階で実際の見た目や操作感を確認するのが困難な場合があります。Layout Editor から TextView、ImageView、RecyclerView にプレビュー用サンプルデータを追加できます。

注: View にサンプルデータを追加すると、あたかもデベロッパーが自分のデータを使用したかのようにプロジェクトが変更されます。その後、必要に応じてその変更を修正できます。

[Design-time View Attributes] ウィンドウを表示するには、図 6 に示すように、これらのビュータイプのいずれかを右クリックして [Set Sample Data] を選択します。

図 6. [Design-time View Attributes] ウィンドウ。

TextView では、さまざまなサンプル テキスト カテゴリを選択できます。サンプル テキストを使用する場合、TextView の text 属性には選択したサンプルデータが入力されます。なお、[Design-time View Attributes] ウィンドウでサンプル テキストを選択できるのは、text 属性が空の場合に限られます。

図 7. サンプルデータが入力された TextView。

ImageView では、さまざまなサンプル画像を選択できます。サンプル画像を選択すると、ImageView の tools:src 属性（AndroidX を使用している場合は tools:srcCompat 属性）にデータが入力されます。

図 8. サンプルデータが入力された ImageView。

RecyclerView では、サンプル画像とサンプル テキストを含むテンプレートのセットを選択できます。このテンプレートを使用すると、res/layout ディレクトリに recycler_view_item.xml というファイルが追加されます。このファイルには、サンプルデータのレイアウトが含まれています。また、サンプルデータを適切に表示するため、RecyclerView にメタデータが追加されます。

図 9. サンプルデータが入力された RecyclerView。

レイアウト内の警告やエラーを表示する

レイアウトに問題があると、Layout Editor は [Component Tree] 内の該当ビューの横に通知アイコンを表示します。通知には、エラーの場合は赤色の丸型感嘆符アイコン が使用され、警告の場合はオレンジ色の三角形型感嘆符アイコン が使用されます。アイコンをクリックすると詳細が表示されます。

ツールバーの [Show Warnings and Errors] ボタン（ または ）をクリックすると、エディタの下部にあるウィンドウに、検出済みの問題がすべて表示されます。

フォントをダウンロードしてテキストに適用する

Android 8.0（API レベル 26）または Jetpack Core ライブラリを使用している場合は、次の手順に沿って、数百種類のフォントを選択できます。

1. Layout Editor で、[Design] アイコンをクリックして、Design Editor にレイアウトを表示します。
2. テキストビューを選択します。
3. [Attributes] パネルで [textAppearance] を展開し、[fontFamily] ボックスを展開します。
4. リストの一番下までスクロールして、[More Fonts] をクリックし、[Resources] ダイアログを開きます。
5. [Resources] ダイアログで、リストをブラウジングするか上部の検索バーに入力して、フォントを選択します。[Downloadable] に表示されているフォントを選択する場合は、[Create downloadable font] をクリックすると、ダウンロード可能フォントとしてランタイムにフォントを読み込むことができます。あるいは、[Add font to project] をクリックすると、TTF フォント ファイルとして APK 内にパッケージ化できます。[Android] の下にリストされているフォントは Android システムで用意済みのものです。そのため、ダウンロードしたり、APK にバンドルしたりする必要はありません。
6. [OK] をクリックして終了します。

Layout Validation

Layout Validation は、さまざまなデバイスや表示設定のレイアウトを同時にプレビューするビジュアル ツールであり、プロセスの早期にレイアウトの問題を把握できます。この機能にアクセスするには、IDE ウィンドウの右上にある [Layout Validation] タブをクリックします。

図 10. [Layout Validation] タブ。

使用可能な設定セットを切り替えるには、[Layout Validation] ウィンドウの上部にある [Reference Devices] プルダウンから次のいずれかを選択します。

• 参照デバイス
• カスタム
• 色覚特性
• フォントサイズ

図 11. [参照デバイス] プルダウン。

参照デバイス

参照デバイスとは、テスト対象として推奨される一連のデバイスのことです。スマートフォン、折りたたみ式、タブレット、パソコン用のインターフェースが含まれます。この一連の参照デバイスでレイアウトがどのように表示されるかをプレビューする必要があります。

図 12. Layout Validation ツールの参照デバイスのプレビュー。

カスタム

プレビューする表示設定をカスタマイズするには、言語、デバイス、画面の向きなど、各種設定を選択します。

図 16. Layout Validation ツールでのカスタム表示の設定。

色覚特性

色覚特性のあるユーザー向けにアプリをより使いやすくするために、一般的な色覚特性をシミュレートしてレイアウトを検証します。

図 13. Layout Validation ツールで色覚特性をシミュレートしたプレビュー。

フォントサイズ

さまざまなフォントサイズでレイアウトを検証し、大きなフォントでレイアウトをテストすることで、視覚障がいのユーザー向けにアプリのユーザー補助を改善します。

図 14. Layout Validation ツールでのさまざまなフォントサイズのプレビュー。