Chrome 版扩展程序

重要提示：

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

重要提示：

Chrome 正在继续向 MV3 扩展程序的转换。 最早于 2024 年 6 月，Chrome 将开始在 Chrome 127 及更高版本中禁用“Manifest V2 扩展程序”的预稳定版本（Dev、Canary 和 Beta）。使用 ExtensionManifestV2Availability 策略以确保 Manifest V2 扩展程序在其组织中持续运行的企业将有一年的时间（直到 2025 年 6 月）在其组织中迁移 Manifest V2 扩展程序。在此之前，启用了策略的浏览器不会受到弃用版的影响。 在此处查看 Chrome 迁移到 MV3 扩展程序的完整时间表。 由旧版本 UiPathStudio.msi 安装的 UiPath Chrome MV2 扩展程序将在 Chrome 中停止工作。我们强烈建议在发生此问题之前升级 UiPath Studio 和 Robot 安装。从以下 UiPathStudio.msi 版本开始，UiPath Chrome MV3 扩展程序可用：

• 2022.10
• 2022.4
• 2021.10.8+
• 2020.10.14+
• 2019.10.9+

这些版本可从以下位置下载：

• UiPath Customer Portal 中的产品下载。
• UiPath Automation Cloud 中的资源中心。要访问资源中心，您需要登录 Automation Cloud 组织，然后单击左侧导航栏上的“帮助”按钮。

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

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

从 UiPath Studio 安装

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

从 Studio 安装程序安装

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

也可以从 UiPathStudio.msi 的命令行安装 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. 在“扩展程序安装强制列表”策略中，添加以下值：

ndmegdjihnhfmljjoaiimbipfhodnbgf;file:///C:/ProgramData/UiPath/UiPath.Common/ChromeExtension_SelfHosted/extension_manifest_chrome.xml. 2. 在 NativeMessagingAllowList 策略中，添加值：com.uipath.chromenativemsg_v2

  :::note
  You only need to set the `NativeMessagingAllowlist` policy value when the `NativeMessagingBlockList` policy is defined with the value of **`*`**.
  :::

如果您需要在内部网上应用店中托管 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. 在“扩展程序安装强制列表”策略中，添加以下值：

pgbnimfaaifjpebleldfhgcjdnaeafdi;https://clients2.google.com/service/update2/crx. 2. 在 NativeMessagingAllowList 策略中，添加值：com.uipath.chromenativemsg_v2

  :::note
  You only need to set the `NativeMessagingAllowlist` policy value when the `NativeMessagingBlockList` policy is defined with the value of **`*`**.
  :::

重要提示：

如果在安装后未进行这些更改，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 扩展程序的其他任何问题，请查看详细的故障排除页面。