故障排除

备注：

您需使用 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 未运行：

4. 在 Mozilla Firefox 中，转到“about:addons”>“扩展程序”。

5. 通过单击“删除”按钮手动删除 UiPath 扩展程序。

6. 按照此处的说明，重新安装。

如果上面的信息未能解决您的问题，您可以尝试通过查看追踪，并分析 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 位)值”，然后提供上述值。

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

5. 打开注册表编辑器。

6. 导航到 HKEY_CURRENT_USER\SOFTWARE\Mozilla\NativeMessagingHosts\com.uipath.chromenativemsg 键。

7. 打开 (Default) 的 REG_SZ 值。系统将显示“编辑字符串”窗口，且其中应包含类似于 C:\Users\YOUR_USER_NAME\AppData\Local\UiPath\uipath-ff.json 的路径。

8. 使用文本编辑器（如 Notepad++）在上面找到的路径上打开 .json 文件。

9. 检查“路径”属性是否正确指向 ChromeNativeMessaging.exe 的所在位置，类似于 C:\Program Files (x86)\UiPath Studio\UiPath\BrowserExtension\ChromeNativeMessaging.exe。

多个浏览器配置文件

从 UiPath 版本 2023.10 开始，适用于 Firefox 的 Uipath 扩展程序支持自动化同时使用多个用户配置文件运行的多个浏览器实例。

备注：

自动化多个浏览器配置文件需要 UiPath.UIAutomation.Activities v23.10 或更高版本，以及通过 UiPathStudio.msi v23.10 或更高版本安装的浏览器扩展程序。

使用“使用应用程序/浏览器”活动时，现在可以使用特定的配置文件打开浏览器。要在浏览器启动时指定配置文件，您必须将参数附加到浏览器命令行中。为此，请使用“统一应用程序目标”输入部分中的“参数”属性。

对于 Firefox，必需参数为：-profile "full_profile_path"。要检索完整的配置文件路径，请导航至 about:profiles 并检索该配置文件的根目录。