让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)。

2. 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

4. 激活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! 全文玩