Chrome 版扩展程序

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

重要提示：

Chrome 正在继续向 MV3 扩展程序过渡。Chrome 最早将于 2024 年 6 月开始在 Chrome 127 及更高版本的预稳定版 Chrome（Dev、Canary 和 Beta）中禁用 Manifest V2 扩展程序。

使用 ExtensionManifestV2Availability 策略确保 Manifest V2 扩展程序在组织中继续运行的企业将有额外的一年时间（直到 2025 年 6 月）迁移组织中的 Manifest V2 扩展程序。在此之前，已启用该策略的浏览器不会受到弃用功能的影响。

请在此处查看 Chrome 迁移到 MV3 扩展程序的完整时间表：

旧版 UiPathStudio.msi 安装的适用于 Chrome 的 UiPath 扩展程序 MV2 将停止在 Chrome 中运行。我们强烈建议在此截止日期之前升级您的 UiPath Studio 和 UiPath Robot 安装。

适用于 Chrome 的 UiPath 扩展程序 MV3 在以下 UiPathStudio.msi 版本中可用：

• 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 而非 Chrome 网上应用店签名的扩展程序。 这意味着在更新版本后，无需使用新的扩展程序 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. 在本地消息白名单策略中，添加值 com.uipath.chromenativemsg_v2。

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

C:\Program Files\UiPath\Studio\UiPath\BrowserExtension\uipath_extension_for_chrome_self_hosted_mv3.crx 。

在线

此组策略在线安装方法要求目标计算机有权访问 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. 在本地消息白名单策略中，添加值 com.uipath.chromenativemsg_v2。

卸载

可以通过从提升的命令提示符运行来卸载 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 开始，适用于 Chrome 的 UiPath 扩展程序可用于自动化 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/ 并在配置文件路径条目中加以检索。

故障排除

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

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