包和库

UiPath 机器人使用的 NuGet 包：Studio 中的默认订阅源、本地和 Orchestrator 订阅源、包缓存行为以及订阅源配置。

包包含所有自动化元素（例如活动、工作流、文件和数据源）。 在 Studio 中创建项目时，需要将其作为包发布到特定位置或订阅源。 机器人可以从这里下载并使用它来运行自动化。

重要提示：

使用绝对路径来指示包的位置。

默认订阅源

Studio 中默认配置了以下位置和订阅源：

• Orchestrator 租户和 Orchestrator 主机 - 如果机器人已连接到 Orchestrator，则会默认添加这些活动订阅源，并且无法禁用它们。只有在 Orchestrator 中启用了租户库订阅源时，才可使用“Orchestrator 租户”选项。这些订阅源具有以下来源：https://[Orchestrator_host]/nuget/activities。

• 本地 - 通过 Studio 本地安装的包的订阅源。 订阅源有如下来源：%ProgramFiles%\UiPath\Studio\Packages用于按计算机安装，%localappdata%\Programs\UiPath\Studio\Package用于按用户安装。

  备注：

  对于本地订阅源中的包，“管理包”窗口中显示的发布日期是指 Studio 安装程序的构建日期，而不是包的发布日期。

• 官方 - 官方在线 UiPath 订阅源，从中您可找到我们提供官方支持的活动包。此订阅源有如下来源：https://pkgs.uipath.com/official/index.json。

• Marketplace - 此公共订阅源包含 UiPath Marketplace 上发布的所有活动。

  备注：

  包是否由 UiPath 构建并提供官方支持，具体列于“管理包”窗口的“包信息”选项卡中。

  此订阅源有如下来源：https://gallery.uipath.com/api/v3/index.json。

自定义订阅源

在 Enterprise 安装中，自定义活动订阅源只能用于从该用户的 Studio 启动的工作流中。 在 Orchestrator 或 Assistant 的同一台计算机上启动作业，将导致机器人无法检索相应的包。为了避免这种情况，请添加自定义订阅源。

重要提示：

如要使用自定义订阅源，请确保机器人有权访问自定义位置。

活动订阅源

使用多个订阅源时，NuGet 会选择响应最快的订阅源。由于活动包可能有多个版本，因此机器人会根据 Studio 中的运行时规则搜索版本。具体如下：

• 对于严格运行时规则，机器人仅查找指定的包版本。例如，如果您选择 2.5.0 版本并将“运行时规则”设置为“严格”，那么机器人将仅搜索 2.5.0 版本。如未找到，会出现错误。
• 根据最低适用版本运行时规则，机器人会查找指定的包版本或更高版本。例如，如果您选择 2.5.0 版本并将“运行时规则”设置为“最低适用版本”，那么机器人将搜索以 2.5.0 开头的版本（2.5.0、2.5.1、2.5.2 等）。 如未找到，会出现错误。

如果订阅源缺少签名的包和依赖项，那么自动化可能会失败。 这是因为机器人需要所有包和依赖项均经过签名。为了防止这种情况，请确保配置的所有订阅源均仅包含签名的包和依赖项。

重要提示：

• 无论何时修改配置文件，都需要重新启动 UiPath 机器人服务，以使更改生效。

• To ignore HTTP and HTTPS feeds from NuGet.config, add the following line in UiPath.config, under <packageSettings>:

  <add key="skipHttpConfigurationSources" value="true" />
  

  Local and UNC folder sources still work, along with the Orchestrator feed, which the Robot adds at runtime instead of reading it from NuGet.config.

To restrict sources to specific feeds while leaving skipHttpConfigurationSources at false, see Restricting feeds to specific sources.

如下清单总结机器人使用的订阅源，具体取决于订阅源的配置方式：

• 如果选择安装本地订阅源，则系统会创建 %ProgramFiles%\UiPath\Studio\Packages 文件夹。此文件夹包含安装时 UiPath 正式支持的活动程序包。此订阅源默认处于启用状态。
• 如果选择不安装本地订阅源，则系统会创建%ProgramFiles%\UiPath\Studio\Packages文件夹；不过，此文件夹仅包含作为默认依赖项添加到新项目的程序包。
  • UiPath.UIAutomation.Activities
  • UiPath.System.Activities
  • UiPath.Excel.Activities
  • UiPath.Mail.Activities

当您将机器人连接到 Orchestrator 时，Orchestrator 会提供 NuGet 订阅源。此订阅源包含 UiPath 官方支持的活动包。此订阅源默认处于启用状态，具体取决于您的存储设置。

如下清单总结机器人使用的订阅源，具体取决于机器人与 Orchestrator 的连接：

• 连接到 Orchestrator 的机器人
  • 如果将 NuGet.Repository.Type 设置为 Legacy，则活动默认保存在 ~/NuGetPackages/Activities 位置中。您可以自定义该值，并且系统会将其作为 web.config 文件的 NuGet.Activities.Path 参数保存在 Orchestrator 计算机上。
  • 如果将NuGet.Repository.Type设置为Composite，那么活动将保存在通过Storage.Type和Storage.Location参数指定的位置。
    重要提示：

    此Composite选项会限制包目录中复制-粘贴命令的使用。

• 机器人未连接到 Orchestrator 当机器人未连接到 Orchestrator 时，或者在本地订阅源中找不到所需的活动，它会使用以下订阅源：

  https://pkgs.uipath.com/official/index.json
  

这是官方在线 UiPath 订阅源，也是 Studio 中的包管理器检索其活动的来源。 默认情况下，此订阅源处于非活动状态。 如要启用此功能，请在 Studio 中转到“设置”>“管理来源”，然后选择相应的选项。

回退包文件夹

备用包文件夹是备份文件夹。当主要来源出现故障时，机器人可以从该文件夹中检索所需的包。

如要设置此文件夹，请在机器人计算机上添加NUGET_FALLBACK_PACKAGES环境变量。 该变量应包含这些备份文件夹完整路径的列表（路径之间以分号隔开）。 如果该环境变量不存在，那么机器人将尝试从Nuget.config文件中读取 NuGet 包后备文件夹。

重要提示：

您不能使用备用文件夹来存储和运行完整的自动化任务或工作流。

不支持部署在回退文件夹中的流程，仅支持依赖项。