包和库

包包含所有自动化元素（例如活动、工作流、文件和数据源）。 在 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.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/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 机器人服务，以使更改生效。
• 如要忽略来自NuGet.config的 HTTPS 订阅源，请在UiPath.config，<packageSettings>下添加以下行：

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

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

• 如果选择安装本地订阅源，则系统会创建 %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.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json
  

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

回退包文件夹

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

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

重要提示：

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

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