关于活动订阅源

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

• application level - feeds are configured from the Settings > Manage Sources tab
• 项目级别 - 通过功能区中的“管理包”按钮配置订阅源。

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

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

• Orchestrator Tenant and Orchestrator Host - These activities feeds are added by default if your Robot is connected to Orchestrator and they cannot be disabled. The Orchestrator Tenant option is available only if the tenant libraries feed is enabled in Orchestrator. For more information, see Activities Feeds in the Orchestrator Guide. The feeds have the following source: https://[Orchestrator_host]/nuget/activities.
• “本地”- 与 Studio 一起在本地安装的包的订阅源。此订阅源具有来源 %ProgramFiles%\UiPath\Studio\Packages（对于为每台计算机安装）或 %localappdata%\Programs\UiPath\Studio\Packages（对于为每个用户安装）。
  Note: The publish date displayed in the Manage Packages window for packages from the local feed is the date when the Studio installer was built, not the date when the packages were published.
• Official - The official online UiPath feed, where you can find the activity packages that are officially supported by us. This feed has the following source: https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json.
• Marketplace - This public feed contains all the activities published on the UiPath Marketplace. Please note that whether or not packages are built and officially supported by UiPath is specifically stated in the Manage Packages window, Package Information tab. This feed has the following source: https://gallery.uipath.com/api/v3/index.json.
  请注意，UiPath 不掌控由合作伙伴或 UiPath 市场订阅源社区创建的包的取消列出。不过，UiPath 会使取消列出的包保持活跃，以确保运行时目的所需的向后兼容性。

📘

备注：

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

Feed management and configuration is available in the Manage Packages window if a governance policy was not enforced. If such a policy is enforced and contains restricted rights regarding feed management, then a message is displayed in the window. Read more about Governance.

添加自定义订阅源

📘

备注：

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

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

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

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

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

📘

备注：

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

添加安全订阅源

If you want to add a custom NuGet feed that requires authentication, you can follow the steps explained here.

您需要将 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="myEencryptedPassword" />
</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 Only - List only packages designed for StudioX (this option is only available in the StudioX profile).
     • 仅限 UiPath - 仅列出由 UiPath 发布的包。
     • Activities Only - List only activities packages. This is the default option.
     • 仅限库 - 仅列出库。
     • 仅限用户界面库 - 仅列出从对象存储库发布的“用户界面库”。
     • Compatible Only - List only packages whose latest version is compatible with the project's compatibility. Do not select this option if you want to see packages with older versions that are compatible with the project's compatibility.
3. 选择一个活动包，以查看其说明、版本、依赖项、项目 URL 以及发布日期。
4. 单击“版本”旁边的下拉列表，以选择包的某一版本，然后设置“运行时规则”。若要进一步阅读有关项目依赖项运行时规则的信息，请查阅“管理依赖项”页面。
5. 单击“安装”按钮。或者，也可单击包名称旁边的 图标，并标记 图标，表示该包已做好安装准备。
6. “许可证接受”窗口显示您要安装的每个第三方软件包的许可条款。单击“查看许可证”以阅读许可条款。
   • 单击“我接受”，以同意接受许可条款并安装这个包。
   • 单击“我拒绝”，以取消安装并返回到“管理包”窗口。

📘

备注：

安装 Studio，即暗示您已经接受 UiPath 包及其依赖项的条款和条件。阅读 UiPath 使用条款和隐私政策。

7. 单击“保存”以安装软件包或更新版本。

📘

备注：

如果活动包的安装过程中路径受损，安装不会完成。建议备份并清除下列本地文件夹中的内容：%userprofile%\.nuget\packages 和 %userprofile%\AppData\Local\UiPath\.cache。

卸载包

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

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

更改包的下载文件夹

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

• During installation, by installing from the command line with the option 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>

在离线环境中管理包

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

要在离线 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（对于为每位用户安装）。