Extension for Edge

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

重要提示：

计划于 2024 年 6 月开始弃用 Manifest V2 扩展程序。

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

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

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

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

• 2022.10
• 2022.4.4+
• 2021.10.8+
• 2020.10.14+
• 2019.10.9+

可前往 UiPath Automation Cloud 的资源中心进行下载。

此扩展程序可帮助您在 Microsoft Edge 中创建浏览器自动化。您可以通过多种方式安装此扩展程序，具体如下所示：

从 UiPath Studio 安装

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

从 Studio 安装程序安装

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

也可以通过 UiPathStudio.msi 的命令行安装 UiPathEdge 扩展程序。

从组策略安装

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

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

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

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

离线

此安装方法要求目标计算机加入 Microsoft Active Directory 域或 Azure Active Directory。

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

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

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

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

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

1. 在“扩展程序安装强制列表”策略中，添加以下值：

   ndmegdjihnhfmljjoaiimbipfhodnbgf;file:///C:/ProgramData/UiPath/UiPath.Common/EdgeExtension_SelfHosted/extension_manifest_edge.xml

2. 在本地消息白名单策略中，添加值 com.uipath.chromenativemsg_v2。

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

C:\Program Files\UiPath\Studio\UiPath\BrowserExtension\uipath_extension_for_edge_self_hosted_mv3.crx

在线

此安装方法要求目标计算机有权访问 Edge 网上应用店（https://edge.microsoft.com/extensionwebstorebase/v1/crx 和 https://msedgeextensions.sf.tlu.dl.delivery.mp.microsoft.com）。

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

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

&"C:\Program Files\UiPath\Studio\UiPath\SetupExtensions.exe" /edge-chromium-policyglobal /silent

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

1. 在“扩展程序安装强制列表”策略中，添加以下值：

   cdfjcmjmgdnojgaojdnefhjjpaijapci;https://edge.microsoft.com/extensionwebstorebase/v1/crx

2. 在本地消息白名单策略中，添加值 com.uipath.chromenativemsg_v2

卸载

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

&"C:\Program Files\UiPath\Studio\UiPath\SetupExtensions.exe" /edge-chromium-cleanup /silent

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

Edge 版本要求

UiPath Edge 扩展程序 MV2 适用于所有现有 Edge 版本。

UiPath Edge 扩展程序 MV3 需要 Edge 98 或更高版本。

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

新的扩展程序功能

支持 IE 模式

从 UiPathStudio.msi 2020.10 开始，UiPath Edge 扩展程序可用于自动化在 Internet Explorer 模式下运行的网页。

可以在 Internet Explorer 模式下自动化包含 Java 小程序、Silverlight 和 ActiveX 控件的网页。

自动化 Edge 应用程序

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

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

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

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

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

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

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

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

故障排除

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

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