无障碍功能

本文档介绍了 Android Studio 2.2 及更高版本中的无障碍功能。

屏幕阅读器兼容性

目前,只有 Windows 上的 Android Studio 支持屏幕阅读器。

Windows 支持各种屏幕阅读器,但与 Android Studio 的兼容性各不相同:

  • NVDA:建议您使用 NVDA 2015 或更高版本,因为这款屏幕阅读器是我们在开发 Android Studio 无障碍支持功能的过程中主要参考的阅读器。如果您使用 32 位版本的 NVDA,则必须在计算机上安装 32 位 JRE,因为此版本的 NVDA 需要 C:\Windows\SysWOW64\WindowsAccessBridge-32.DLL 才能与 Android Studio 搭配使用。如果 NVDA 找不到此文件,则其事件日志窗口会显示“Java Access Bridge not available”这一错误消息。
  • JAWS:我们建议您不要搭配 Android Studio 使用 JAWS,因为您可能会遇到严重的性能问题(如果您在使用 JAWS 时在 Android Studio 的某些位置导航)。
  • Windows Eyes:我们建议您不要搭配 Android Studio 使用 Windows Eyes,因为在设置过程中,Windows Eyes 会使用与 Android Studio 不兼容的旧版本来覆盖计算机上所有 JDK 和 JRE 的无障碍功能库。
  • 内置的 Windows Narrator:我们建议您不要使用 Windows Narrator,因为它通常与 Java 无障碍功能不兼容。

激活对屏幕阅读器的支持

要在 Windows 计算机上使用 Android Studio 设置屏幕阅读器,请按以下步骤操作:

  1. 安装屏幕阅读器。
  2. 确保您已针对屏幕阅读器安装了正确的 Java 版本,如下所示:

    • 如果屏幕阅读器为 32 位,请安装 32 位 JRE 版本 1.7 或更高版本。
    • 如果屏幕阅读器为 64 位,请安装 64 位 JRE 版本 1.7 或更高版本。
  3. 要开启 Java Access Bridge,请打开命令提示符并输入 JRE_HOME\bin\jabswitch -enable,其中 JRE_HOME 是计算机上 JRE 的目录。

  4. 您的计算机可能具有 Java Access Bridge 的某些重要组件的多个版本,而各个版本之间可能存在兼容性问题。要验证 Java Access Bridge 配置是否正确,请确认您具有以下重要文件的正确版本,如下所述:

    如果屏幕阅读器为 32 位:

    • 请确保 C:\Windows\SysWOW64\WindowsAccessBridge-32.DLL 存在且版本号为 7.xxx 或更高。该文件的描述应为“Java(TM) Platform SE 7”。
    • 请确认 JRE_HOME\lib\ext\access-bridge-64.jarJRE_HOME\jre\lib\ext\jaccess.jar 文件(其中 JRE_HOME 是计算机上 JRE 的主目录)的修改日期与其目录中其他文件的修改日期相同。如果这些文件的最后修改日期与其各自目录中其他文件的修改日期不同,则它们可能已被 Windows Eyes 安装程序覆盖;在这种情况下,您必须重新安装 JDK/JRE 以确保您运行的是这些文件的正确版本。

    如果屏幕阅读器为 64 位:

    • 请确保 C:\Windows\System32\WindowsAccessBridge-64.DLL 存在且版本号为 7.xxx 或更高。该文件的描述应为“Java(TM) Platform SE 7”。
    • 请确认 JRE_HOME\lib\ext\access-bridge-64.jarJRE_HOME\jre\lib\ext\jaccess.jar 文件(其中 JRE_HOME 是计算机上 JRE 的主目录)的修改日期与其目录中其他文件的修改日期相同。如果这些文件的最后修改日期与其各自目录中其他文件的修改日期不同,则它们可能已被 Windows Eyes 安装程序覆盖;在这种情况下,您必须重新安装 JDK/JRE 以确保您运行的是这些文件的正确版本。
  5. 要在 Android Studio 中激活对屏幕阅读器的支持,请依次点击 File > Settings > Appearance & Behavior > System Settings,选中 Support screen readers 复选框,然后重启 Android Studio。此设置可确保为屏幕阅读器用户优化 Android Studio 体验,例如自定义键盘导航方式。如果您正在使用 Jaws,请记住在启动 Android Studio 之前必须启动 Jaws 才能使此设置生效。

使用键盘

您可以使用键盘快捷键浏览 Android Studio 中的所有控件。

注意:要通过键盘访问某些 Android Studio 元素,您必须使用屏幕阅读器的对象导航(或类似)功能。如需对象导航或等效功能方面的帮助,请查看屏幕阅读器文档,例如 NVDA 用户指南

本节包含用于在 Android Studio 中导航的最实用的键盘快捷键。要查看默认 Android Studio 键盘快捷键的完整指南,请参阅键盘快捷键

激活主菜单

要打开主菜单和其他顶级菜单,请使用以下快捷键:

  • 要打开主菜单,请按 F10。
  • 要在 Windows 计算机上打开顶级菜单,请按 Alt+[助记符]。例如,要打开“File”菜单,请按 Alt+F。

要在文件和工具窗口之间导航,请使用以下快捷键:

  • 要移至某个工具窗口,请按 Alt+[数字](在 Mac 上,按 Command+[数字])。例如,要移至“Project structure”工具窗口,请按 Alt+0(在 Mac 上,按 Command+0)。
  • 要在文件和工具窗口之间移动,请按 Control+Tab(在 Mac 上,按 Command+Tab)。要在所有条目之间移动,请按住 Control+Tab。

使用导航栏

借助导航栏,您可以使用以下快捷键在项目中的各文件之间移动:

  • 要激活导航栏,请按 Alt+Home(在 Mac 上,按 Option+Fn+向左键)。
  • 要在导航层次结构中的各个项之间切换,请按向左箭头键或向右箭头键。
  • 要打开一个显示当前项所含内容的弹出式窗口,请按空格键。

停用代码折叠

默认情况下,Android Studio 编辑器会将部分文本折叠为可扩展区域。例如,Java 源文件开头的“导入”列表会被折叠成一行,其中包含文本“import …”。

使用屏幕阅读器时,代码折叠会增加导航难度。要修改代码折叠选项,请依次点击 File > Settings > Editor > General > Code Folding(在 Mac 上,依次点击 File > Properties > Editor > General > Code Folding)。

停用自动插入功能

默认情况下,Android Studio 会自动插入右大括号、引号或括号。

使用屏幕阅读器时,自动插入功能可能没什么用。要修改自动插入选项,请依次点击 File > Settings > Editor > General > Smart Keys(在 Mac 上,依次点击 File > Properties > Editor > General > Smart Keys)。

停用自动代码填充弹出式窗口

默认情况下,Android Studio 会在用户输入某些按键时自动显示代码填充弹出式窗口,如果仅找到一个匹配项,则会自动插入该匹配项。使用屏幕阅读器时,此行为可能会对用户造成困扰。

要修改代码填充功能的自动弹出选项和自动插入选项,请依次点击 File > Settings > Editor > General > Code Completion(在 Mac 上,依次点击 File > Properties > Editor > General > Code Completion)。

访问错误、警告和代码检查结果

您可以使用键盘查看和浏览错误、警告和代码检查结果。

查看项目内所有文件中的错误

当您依次点击 Build > Make Project 后,所有警告和错误都会显示在 Messages 窗口中。从 Android Studio 2.2 开始,屏幕阅读器可以访问 Messages 窗口(查看错误历史记录)。

要在 Messages 窗口中查看错误,请使用以下快捷键:

  • 要激活 Messages 窗口,请按 Alt+0(在 Mac 上,按 Option+0)。
  • 要浏览所有消息,请按向上箭头和向下箭头。

或者,您可以使用文本编辑器查看和浏览所有错误。要使用编辑器查看错误,请按 Control+Alt+向上/向下键(在 Mac 上,按 Command+Option+向上/向下键)。

在单个文件中查看错误和代码检查结果

要在单个文件中查看错误,请使用以下快捷键:

  • 要转到下一个或上一个错误,请按 F2 或 Ctrl+F2(在 Mac 上,按 Command+F2)。
  • 要打开包含错误消息的工具提示,请按 Ctrl+F1(在 Mac 上,按 Command+F1)。

要转到所有代码检查结果(而不仅仅是错误),请依次点击 File > Settings > Editor > General(在 Mac 上,依次点击 File > Preferences > Editor > General),然后取消选中 'Next error' action goes to high priority problems only

使用制表符缩进

默认情况下,Android Studio 会使用空格字符进行缩进。屏幕阅读器用户可能更喜欢使用制表符缩进,因为这样语言表达更简洁。

要更改为制表符缩进,请依次点击 File > Settings > Editor > Code Style > Java > Tabs and Indents(在 Mac 上,依次点击 File > Preferences > Editor > Code Style > Java > Tabs and Indents),然后选中 Use tab character 复选框。

使用布局编辑器

在 Android Studio 2.2 及更高版本中,用户暂时只能使用布局编辑器的部分功能(查看错误历史记录)。临时解决方法是让系统默认在文本模式下打开布局文件(查看错误历史记录)。

要让系统默认以文本视图模式打开布局文件,请依次点击 File > Settings > Editor > Layout Editor(在 Mac 上,依次点击 File > Preferences > Editor > Layout Editor),然后选中 Prefer XML Editor 复选框。