管理活动包

Studio 使用 NuGet 订阅源来安装活动包。您可以在 Studio 中以两种方式处理这些订阅源：

• 应用程序级别 - 在“设置”>“管理来源”选项卡中配置订阅源；
• 项目级别 - 通过功能区中的“管理包”按钮配置订阅源。

若要禁用活动订阅源，必须清除其对应的复选框。启用或禁用订阅源功能同时适用于项目和应用程序级别。

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

• Orchestrator 租户和 Orchestrator 主机 - 如果机器人已连接到 Orchestrator，则会默认添加这些活动订阅源，并且无法禁用它们。只有在 Orchestrator 中启用了租户库订阅源时，才可使用“Orchestrator 租户”选项。这些订阅源具有以下来源：https://[Orchestrator_host]/nuget/activities。
• “本地”- 与 Studio 一起在本地安装的包的订阅源。此订阅源具有来源 %ProgramFiles%\UiPath\Studio\Packages（对于为每台计算机安装）或 %localappdata%\Programs\UiPath\Studio\Packages（对于为每个用户安装）。
  注意：对于本地订阅源中的包，“管理包”窗口中显示的发布日期是指 Studio 安装程序的构建日期，而不是发布包的日期。
• 官方 - 官方在线 UiPath^™ 订阅源，您可从中找到我们提供官方支持的活动包。此订阅源具有以下来源：https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json。
• UiPath 市场 - 此公共订阅源包含在 UiPath 市场上发布的所有活动。请注意，关于包是否由 UiPath 构建并提供官方支持，请前往“包信息”选项卡中的“管理包”窗口查看。此订阅源具有以下来源：https://gallery.uipath.com/api/v3/index.json。

  请注意，UiPath 不掌控由合作伙伴或 UiPath 市场订阅源社区创建的包的取消列出。不过，UiPath 会使取消列出的包保持活跃，以确保运行时目的所需的向后兼容性。

  
  

  

  
  
  注意：Studio 升级至更高版本后，订阅源配置将会保留。

其他订阅源可以单独添加，例如：

• 公共部门 - 此订阅源专门用于公共部门 Automation Cloud，托管在美国。此订阅源具有以下来源：https://govcloud.uipath.us/nuget/v3/_shared/libraries/index.json。

如果未实施监管策略，则可以在“管理包”窗口中管理和配置订阅源。如果已经强制执行此类策略，并且其中包含与订阅源管理有关的限制权限，则系统将在窗口中显示一则消息。阅读有关监管的更多信息。

添加自定义订阅源

注意：在企业版安装中，自定义活动订阅源只能用于该用户从 Studio 启动的工作流。从 Orchestrator 或 Assistant 启动同一台计算机上的作业会导致机器人无法检索适当的包。为了避免这种情况，您应该在“活动订阅源”属性下的 UiPath.settings 文件中添加自定义订阅源，而不必使用下面的方法。

1. 在“管理包”窗口中，单击“设置”。系统将显示包来源。
   
   

   

   
   
2. 单击 按钮以向“用户定义的包来源”类别中添加订阅源。
3. 填写包来源的名称或 NuGet 订阅源的名称。
4. 在“来源”字段中，键入本地驱动器文件夹路径、共享网络文件夹路径或 NuGet 订阅源 URL。
5. 单击“添加”。新订阅源会添加到“管理包”窗口的“用户定义的包来源”和“所有包”类别中。订阅源默认情况下处于启用状态。
6. 单击“保存”以应用所有更改。

可以从“管理包”窗口中启用或禁用用户定义及默认的包来源。

请注意，订阅源是当场添加的。添加订阅源后单击“关闭”或“取消”按钮不会还原更改。

注意：如果自定义订阅源中包含损坏的包或当前正在编辑器中进行修改的包，“包管理器”便无法加载此订阅源中的任何包。

添加安全订阅源

如果要添加需要身份验证的自定义 NuGet 订阅源，您可以按照此处所述的步骤来操作。

您需要将 NuGet 订阅源、用户名和密码值添加到 NuGet.config 文件中，该文件位于以下路径：%AppData%\NuGet。完成后，该订阅源应该会显示在“管理包”窗口中。

<packageSources>
  <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
  <add key="FeedName" value="https://FeedSource" />
  </packageSources>
  
 <packageSourceCredentials>
  <FeedName>
    <add key="Username" value="YourUsername" />
    <add key="Password" value="YourPassword" />
  </FeedName>
</packageSourceCredentials>

请注意，在使用未加密的密码时，应当用 key="ClearTextPassword" 来取代 key="Password"。

删除自定义订阅源

注意：只有“用户定义的包来源”可以从“管理包”窗口中删除。

1. 在“设置”类别中，单击“用户定义的包来源”部分下的任何订阅源。
2. 按“删除” 按钮。订阅源将从“所有包”类别和“用户定义的包来源”部分中删除。
3. 单击“保存”以应用更改。

请注意，订阅源是当场删除的。删除默认或自定义订阅源后单击“关闭”或“取消”按钮不会还原更改。

通过代理服务器连接到订阅源

如果您的计算机位于代理服务器之后，则必须配置 NuGet 代理设置才能访问位于网络外部的订阅源：

1. 从 https://www.nuget.org/downloads 上下载 nuget.exe。
2. 在存储已下载 nuget.exe 的文件夹中打开命令提示符窗口，然后运行以下命令，配置代理服务器的地址、用户名和密码：

   nuget.exe config -set http_proxy=<http://proxy.server.address:port>

   nuget.exe config -set http_proxy.user=<mydomain\myUserName>

   nuget.exe config -set http_proxy.password=<myPassword>

3. 检查位于 %AppData%\NuGet 的 NuGet.config 文件是否已使用新配置更新：

   <config>
       <add key="http_proxy" value="http://proxy.server.address:port" />
       <add key="http_proxy.user" value="mydomain\myUserName" />
       <add key="http_proxy.password" value="myEncryptedPassword" />
   </config>

4. 重新启动 Studio。

管理包

包管理器功能使您可以下载活动包、库、框架、包装器等等，查看已经为项目安装的项目并更新，以及添加和删除自己的包。包管理器显示了每个订阅源的可用包列表和每个当前项目的依赖项列表。“管理包”窗口每次打开时都显示“项目依赖项”列表。

活动包是一组活动，可以帮助您自动化某个应用程序 (UiPath.Excel.Activities, UiPath.Word.Activities) 或某一类应用程序 (UiPath.Mail.Activities, UiPath.Terminal.Activities)，或者在自动化中使用某些技术 (UiPath.OCR.Activities, UiPath.FTP.Activities)。

有关包和库的详细信息显示在“管理包”窗口的右侧面板中，如上面的屏幕截图中所示。

注意：由于 NuGet v3 限制的关系，“管理包”窗口中不显示活动包的发行说明。

选中搜索栏旁边的“包括预发行”复选框时，此复选框将显示库包的 beta 版本（如果有）。

如果在“管理包”窗口中看不到项目依赖项的描述，请选中“包括预发行版”框。

备注： UiPath.UIAutomation.Activities 和 UiPath.System.Activities 包兼容 Studio v2018.3 和更高版本。

安装包

注意：下载和安装活动包需要互联网连接。

注意：如果您的组织使用强制包签名，则需要为 UiPath 添加受信任的证书，以便能够安装官方包。您可以在这里阅读更多内容。您可以在此处阅读更多相关信息。

1. 在“管理包”窗口中，选择“所有包”类别。这将打开从您的订阅源收集的所有包的列表。
   
   

   

   
   
2. 找到要安装的包。请注意，可用的活动包和版本取决于为项目选择的兼容性。

   您可以：

   • 向下滚动列表以查找包。
   • 通过在搜索栏中键入包的部分名称或说明来搜索包。

   • 通过单击搜索栏旁边的“筛选器” 图标，然后仅选择要查看的选项来筛选列表：

     • 包括预发行版 - 包括包的测试版（如果可用）。
     • 仅限 StudioX - 仅列出为 StudioX 设计的包。（此选项仅适用于 StudioX 配置文件）
     • 仅限 UiPath - 仅列出由 UiPath 发布的包。
     • 仅限活动 - 仅列出活动包。
     • 仅限库 - 仅列出库。
     • 仅限用户界面库 - 仅列出从对象存储库发布的“用户界面库”。
     • “仅兼容” - 仅列出最新版本与项目兼容的包。如果要查看具有与项目兼容的旧版本的包，请不要选择此选项。
3. 选择一个活动包，以查看其说明、版本、依赖项、项目 URL 以及发布日期。
4. 单击“ 版本 ” 旁边的下拉列表，以选择包的版本，然后设置“ 运行时规则”。 要阅读有关项目依赖项的运行时规则的更多信息，请查看 管理依赖项 页面。
5. 单击“安装”按钮。此外，也可单击包名称旁边的 图标，为它标上 图标，使其准备好进行安装。
6. “许可证接受”窗口显示您要安装的每个第三方软件包的许可条款。单击“查看许可证”以阅读许可条款。
   • 单击“我接受”，以同意接受许可条款并安装这个包。

   • 单击“我拒绝”，以取消安装并返回到“管理包”窗口。

     注意：安装 Studi，即暗示您已经接受 UiPath 包及其依赖项的条款和条件。阅读 UiPath 使用条款和隐私政策。
7. 单击“保存”以安装软件包或更新版本。
   注意：如果活动包的安装过程中路径受损，安装不会完成。建议备份并清除下列本地文件夹中的内容：%userprofile%\.nuget\packages 和 %userprofile%\AppData\Local\UiPath\.cache。

卸载包

要卸载包，请转到“项目依赖项”类别，单击不想再使用的包旁边的“卸载”按钮。只有在您单击“保存”之后才会删除包。

运行自动化项目时，将禁用“管理包”按钮，这意味着在执行停止之前无法安装或删除活动包。

降级软件包

不建议降级活动包。主要原因是它可能对依赖项产生的负面影响。我们在每个版本中都会精心管理不同活动包之间的依赖项。因此，降级可能会导致不一致，甚至工作流功能障碍。此外，新版活动包提供了旧版中可能不可用的改进特性和功能。因此，为确保最佳性能并避免潜在的错误，建议将活动包保持为当前版本或升级到最新版本。

更改包的下载文件夹

默认情况下，活动包已下载并安装在 %userprofile%\.nuget\packages 文件夹中。您可以通过以下方式之一设置其他文件夹：

• 在安装过程中，通过在 命令行 中使用选项 PACKAGES_FOLDER进行安装。
• 安装完成后，通过手动编辑 uipath.config 文件：
  1. 在文本编辑器中打开 uipath.config 文件。默认情况下，该文件位于 C:\Program Files\UiPath\Studio。
  2. 在 packageSettings 节点中，添加 packagesInstallationFolder 键，并将新文件夹的路径作为其值。

  3. 保存更改，如果将机器人作为服务安装，请重新启动服务。

     例如，将以下代码添加到 uipath.config 以将下载位置更改为 C:\nuget。

     <packageSettings>
       <add key="packagesInstallationFolder" value="C:\Nuget" />
     </packageSettings>

注意：删除 .nuget 文件夹的内容会导致在 Studio 中打开项目时出现依赖项冲突。

在离线环境中管理包

在未连接到互联网的计算机上使用 Studio 时，可以在另一台计算机上下载包，然后手动将其传输到已安装 Studio 的计算机。仅当 Orchestrator 连接不可用时，才需要执行此步骤。当 Studio 连接到 Orchestrator 时，可以从 Orchestrator 订阅源安装包。

注意：要防止 Studio 尝试从在线订阅源下载包，请禁用离线计算机上的所有在线订阅源。

要在离线 Studio 计算机上安装包，请执行以下操作：

1. 在可以访问互联网的计算机上，下载并安装 NuGet 包资源管理器。
2. 打开 NuGet 包资源管理器，然后选择“从在线订阅源打开包”。
3. 在“包来源”字段中，输入要从中下载包的订阅源的 URL。官方 UiPath 包订阅源为 https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json。
4. 在订阅源中找到包并下载。
5. 将 NUPKG 文件传输到 Studio 计算机中定义为 Studio 中包源的文件夹中。要将包添加到默认的本地订阅源，请将该文件复制到 %ProgramFiles%\UiPath\Studio\Packages（对于为每台计算机安装）或 %localappdata%\Programs\UiPath\Studio\Packages（对于为每位用户安装）。

将存档与可选软件包一起使用

为了减小 Studio 安装程序的大小，从 2022.10 版本开始，UiPathStudio.msi 文件中不再包含多个活动包。为了方便在离线环境中工作或始终将所需包保存在本地存储中的用户，可以从 Customer Portal 下载一个 ZIP 存档文件，其中包含安装程序中不再包含的包及其依赖项，使您能够将包放在 Studio 或机器人计算机上。

该存档包含以下包的最新版本：

• UiPath.MobileAutomation.Activities
• UiPath.Terminal.Activities
• UiPath.Persistence.Activities
• UiPath.PDF.Activities

要将包添加到本地订阅源文件夹，请执行以下操作：

1. 从 UiPath Customer Portal 下载 ZIP 存档。
2. 将存档放在 Studio 或机器人计算机可访问的位置。

3. 使用以下方法之一添加包：

• 安装过程中 - 在开始安装之前，请将存档放在 Studio MSI 安装程序所在的根文件夹中。安装程序会将包添加到本地订阅源文件夹。
• 安装后 - 默认情况下，将存档的内容解压缩到本地包文件夹：
  • 对于按用户安装模式，文件夹为 %localappdata%\Programs\UiPath\Studio\Packages。
  • 对于按计算机安装模式，文件夹为 %ProgramFiles%\UiPath\Studio\Packages。