布局编辑器使您可以通过将 UI 元素拖动到视觉设计编辑器中(而不是编写布局 XML)来快速构建基于 View
的布局。设计编辑器可以在不同的 Android 设备和版本上预览您的布局,您可以动态调整布局大小以确保它在不同的屏幕尺寸上都能正常运行。
在 使用 ConstraintLayout
构建布局 时,布局编辑器尤其强大。
本页概述了布局编辑器。要了解有关布局基本原理的更多信息,请参阅 布局。
布局编辑器简介
当您打开 XML 布局文件时,布局编辑器会显示。
- 调色板:包含您可以拖放到布局中的各种视图和视图组。
- 组件树:显示布局中组件的层次结构。
- 工具栏:包含用于配置布局在编辑器中的外观以及更改布局属性的按钮。
- 设计编辑器:允许您在设计视图、蓝图视图或两者中编辑布局。
- 属性:包含所选视图属性的控件。
- 视图模式:允许您以代码 、拆分 或设计 模式查看布局。拆分模式同时显示代码和设计窗口。
- 缩放和平移控件:控制预览的大小和在编辑器中的位置。
当您打开 XML 布局文件时,设计编辑器默认打开,如图 1 所示。要编辑文本编辑器中的布局 XML,请单击窗口右上角的代码 按钮。请注意,在代码视图中编辑布局时,调色板、组件树和属性面板不可用。
提示: 要在设计编辑器和文本编辑器之间切换,请按 Alt
(在 macOS 上为 Control
)加上 Shift
以及向右或向左箭头键。
更改预览外观
设计编辑器顶行中的按钮允许您配置布局在编辑器中的外观。
- 设计和蓝图:选择您希望如何在编辑器中查看布局。您也可以按
B
在这些视图类型之间循环。- 选择设计以查看布局的渲染预览。
- 选择蓝图仅查看每个视图的轮廓。
- 选择设计 + 蓝图以并排查看这两种视图。
- 屏幕方向和布局变体:在横向或纵向屏幕方向之间选择,或者选择您的应用提供替代布局的其他屏幕模式,例如夜间模式。此菜单还包含用于创建新的布局变体的命令,如本页的某一节所述。您也可以按键盘上的字母
O
来更改方向。 系统 UI 模式:如果您在应用中启用了动态颜色,请切换壁纸,看看您的布局如何对不同用户选择的壁纸做出反应。请注意,您必须先将主题更改为 Material 动态颜色主题,然后更改壁纸。
设备类型和尺寸:选择设备类型(手机/平板电脑、Android TV 或 Wear OS)和屏幕配置(尺寸和密度)。您可以从几个预配置的设备类型和您自己的 AVD 定义中选择,也可以通过从列表中选择添加设备定义来创建一个新的 AVD,如图 3 所示。
- 要调整设备大小,请拖动布局的右下角。
- 按
D
在设备列表中循环。
针对此菜单中的参考设备测试您的布局有助于您的应用在真实设备上的布局状态下良好地扩展。
API 版本:选择 Android 版本以预览布局。可用的 Android 版本列表取决于您使用 SDK 管理器安装了哪些 SDK 平台版本。
应用主题:选择要应用于预览的 UI 主题。这仅适用于受支持的布局样式,因此此列表中的许多主题会导致错误。
语言:选择用于 UI 字符串的语言。此列表仅显示字符串资源中可用的语言。如果您想编辑翻译,请从菜单中单击编辑翻译。有关使用翻译的更多信息,请参阅使用翻译编辑器本地化 UI。
创建新的布局
为您的应用添加新的布局时,首先在项目的默认 layout/
目录中创建一个默认布局文件,以便它适用于所有设备配置。拥有默认布局后,您可以创建布局变体(如本页的某一节所述)以用于特定的设备配置,例如大屏幕。
您可以通过以下几种方式之一创建新的布局
使用 Android Studio 的主菜单
- 在项目窗口中,单击要添加布局的模块。
- 在主菜单中,选择文件 > 新建 > XML > 布局 XML 文件。
- 在出现的对话框中,提供文件名、根布局标签以及布局所属的源代码集。
- 单击完成以创建布局。
使用项目视图
- 从项目窗口中选择项目视图。
- 右键单击要添加布局的布局目录。
- 在出现的上下文菜单中,单击新建 > 布局资源文件。
使用 Android 视图
- 从项目窗口中选择Android 视图。
- 右键单击
layout
文件夹。 - 在出现的上下文菜单中,选择新建 > 布局资源文件。
使用资源管理器
- 在资源管理器中,选择布局选项卡。
- 单击
+
按钮,然后单击布局资源文件。
使用布局变体优化不同屏幕
布局变体是现有布局的替代版本,针对特定屏幕尺寸或方向进行了优化。
使用建议的布局变体
Android Studio 包含您可以用于项目的常用布局变体。要使用建议的布局变体,请执行以下操作
- 打开默认布局文件。
- 单击窗口右上角的设计 图标。
- 布局文件名称将显示在用于切换和创建布局文件限定符的操作下拉菜单中。选择下拉菜单。
- 在下拉列表中,选择一个变体,例如创建横向限定符或创建平板电脑限定符。
将创建一个新的布局目录。
创建您自己的布局变体
如果您想创建您自己的布局变体,请执行以下操作
- 打开默认布局文件。
- 单击窗口右上角的设计 图标。
- 布局文件名称将显示在用于切换和创建布局文件限定符的操作下拉菜单中。选择下拉菜单。
在下拉列表中,选择添加资源限定符。(请参阅上图中的图 4。)
将出现选择资源目录对话框。
在选择资源目录对话框中,定义变体的资源限定符
- 从可用限定符列表中选择一个限定符。
- 单击添加 按钮。
- 输入任何必需的值。
- 重复这些步骤以添加其他限定符。
添加完所有限定符后,单击确定。
当您具有相同布局的多个变体时,您可以通过从用于切换和创建布局文件限定符的操作下拉菜单中选择一个变体来在它们之间切换。
有关如何为不同屏幕创建布局的更多信息,请参阅支持不同的屏幕尺寸。
转换视图或布局
您可以将一个视图转换为另一种类型的视图,也可以将一个布局转换为另一种类型的布局
- 单击编辑器窗口右上角的设计按钮。
- 在组件树中,右键单击视图或布局,然后单击转换视图。
- 在出现的对话框中,选择新的视图或布局类型,然后单击应用。
将布局转换为 ConstraintLayout
为了提高布局性能,请将旧的布局转换为ConstraintLayout
。 ConstraintLayout
使用基于约束的布局系统,允许您构建大多数布局而无需任何嵌套视图组。
要将现有布局转换为 ConstraintLayout
,请执行以下操作
- 在 Android Studio 中打开现有布局。
- 单击编辑器窗口右上角的设计 图标。
- 在组件树中,右键单击布局,然后单击将
your-layout-type
转换为 ConstraintLayout。
要了解有关 ConstraintLayout
的更多信息,请参阅使用 ConstraintLayout 构建响应式 UI。
在调色板中查找项目
要在调色板中按名称搜索视图或视图组,请单击调色板顶部的搜索 按钮。或者,您可以在调色板窗口获得焦点时键入项目的名称。
在调色板中,您可以在常用类别中找到常用的项目。要将项目添加到此类别,请右键单击调色板中的视图或视图组,然后在上下文菜单中单击收藏。
从调色板打开文档
要打开视图或视图组的 Android 开发者参考文档,请在调色板中选择 UI 元素,然后按 Shift
+F1
。
要查看视图或视图组的 Material 指南文档,请右键单击调色板中的 UI 元素,然后从上下文菜单中选择Material 指南。如果该项目没有特定条目,则该命令将打开Material 指南文档的主页。
将视图添加到布局
要开始构建布局,请将视图和视图组从调色板拖放到设计编辑器中。当您将视图放置在布局中时,编辑器将显示有关视图与布局其余部分之间关系的信息。
如果您使用的是 ConstraintLayout
,您可以使用“推断约束”和“自动连接”功能自动创建约束。
编辑视图属性
您可以从布局编辑器的 属性 面板编辑视图属性。此窗口仅在设计编辑器打开时可用,因此请以 设计 或 拆分 模式查看您的布局以使用它。
当您选择一个视图时,无论是通过单击 组件树 中的视图还是设计编辑器中的视图,属性 面板都会显示以下内容,如图 5 所示
- 声明的属性:列出布局文件中指定的属性。要添加属性,请单击该部分顶部的 添加 按钮。
- 布局:包含用于控制视图宽度和高度的控件。如果视图位于
ConstraintLayout
中,此部分还会显示约束偏差并列出视图使用的约束。有关使用ConstraintLayout
控制视图大小的更多信息,请参阅调整视图大小。 - 通用属性:列出所选视图的通用属性。要查看所有可用属性,请展开窗口底部的 所有属性 部分。
- 搜索:允许您搜索特定视图属性。
每个属性值右侧的图标指示属性值是否为资源引用。当值为资源引用时,这些指示器为实心 ,而当值为硬编码时,这些指示器为空 ,帮助您一眼就能识别出硬编码值。
单击任何状态下的指示器以打开 资源 对话框,您可以在其中选择相应属性的资源引用。
属性值周围的红色突出显示表示该值存在错误。例如,错误可能表示布局定义属性的条目无效。
橙色突出显示表示该值的警告。例如,当您在预期使用资源引用的地方使用硬编码值时,可能会出现警告。
向您的视图添加示例数据
由于许多 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 库 时,您可以通过以下步骤从数百种字体中进行选择
- 在布局编辑器中,单击 设计 图标以在设计编辑器中查看您的布局。
- 选择一个文本视图。
- 在 属性 面板中,展开 textAppearance,然后展开 fontFamily 框。
- 滚动到列表底部,然后单击 更多字体 以打开 资源 对话框。
- 在 资源 对话框中,要选择字体,请浏览列表或在顶部的搜索栏中键入。如果您选择 可下载 下的字体,那么您可以单击 创建可下载字体 以在运行时将字体加载为 可下载字体,也可以单击 将字体添加到项目 以将 TTF 字体文件打包到您的 APK 中。Android 下列出的字体由 Android 系统提供,因此无需下载或捆绑到您的 APK 中。
- 单击 确定 以完成。
布局验证
布局验证是一个可视化工具,用于同时预览不同设备和显示配置的布局,帮助您在流程早期发现布局中的问题。要访问此功能,请单击 IDE 窗口右上角的 布局验证 选项卡
图 10. 布局验证选项卡。
要在可用配置集之间切换,请从布局验证窗口顶部的 参考设备 下拉菜单中选择以下内容之一
- 参考设备
- 自定义
- 色盲
- 字体大小
图 11. 参考设备下拉菜单。
参考设备
参考设备是我们建议您针对其进行测试的一组设备。它们包括手机、折叠式设备、平板电脑和桌面界面。您应该预览您的布局在这组参考设备上的显示效果
图 12. 布局验证工具中的参考设备预览。
自定义
要自定义要预览的显示配置,请从各种设置中进行选择,包括语言、设备或屏幕方向
图 16. 在布局验证工具中配置自定义显示。
色盲
为了帮助让您的应用程序更方便色盲用户使用,请使用常见类型色盲的模拟验证您的布局
图 13. 布局验证工具中的色盲模拟预览。
字体大小
以各种字体大小验证您的布局,并通过使用更大字体测试您的布局,提高您的应用程序对视力障碍用户的可访问性
图 14. 布局验证工具中的可变字体大小预览。