Java 扩展程序故障排除

本页面介绍了 UiPath Java 扩展程序可能无法正常工作的常见原因，以及针对这些问题的解决方案。

检查 Java 扩展程序是否正常工作

检查 UiPath Studio 是否可以检索有效的 Java 选取器

要检查扩展程序是否正常工作，请打开用户界面探测器并尝试在 Java 应用程序中选择控件。如果选择了整个窗口，这意味着扩展程序不能正常工作。

如果可以选择控件，但控件的选取器看起来像

<wnd app=”...” /><ctrl role=”client” /> instead of <wnd app=”...” /><java role=”...” />, then the extension is not working properly.

请注意，UiPath Java 扩展程序只能兼容 AWT 应用程序（例如 Java Swing、Oracle Forms、Fujitsu JBK），而 SWT 应用程序则是通过主动式辅助实现自动化。要检测 Java 应用程序的类型，请检查用户界面探测器中的 cls 属性（窗口类名）。类名应该类似于 SunAwtFrame 或 javax.swing。

检查 Java 应用程序是否加载了扩展程序文件

1. 打开进程资源管理器。
2. 在视图菜单中，选择“下方窗格视图”>“DLLS”，或按 Ctrl+D。窗口下半部分将显示一个面板。
3. 选择 Java 应用程序的进程，并检查 Java 应用程序加载的是 UiPathJavaBridgeV8.dll 还是 UiPathJavaBridgeV8_x64.dll。
4. 检查是从哪个路径加载 java.dll 模块。普通 JRE 的路径类似于 C:\Program Files (x86)\Java\jre1.8.0_xx\bin\java.dll。自定义 JRE 通常位于应用程序文件夹中。

检查扩展程序文件是否已添加到 JRE 中

• 使用文本编辑器（如 Notepad++）打开位于 C:\Program Files (x86)\Java\jre1.8.0_xx\lib 文件夹中的 accessibility.properties 文件。如果扩展程序已正确安装，则文件应包含 assistive_technologies=UiPath.UiPathBridge。
• 在 C:\Program Files (x86)\Java\jre1.8.0_xx\lib\ext 文件夹中，您应该会找到 UiPathBridge.jar 文件。
• 在 C:\Program Files (x86)\Java\jre1.8.0_xx\bin 文件夹中，您应该找到 UiPathJavaBridgeV8.dll 或 UiPathJavaBridgeV8_x64.dll。
  注意：如果没有满足前面的任何要求，您可以尝试重新安装上述扩展程序，或者手动修复。

如果目标应用程序执行 JNI 代码，则不要调用 DestroyJavaVM()，因为用户线程在 UiPath Java 扩展程序 DLL 中运行。

使用 Java 9+ JRE 应用程序

重要提示：这适用于版本低于 22.2 的 UIAutomation 包。

对于 Java 9 之前的版本，Java 运行时环境 (JRE) 已包含 jdk.attach 模块，该模块可与 UiPath Java 扩展程序交互以生成相应选取器。对于 Java 9+，仅 Java 开发工具包 (JDK) 中包含此模块。

已为所有使用 Java JDK 打开的 Java 9+ 应用程序生成选取器。不过，若要创建自动化项目以与使用 Java JRE 打开的应用程序进行交互，您需在目标 JRE 中手动添加 jdk.attach 模块。

注意：对于使用 Java JDK 打开的 Java 9+ 应用程序，UiPath Java 扩展程序适用于 Windows 企业版和非企业版。对于使用 Java JRE 打开的应用程序，UiPath Java 扩展程序仅适用于 Windows 非企业版。

禁用 Java Access Bridge

启用 Java Access Bridge 后，系统会在当前用户的主目录中创建 accessibility.properties 文件，该文件将覆盖默认网桥加载的辅助功能网桥。解决方案是禁用 Java Access Bridge 并删除 accessibility.properties 文件，如下所示：

1. 转到“控制面板”>“轻松访问中心”>“使计算机更易于查看”。
2. 滚动到页面底部的“其他安装的程序”部分。
3. 确保未选中“启用 Java Access Bridge”框。
   
   

   

   
   
4. 如果选中了“启用 Java Access Bridge”框，请转到 C:\Users\current_user。
5. 删除 .accessibility.properties 文件。
   注意：如未显示“启用 Java Access Bridge”选项，则需重新安装或更新 Java。