让PyCharm和IDEA出声

首先特别感谢china_zyp的支持

问题背景

本人为视力障碍的研究生,看不见屏幕上的文字,需要通过屏幕阅读器进行程序设计。之前使用国产读屏zdsr,由于其对VSCode支持相对较好,之前通常使用VSCode进行代码编辑与调试。
但是考虑到JetBrains公司提供的各IDE会带来更好的编程体验,在china_zyp和实验室师兄的建议下决定转站JetBrains家的几款IDE。
但是,安装之后发现zdsr一声不吭,于是开始到处找办法,最终经过近1个星期的折腾,终于让IDEA和PyCharm出声了。

解决策略

具体步骤如下:

1. 下载并安装NVDA

  • JetBrains官方无障碍帮助文档我们知道这些IDE针对读屏的适配主要是用NVDA完成的,并且官方推荐视力障碍者使用Windows系统和NVDA读屏进行开发,怪不得zdsr不出声
  • 所以我们就要下载并安装NVDA了,有关NVDA下载和安装问题见如下NVDA中文站:
    NVDA中文站 https://www.nvdacn.com/

    2. 学习NVDA的使用

  • NVDA的使用习惯和国内流行的屏幕阅读器存在较大差别,需要花时间学习,推荐阅读官方用户指南,可以通过NVDA键+H+U进入。
  • 如果使用需求迫切,或者感觉用户指南晦涩难懂,可以参考如下音频教程:(来自NVDA中文站)
    新用户的福音【NVDA 入门系列课程全 5讲】
    P.S.:我学习NVDA的使用用了将近五天!

    3. 下载、安装jdk并启用jab

  1. 下载并安装jdk
    注意:前方有坑!
    由于JetBrains家的IDE是用java开发的,为了暴露出java对于windows的接口,让读屏把程序正常读出来,就需要安装java开发工具(jdk)并激活java桥(jab)
    按照JetBrains提供的帮助文档来看,装好jdk和jre并且启用jab就可以了,看起来一点都不难,可是实际上就不是那么回事了!
  • 一定要装java8以上版本的jdk!
    因为较低版本的jdk安装后内部没有集成jab,需要自行选择合适的jab进行安装,而查找版本对应关系从来不是一件容易的事!
    • 你需要根据系统版本安装适合的jdk,(Win10通常是64位,就安装64位的jdk)
      jdk1.8.0下载地址
  • 按照默认提示下一步就可以,会自动安装需要的java运行环境(jre)。
  1. JAVA_HOME环境配置
  • 安装完成后,你会听到“关闭”按钮,空格键激活,之后在桌面用上下光标键找到“此电脑”。
  • 使用键盘的'Applications'键打开快捷菜单,上下光标键切到“属性”,回车激活,进入“系统属性”窗口。
  • 随后用TAB键切到“高级系统设置”,回车激活,按'Alt+N'或者使用TAB键切到“环境变量”,进入环境变量设置窗口。
    • 接下来按住Alt+W开始添加系统变量,变量名输入JAVA_HOME,变量值输入你的jdk文件路径,如果你安装了64位的jdk,通常在'Program Files'文件夹中,如我的就在这里'C:\Program Files\Java\jdk1.8.0_281'。找到这个文件夹,打开后按住F4将光标定位到地址栏,Ctrl+A全选,Ctrl+C复制,粘贴到变量值的编辑框即可,32位的小伙伴们去'Program Files(X86)'去找哦。
      • 我们还需要在系统变量'path'中添加一下,利用TAB键将光标导航到系统变量列表中,上下光标键切换条目,听到'path'就按住Alt+I进入编辑界面,随后按住Alt+N新建一个,输入%JAVA_HOME%\bin,然后一直点击确定,直到系统属性窗口关闭。
        3. 检查环境变量配置是否成功
    • 上述步骤完成后,按住Win+R进入运行对话框,在编辑框输入cmd进入命令行。
    • 输入如下代码:
      
      java -version  ```
      听到java version "1.8.0_281"
      Java(TM) SE Runtime Environment (build 1.8.0_281-b09)
      Java HotSpot(TM) 64-Bit Server VM (build 25.281-b09, mixed mode)说明环境变量配置成功!
      Congratulations
  1. 激活jab
  • 由于java8及以上版本的jab已经集成到jre和jdk中,因此不用另外安装,我们只需要找到并激活就可以
  • 进入cmd命令行窗口,输入如下命令:
    cd %JAVA_HOME%\jre\bin

    接下来,输入如下命令:

    jabswitch -enable

    听到The Java Access Bridge has been enabled.说明jab已经成功激活了!

    4. 下载并安装所需的JetBrains家的IDE

  • 这一步就根据你的需要自行处理就可以了,我首选安装了PyCharm,PyCharm和IDEA都很常用,可以进入如下地址下载或安装:
    PyCharm下载地址 https://www.jetbrains.com/pycharm/download/
    IDEA下载地址 https://www.jetbrains.com/idea/download/
  • 下载完成后找到安装文件,回车激活即可按照提示开始安装,可以选中第三步听到的add to path,这样比较方便在命令行中使用PyCharm或者IDEA命令。

注意:千万不要通过JetBrains工具箱进行安装,否则后续会出现非常多问题,不好解决!

  • 安装完成后根据你选择的版本有不同的许可方式,如果安装了社区版不用激活,如果安装了PyCharm或IDEA专业版就需要激活,我用了edu邮箱进行了学生认证,期限一年,来年如果仍然是学生可以继续通过此法获得许可。
  • 安装成功后就可以在开始菜单找到JetBrains文件夹,回车进入,上下光标键找到PyCharm或者IDEA回车激活即可。
  • 随后你会听到Welcome to PyCharm,说明安装成功,你可以用TAB键来回切换试一试,如果听到New Project、树视图等说明你马上就可以通过JetBrains家的IDE听代码了!
    Congratulations

    5. 完成必要设置,开启你的听代码之旅

  • 在第一次启动PyCharm或者IDEA时可能会听到一个对话框内容大致是Enable Screen Readers,这时候你可以直接用TAB键切到enable按钮,空格激活即可。
  • 我的就没有那样的对话框,所以可以按照这样的办法手动激活PyCharm和IDEA对屏幕阅读器的支持。
  • 在欢迎界面用TAB键切到一个列表,Welcome Screen Categories,上下光标键找到Customize,使用TAB键切到Configure按钮,空格激活,就会进入一个设置窗口,使用TAB键切到Settings Categories树视图,上下光标键找到Appearance & Behavior,按住右光标键展开,上下光标键找到Appearance,用TAB键切换,直到听到Support screen readers复选框未选中,按空格键将它选中,继续用TAB键切到OK按钮,空格激活即可。
  • 如果你按照上一步操作,听到的是Support screen readers复选框已选中,那你的PyCharm或IDEA对于屏幕阅读器的支持已经启用,你只需要通过TAB键切到OK按钮,空格激活即可。
  • 这时候你就可以新建一个工程试试看啦!!!
    Congratulations!

    后记

    注意:这些IDE适合用NVDA的对象浏览模式,否则只用TAB可能会错过一些重要按钮,另外某些设置窗口存在焦点陷入,这时候也需要使用对象浏览模式访问需要的内容。不熟悉时可以连续按两下Shift键进入Search Everywhere搜索自己需要的内容或者操作。
    其实这时候我们因为看不到,虽然能听到一些东西,但是对于这些IDE的布局还是不太了解,最好可以有一个健视者帮忙解释一下哦。
    所以最后特别感谢@china_zyp在百忙之中抽出3个多小时帮我讲PyCharm的布局和基本使用,给你加鸡腿哦!

End! 全文玩

标签: none

已有 5 条评论

  1. 有一个简单的启用 ZDSR 对 JAVA 软件支持的方法。操作方法如下:
    1. 在 ZDSR 安装根目录“WindowsAccessBridge-ZD.dll”,将其重命名为 “WindowsAccessBridge-32.dll”。
    2. 启动一次 NVDA ,目的是创建 JAB 的配置文件。
    3. 重新启动 ZDSR和需要朗读的 JAVA 程序。
    祝你幸运。

  2. 路过的 路过的

    很早就玩过,但是还是有些坑,比如pycharm的控制台就没啥声音。

  3. 刘逸晖 刘逸晖

    你好,感觉你挺厉害的,能留个联系方式和你交流一下吗?

  4. 刘逸晖 刘逸晖

    2794074976

  5. jimmy jimmy

    还是感觉vscode+终端这个组合最通用, 什么语言都能用, 坑少.

添加新评论