Firefox 扩展程序故障排除

注意：您需使用 Firefox 52.0 版及更高版本，才能执行浏览器自动化。

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

较旧的 Firefox 版本的扩展程序

描述

Mozilla 在 Firefox 中引入了扩展程序签名验证算法，该算法会禁用 Firefox 65.0 版及更低版本的插件。因此，如果您在 65.0 版或更低版本的浏览器上安装适用于 Firefox 的 UiPath 扩展程序，将显示以下错误消息：

This add-on could not be installed because it appears to be corrupt.

解决方案 1

将 Firefox 更新到版本 v66.0.4 或更高版本。

解决方案 2

从 Studio 2020.8 开始，Firefox 扩展程序是新签名的，应该可以在较旧版本的 Firefox 浏览器上正确安装。

检查扩展程序

检查 UiPath Firefox 扩展程序是否已安装并启用：

1. 在 Mozilla Firefox 中，转到“about:addons”>“扩展程序”。
2. 如果扩展程序不存在，请按这里的说明来安装。
3. 确保 UiPath 扩展程序已更新为最新版本。

为防止可能出现的问题：

1. 在 Mozilla Firefox 中，转到“about:addons”>“扩展程序”。
2. 打开任务管理器或进程资源管理器。
3. 检查 ChromeNativeMessaging.exe 进程是否正在运行：
   注意：一个单独的 ChromeNativeMessaging 实例会针对 Chrome 扩展程序运行，所以在执行此检查时需要关闭 Google Chrome。

如果 ChromeNativeMessaging 未在运行：

1. 在 Mozilla Firefox 中，转到“about:addons”>“扩展程序”。
2. 通过单击“删除”按钮手动删除 UiPath 扩展程序。
3. 按照此处的说明，重新安装。

如果上面的信息未能解决您的问题，您可以尝试通过查看追踪，并分析 UiPath 扩展程序抛出的错误，从而获得其他信息。以下是您可以收集和分析的追踪类型：

适用于 Google Chrome 中的一般扩展程序追踪：

转到“打开”菜单 >“网页开发者”>“浏览器控制台”(Ctrl+Shift+J)。将显示“浏览器控制台” 。此处显示扩展程序生成的所有错误。

对于要自动化的网页生成的追踪：

转到“打开”菜单 >“网页开发者”>“网页控制台”(Ctrl+Shift+K)。系统将显示网页控制台。当前网页的所有错误都将显示在此处。

对于完整追踪（不仅限于错误），请执行以下操作：

1. 打开注册表编辑器。
2. 导航到 HKEY_CURRENT_USER\SOFTWARE\UiPath 键。
3. 双击网页扩展程序跟踪 REG_DWORD 值。系统将显示编辑 DWORD 值窗口。
4. 在值数据字段中，将值更改为 1，然后单击“确定”。值即已保存。
   注意：如果 WebExtensionTrace REG_DWORD 值不存在，则必须创建此值，方法是在右侧面板中单击右键，选择“新建”>“DWORD（32 位）值”，然后提供上述值。

检查注册表编辑器中是否缺少某些数据：

1. 打开注册表编辑器。
2. 导航到 HKEY_CURRENT_USER\SOFTWARE\Mozilla\NativeMessagingHosts\com.uipath.chromenativemsg 键。
3. 打开 (Default) REG_SZ 值。系统将显示编辑字符串窗口，且其中应包含类似于 C:\Users\YOUR_USER_NAME\AppData\Local\UiPath\uipath-ff.json 的路径。
4. 使用文本编辑器（如 Notepad++）在上面找到的路径上打开 .json 文件。
5. 检查路径属性是否正确指向 ChromeNativeMessaging.exe 的所在位置，类似于 C:\Program Files (x86)\UiPath Studio\UiPath\BrowserExtension\ChromeNativeMessaging.exe。