Chrome 版扩展程序

安装并配置 UiPath Chrome 扩展程序以启用浏览器自动化，包括企业策略和 Chrome 149 兼容性说明。

重要提示：

UiPath Inc. 及其附属公司在使用本产品时不会处理、使用、访问或存储任何客户数据。

Chrome 更新为版本 149

Chrome 向版本 149 的更新（2026 年 6 月 2 日开始）引入了一项上游 Chromium 更改，当未明确允许开发者工具访问权限时，该更改会限制通过企业策略强制安装的扩展程序的功能。有关详细信息，请参阅此论坛帖子。

为缓解此问题，已发布以下扩展程序更新：

1. 2026 年 6 月 1 日，通过在线组策略方法安装的 Chrome 网上商店版 UiPath 扩展程序（扩展程序 ID 为 pgbnimfaaifjpebleldfhgcjdnaeafdi）已更新为 26.10 版本。此版本可向后兼容，并继续与旧版 UiPath Studio 和机器人配合使用。
2. 从 Studio 24.10.22 和 Studio 25.10.12 开始，通过离线组策略方法安装的 Chrome 扩展程序的版本（扩展程序 ID ndmegdjihnhfmljjoaiimbipfhodnbgf）已更新为 26.10 版本。早期 24.10 和 25.10 Studio 版本会安装 24.10 版本的 Chrome 扩展程序。

此扩展可帮助您在 Google Chrome 中创建浏览器自动化。

您可以通过多种方式安装此扩展程序，具体如下所示：

从 UiPath Studio 安装

1. 打开 Studio。
2. 导航至“主页”>“工具”>“UiPath 扩展程序”。
3. 选择“Chrome”>“安装”。从下拉列表中选择一种可用方法：
   • 离线组策略
   • 在线组策略
   • 所有用户
   • 当前用户
   • 仅限原生主机
4. 打开Chrome并导航到chrome://extensions
5. 根据需要，请启用 UiPath 浏览器自动化扩展程序。

结果

已在 Google Chrome 中安装适用于 Chrome 的 UiPath 扩展程序并使其处于活动状态。

从 Studio 安装程序安装

1. 运行 UiPathStudio.msi 安装程序。
2. 选择一种安装模式，然后选择“高级设置”>“扩展程序”>“适用于 Chrome 的 UiPath 扩展程序”。如果您的计算机上安装了 Chrome，则默认情况下会选中该选项。
3. 选择安装。 系统将会继续安装 Studio，同时也会安装 Chrome 扩展程序。

也可以从 UiPathStudio.msi 的命令行安装 UiPath Chrome 扩展程序。

结果

UiPath Chrome 扩展程序已安装。

从组策略安装

您也可以使用组策略来安装 UiPath Chrome 扩展程序。此方法无需用户确认即可静默安装扩展程序并启用它。

对于这两种组策略安装方法，当扩展程序使用调试器 API 时，浏览器不会显示横幅。

安装方法建议

我们建议使用组策略离线安装，因为在升级到较新版本时，扩展程序 ID 不会更改。 此方法使用由 UiPath 而非 Edge 网上应用店签名的扩展程序。这意味着在更新版本后，无需使用新的扩展程序 ID 更新内部组策略（即 ExtensionInstallForceList 策略）。

重用相同扩展程序 ID 的另一个好处是，版本更新后不会重置为扩展程序配置的设置（例如“允许匿名”或“允许访问文件 URL”）。

离线

组策略离线安装方法要求目标计算机加入 Microsoft Active Directory 域或 Azure Active Directory。

它不需要访问 Chrome 网上应用店，因此可用于受控环境中互联网访问受限的计算机。

如果满足要求，则 UiPathStudio.msi 默认使用此安装方法。

命令行安装

您也可以通过从提升的命令提示符运行来使用此安装方法：

&"C:\Program Files\UiPath\Studio\UiPath\SetupExtensions.exe" /chrome-policy-offline /silent

如果您的组织使用组策略管理浏览器扩展程序，则还需要在组织的组策略定义中进行以下更改：

1. 在“ExtensionInstallForcelist”策略中，添加值：ndmegdjihnhfmljjoaiimbipfhodnbgf;file:///C:/ProgramData/UiPath/UiPath.Common/ChromeExtension_SelfHosted/extension_manifest_chrome.xml

2. 在NativeMessagingAllowList策略中，添加值com.uipath.chromenativemsg_v2

   备注：

   仅当 NativeMessagingBlockList 策略定义为 * 时，您才需要设置 NativeMessagingAllowlist 策略值。

3. 在“开发者工具可用性允许列表”策略中，添加以下值： chrome-extension://ndmegdjihnhfmljjoaiimbipfhodnbgf

   在“开发者工具可用性阻止列表”策略中，添加值： https://uipath-devtools-blocklist-placeholder.invalid/

   备注：

   除了配置DeveloperToolsAvailabilityAllowlist和DeveloperToolsAvailabilityBlocklist之外，您还可以选择将DeveloperToolsAvailability Group Policy 设置为值1 （允许使用开发者工具），以启用完整的扩展程序功能。

   但是，我们建议使用允许列表/阻止列表策略选项，因为该选项使您能够仅指定 UiPath 扩展程序 ID，从而将更改的作用域限制在所需扩展程序内。

如果您需要在内部网上应用店中托管 UiPath 扩展程序，可以在以下位置找到 .crx 文件：
C:\Program Files\UiPath\Studio\UiPath\BrowserExtension\uipath_extension_for_chrome_self_hosted_mv3.crx

重要提示：

如果在安装后未进行这些更改，UiPath 扩展设置可能会在定期更新组策略期间被覆盖。

在线

此组策略在线安装方法要求目标计算机有权访问 Chrome 网上应用店（https://clients2.google.com/service/update2/crx 和 https://clients2.googleusercontent.com/crx）。

如果满足其要求并且计算机未加入 Microsoft Active Directory，则 UiPathStudio.msi 使用此安装方法。

您也可以通过从提升的命令提示符运行来使用此安装方法：

&"C:\Program Files\UiPath\Studio\UiPath\SetupExtensions.exe" /chromepolicyglobal /silent

如果您的组织使用组策略管理浏览器扩展程序，则还需要在组织的组策略定义中进行以下更改：

1. 在“ExtensionInstallForcelist”策略中，添加值：pgbnimfaaifjpebleldfhgcjdnaeafdi;https://clients2.google.com/service/update2/crx

2. 在NativeMessagingAllowList策略中，添加值com.uipath.chromenativemsg_v2

   备注：

   仅当 NativeMessagingBlockList 策略定义为 * 时，您才需要设置 NativeMessagingAllowlist 策略值。

3. 在“开发者工具可用性允许列表”策略中，添加以下值： chrome-extension://pgbnimfaaifjpebleldfhgcjdnaeafdi

   在“开发者工具可用性阻止列表”策略中，添加值： https://uipath-devtools-blocklist-placeholder.invalid/

   备注：

   除了配置DeveloperToolsAvailabilityAllowlist和DeveloperToolsAvailabilityBlocklist之外，您还可以选择将DeveloperToolsAvailability Group Policy 设置为值1 （允许使用开发者工具），以启用完整的扩展程序功能。

   但是，我们建议使用允许列表/阻止列表策略选项，因为该选项使您能够仅指定 UiPath 扩展程序 ID，从而将更改的作用域限制在所需扩展程序内。

重要提示：

如果在安装后未进行这些更改，UiPath 扩展设置可能会在定期更新组策略期间被覆盖。

卸载

可以通过从提升的命令提示符运行来卸载 UiPath Chrome 扩展程序：

&"C:\Program Files\UiPath\Studio\UiPath\SetupExtensions.exe" /chromecleanup /silent

您也可以通过以下方式进行卸载：打开 Studio，导航到“主页”>“工具”>“UiPath 扩展程序”，然后选择“Chrome”>“卸载”。将使用与安装相同的方法卸载扩展程序。此方法显示在“卸载”按钮旁边的已禁用下拉列表中。

Chrome 版本要求

适用于 Chrome 的 UiPath 扩展程序 MV2 需要 Chrome 64 或更高版本。

适用于 Chrome 的 UiPath 扩展程序 MV3 需要 Chrome 98 或更高版本。

使用上述任一安装方法时，系统将检查浏览器版本，并自动安装具有适当格式（MV2 或 MV3）的扩展程序。

新的扩展程序功能

自动化 Chrome 应用程序

从 UiPathStudio.msi 2022.4 开始，UiPath Chrome 扩展程序可用于自动化 Chrome 应用程序。

具有多个用户配置文件的多个 Chrome 实例

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

对于低于 2023.10 的版本，适用于 Chrome 的 UiPath 扩展程序不支持自动化同时使用多个用户配置文件运行的多个浏览器实例。因此，浏览器自动化要求您关闭 Chrome 的所有活动实例，并使用单个用户配置文件重新启动浏览器。从 2023.10 版本开始，我们可以适应在不同浏览器配置文件下运行多个浏览器进程的场景，例如特定应用程序必须在专用配置文件上运行以将敏感数据与其他应用程序隔离的情况。

备注：

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

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

对于 Chrome，必需参数为：--profile-directory="profile_path"

profile_path是为“使用应用程序/浏览器”活动指定的用户数据文件夹路径的相对路径。 如果未指定用户数据文件夹路径，则配置文件路径将相对于默认用户数据目录%LOCALAPPDATA%\Google\Chrome\User Data%。 要查找配置文件路径，请导航到 chrome://profile-internals/ 并从配置文件路径条目中检索该路径。

故障排除

您的系统管理员可能已配置了阻止 Chrome UiPath 扩展程序工作的组策略。要启用它，请按照“组策略”页面中的说明操作。

有关适用于 Chrome 的 UiPath 扩展程序的其他任何问题，请查看详细的故障排除页面。