使用 Views 开发 UI

布局编辑器使您能够通过将 UI 元素拖放到可视化设计编辑器中来快速构建基于 View 的布局，而不是编写布局 XML。设计编辑器可以在不同的 Android 设备和版本上预览您的布局，并且您可以动态调整布局大小，以确保它在不同屏幕尺寸上都能正常工作。

当使用 ConstraintLayout 构建布局时，布局编辑器特别强大。

此页面提供了布局编辑器的概述。要了解有关布局基础知识的更多信息，请参阅 布局。

布局编辑器简介

当您打开 XML 布局文件时，布局编辑器就会出现。

1. 调色板：包含您可以拖放到布局中的各种视图和视图组。
2. 组件树：显示布局中组件的层次结构。
3. 工具栏：具有配置您在编辑器中布局外观并更改布局属性的按钮。
4. 设计编辑器：允许您在设计视图、蓝图视图或两者中编辑您的布局。
5. 属性：具有所选视图属性的控件。
6. 视图模式：允许您在代码 、拆分 或设计 模式下查看您的布局。拆分模式同时显示代码和设计窗口。
7. 缩放和平移控件：控制编辑器中预览的大小和位置。

当您打开 XML 布局文件时，设计编辑器会默认打开，如图 1 所示。要在文本编辑器中编辑布局 XML，请单击窗口右上角的代码 按钮。请注意，在代码视图中编辑布局时，调色板、组件树和属性面板不可用。

提示：要在设计和文本编辑器之间切换，请按 Alt（macOS 上为 Control）加 Shift 和向右或向左箭头键。

更改预览外观

设计编辑器顶行中的按钮允许您配置布局在编辑器中的外观。

1. 设计和蓝图：选择您希望如何在编辑器中查看布局。您也可以按 B 循环浏览这些视图类型。
   • 选择设计以查看布局的渲染预览。
   • 选择蓝图仅查看每个视图的轮廓。
   • 选择设计 + 蓝图以并排查看这两个视图。
2. 屏幕方向和布局变体：在横向或纵向屏幕方向之间进行选择，或选择您的应用提供备用布局的其他屏幕模式，例如夜间模式。此菜单还包含用于创建新的布局变体的命令，如本页面中的一个部分所述。您也可以按键盘上的字母 O 来更改方向。

3. 系统 UI 模式：如果您已在应用中启用了动态颜色，请切换壁纸并查看您的布局如何对用户选择的不同壁纸做出反应。请注意，您必须首先将主题更改为材质动态颜色主题，然后更改壁纸。

4. 设备类型和尺寸：选择设备类型（手机/平板电脑、Android TV 或 Wear OS）和屏幕配置（尺寸和密度）。您可以从几个预配置的设备类型和您自己的 AVD 定义中进行选择，并且您可以通过从列表中选择添加设备定义来创建新的 AVD，如图 3 所示。

   • 要调整设备大小，请拖动布局的右下角。
   • 按 D 循环浏览设备列表。

   针对此菜单中的参考设备测试您的布局有助于您的应用很好地扩展到真实设备上的布局状态。

   

5. API 版本：选择 Android 版本以预览您的布局。可用 Android 版本的列表取决于您使用 SDK 管理器安装了哪些 SDK 平台版本。

6. 应用主题：选择要应用于预览的 UI 主题。这仅适用于受支持的布局样式，因此此列表中的许多主题会导致错误。

7. 语言：选择要显示的 UI 字符串的语言。此列表仅显示字符串资源中可用的语言。如果您想编辑您的翻译，请从菜单中点击编辑翻译。有关使用翻译的更多信息，请参阅 使用翻译编辑器本地化 UI。

创建新布局

在为您的应用添加新布局时，首先在项目的默认 layout/ 目录中创建一个默认布局文件，以便它适用于所有设备配置。拥有默认布局后，您可以创建布局变体，如本页面中的一个部分所述，用于特定的设备配置，例如大屏幕。

您可以通过以下方式之一创建新布局

使用 Android Studio 的主菜单

1. 在项目窗口中，单击您要向其添加布局的模块。
2. 在主菜单中，选择文件 > 新建 > XML > 布局 XML 文件。
3. 在出现的对话框中，提供文件名、根布局标签和布局所属的源集。
4. 单击完成以创建布局。

使用项目视图

1. 在项目窗口中选择项目视图。
2. 右键单击您要添加布局的布局目录。
3. 在出现的上下文菜单中，单击新建 > 布局资源文件。

使用 Android 视图

1. 在项目窗口中选择Android视图。
2. 右键单击 layout 文件夹。
3. 在出现的上下文菜单中，选择新建 > 布局资源文件。

使用资源管理器

1. 在资源管理器中，选择布局选项卡。
2. 单击 + 按钮，然后单击布局资源文件。

使用布局变体优化不同屏幕

布局变体是现有布局的备用版本，已针对特定屏幕尺寸或方向进行了优化。

使用建议的布局变体

Android Studio 包括您可以用于项目的常见布局变体。要使用建议的布局变体，请执行以下操作

1. 打开您的默认布局文件。
2. 单击窗口右上角的设计 图标。
3. 布局文件的名称显示在切换和为布局文件创建限定符的操作下拉列表中。选择下拉列表。
4. 在下拉列表中，选择一个变体，例如创建横向限定符或创建平板电脑限定符。

   

将创建一个新的布局目录。

创建您自己的布局变体

如果您想创建您自己的布局变体，请执行以下操作

1. 打开您的默认布局文件。
2. 单击窗口右上角的设计 图标。
3. 布局文件的名称显示在切换和为布局文件创建限定符的操作下拉列表中。选择下拉列表。

4. 在下拉列表中，选择添加资源限定符。（请参见上图 4。）

   将出现选择资源目录对话框。

5. 在选择资源目录对话框中，为变体定义资源限定符

   1. 从可用限定符列表中选择一个限定符。
   2. 单击添加 按钮。
   3. 输入任何必需的值。
   4. 重复这些步骤以添加其他限定符。

6. 添加完所有限定符后，单击确定。

当您具有相同布局的多个变体时，您可以通过从切换和为布局文件创建限定符的操作下拉列表中选择一个变体来在它们之间切换。

有关如何为不同屏幕创建布局的更多信息，请参阅 支持不同的屏幕尺寸。

转换视图或布局

您可以将一个视图转换为另一种类型的视图，并且可以将一个布局转换为另一种类型的布局

1. 单击编辑器窗口右上角的设计按钮。
2. 在组件树中，右键单击视图或布局，然后单击转换视图。
3. 在出现的对话框中，选择新的视图或布局类型，然后单击应用。

将布局转换为 ConstraintLayout

为了提高布局性能，请将旧的布局转换为 ConstraintLayout。 ConstraintLayout 使用基于约束的布局系统，允许您构建大多数布局而无需任何嵌套视图组。

要将现有布局转换为 ConstraintLayout，请执行以下操作

1. 在 Android Studio 中打开现有布局。
2. 单击编辑器窗口右上角的设计 图标。
3. 在组件树中，右键单击布局，然后单击将 your-layout-type 转换为 ConstraintLayout。

要了解有关 ConstraintLayout 的更多信息，请参阅 使用 ConstraintLayout 构建响应式 UI。

在调色板中查找项目

要在调色板中按名称搜索视图或视图组，请单击调色板顶部的搜索 按钮。或者，您可以在调色板窗口获得焦点时键入项目的名称。

在调色板中，您可以在常用类别中找到常用项目。要将项目添加到此类别，请右键单击调色板中的视图或视图组，然后在上下文菜单中单击收藏。

从调色板打开文档

要打开视图或视图组的 Android 开发者参考文档，请在调色板中选择 UI 元素，然后按 Shift+F1。

要查看视图或视图组的 Material 指南文档，请右键单击调色板中的 UI 元素，然后从上下文菜单中选择Material 指南。如果该项目没有特定的条目，则该命令将打开Material 指南文档的主页。

将视图添加到您的布局

要开始构建您的布局，请将视图和视图组从调色板拖放到设计编辑器中。当您将视图放置在布局中时，编辑器会显示有关该视图与布局其余部分关系的信息。

如果您使用的是ConstraintLayout，您可以使用“推断约束”和“自动连接”功能自动创建约束。

编辑视图属性

您可以在布局编辑器的“属性”面板中编辑视图属性。此窗口仅在设计编辑器打开时可用，因此请以“设计”或“拆分”模式查看您的布局以使用它。

当您选择一个视图时，无论是通过单击“组件树”中的视图还是设计编辑器中的视图，“属性”面板都会显示以下内容，如图 5 所示。

1. 已声明的属性：列出布局文件中指定的属性。要添加属性，请单击该部分顶部的“添加”按钮。
2. 布局：包含用于视图宽度和高度的控件。如果视图位于ConstraintLayout中，则此部分还会显示约束偏差并列出视图使用的约束。有关使用ConstraintLayout控制视图大小的更多信息，请参阅调整视图大小。
3. 常用属性：列出所选视图的常用属性。要查看所有可用属性，请展开窗口底部的“所有属性”部分。
4. 搜索：允许您搜索特定的视图属性。

5. 每个属性值右侧的图标指示属性值是否为资源引用。当值为资源引用时，这些指示器为实心，当值为硬编码时为空，以帮助您一目了然地识别硬编码值。

   单击任一状态下的指示器以打开“资源”对话框，您可以在其中选择相应属性的资源引用。

6. 属性值周围的红色突出显示表示该值存在错误。例如，错误可能表示布局定义属性的条目无效。

   橙色突出显示表示该值的警告。例如，当您使用硬编码值（预期使用资源引用）时，可能会出现警告。

向您的视图添加示例数据

由于许多 Android 布局依赖于运行时数据，因此在设计应用程序时很难直观地了解布局的外观和感觉。您可以从布局编辑器中向TextView、ImageView或RecyclerView添加示例预览数据。

要显示“设计时视图属性”窗口，请右键单击这些视图类型之一，然后选择“设置示例数据”，如图 6 所示。

对于TextView，您可以在不同的示例文本类别之间进行选择。使用示例文本时，Android Studio 会使用您选择的示例数据填充TextView的text属性。请注意，只有当text属性为空时，您才能通过“设计时视图属性”窗口选择示例文本。

对于ImageView，您可以在不同的示例图像之间进行选择。当您选择示例图像时，Android Studio 会填充ImageView的tools:src属性（如果使用 AndroidX，则为tools:srcCompat）。

对于RecyclerView，您可以从包含示例图像和文本的一组模板中进行选择。使用这些模板时，Android Studio 会将一个文件添加到您的res/layout目录中，即recycler_view_item.xml，其中包含示例数据的布局。Android Studio 还向RecyclerView添加元数据以正确显示示例数据。

显示布局警告和错误

布局编辑器会在“组件树”中相应视图旁边通知您任何布局问题，使用红色圆圈感叹号图标表示错误，或使用橙色三角形感叹号图标表示警告。单击该图标以查看更多详细信息。

要查看编辑器下方窗口中所有已知问题，请单击工具栏中的“显示警告和错误”（或）。

下载字体并将其应用于文本

使用 Android 8.0（API 级别 26）或Jetpack Core 库时，您可以按照以下步骤从数百种字体中进行选择。

1. 在布局编辑器中，单击“设计”图标以在设计编辑器中查看您的布局。
2. 选择一个文本视图。
3. 在“属性”面板中，展开“textAppearance”，然后展开“fontFamily”框。
4. 滚动到列表底部，然后单击“更多字体”以打开“资源”对话框。
5. 在“资源”对话框中，要选择字体，请浏览列表或在顶部的搜索栏中键入。如果您在“可下载”下选择字体，则可以单击“创建可下载字体”以在运行时将字体加载为可下载字体，或者单击“将字体添加到项目”以将 TTF 字体文件打包到您的 APK 中。在“Android”下列出的字体由 Android 系统提供，因此无需下载或捆绑到您的 APK 中。
6. 单击“确定”以完成。

布局验证

布局验证是一个可视化工具，用于同时预览不同设备和显示配置的布局，帮助您在流程早期发现布局中的问题。要访问此功能，请单击 IDE 窗口右上角的“布局验证”选项卡。

图 10. 布局验证选项卡。

要在可用的配置集之间切换，请从布局验证窗口顶部的“参考设备”下拉列表中选择以下选项之一。

• 参考设备
• 自定义
• 色盲
• 字体大小

图 11. 参考设备下拉列表。

参考设备

参考设备是我们建议您针对其进行测试的一组设备。它们包括手机、可折叠设备、平板电脑和桌面界面。您应该预览您的布局在此组参考设备上的显示方式。

图 12. 布局验证工具中的参考设备预览。

自定义

要自定义要预览的显示配置，请从各种设置中进行选择，包括语言、设备或屏幕方向。

图 16. 在布局验证工具中配置自定义显示。

色盲

为了帮助使您的应用更易于色盲用户访问，请使用常见类型色盲的模拟来验证您的布局。

图 13. 布局验证工具中的色盲模拟预览。

字体大小

以各种字体大小验证您的布局，并通过使用更大字体测试您的布局来提高您的应用对视力障碍用户的可访问性。

图 14. 布局验证工具中的可变字体大小预览。