订阅

UiPath Studio

UiPath Studio 指南

管理活动包

关于活动订阅源

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.
  • Local - The feed can be excluded when installing Studio with the .msi installer. If you choose not to install the local activities feed, the folder is still created but contains only the default activities, UiPath.UIAutomation.Activities, UiPath.System.Activities, UiPath.Excel.Activities and UiPath.Mail.Activities, together with dependencies previously set to a project. If installed, the feed has the following source: %ProgramFiles%\UiPath\Studio\Packages. Check out the list of default activities packages here.
  • 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://www.myget.org/F/workflow/.
  • 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/v2.
    Please be aware that UiPath has no control over the unlisting of packages created by partners or the Marketplace community. However, UiPath keeps unlisted packages active to ensure backward compatibility for runtime purposes.

📘

Note:

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.

添加自定义订阅源

📘

Note:

在企业版安装中,自定义活动订阅源只能用于从该用户上的 Studio 开始的工作流中。如果从 Orchestrator 或代理(机器人托盘)在同一台计算机上开始作业,将导致机器人无法检索正确的包。为了避免这种情况,您应该在“活动订阅源”属性下的 UiPath.settings 文件中添加自定义订阅源,而不必使用下面的方法。

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

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

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

📘

Note:

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

添加安全订阅源

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"

删除自定义订阅源

📘

Note:

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

  1. 在“设置”类别中,单击“用户定义的包来源”部分下的任何订阅源。
  2. 按“删除” image alt textimage alt text 按钮。订阅源将从“所有包”类别和“用户定义的包来源”部分中删除。
  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%\NuGetNuGet.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>
  1. 重新启动 Studio。

管理包

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

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

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

📘

Note:

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

The Include Prerelease checkbox next to the Search bar, displays the beta versions of library packages, if available, when selected.
Check the Include Prerelease box if descriptions for the project's dependencies are not visible in the Manage Packages window.

📘

重要提示:

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

安装包

📘

Note:

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

📘

Important!

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

  1. 在“管理包”窗口中,选择“所有包”类别。这将打开从您的订阅源收集的所有包的列表。
  1. 找到要安装的包。您可以:
    • 向下滚动列表以查找包。
    • 通过在搜索栏中键入包的部分名称或说明来搜索包。
    • 通过单击搜索栏旁边的“筛选器”图标 filter packagesfilter packages,然后仅选择要查看的选项来筛选列表:
      • 包括预发行版 - 包括包的测试版(如果可用)。
      • 仅限 UiPath - 仅列出由 UiPath 发布的包。
      • 仅限活动 - 仅列出活动包。
      • 仅限库 - 仅列出库。
      • 仅限用户界面库 - 仅列出从对象存储库发布的“用户界面库”。
  2. 选择一个活动包,以查看其说明、版本、依赖项、项目 URL 以及发布日期。
  3. 单击“版本”旁边的下拉列表,以选择包的某一版本,然后设置“运行时规则”。若要进一步阅读有关项目依赖项运行时规则的信息,请查阅“管理依赖项”页面。
  4. 单击“安装”按钮。或者,也可单击包名称旁边的 image alt textimage alt text 图标,并标记 image alt textimage alt text 图标,表示该包已做好安装准备。
  5. 许可证接受”窗口显示您要安装的每个第三方软件包的许可条款。单击“查看许可证”以阅读许可条款。
    • 单击“我接受”,以同意接受许可条款并安装这个包。
    • 单击“我拒绝”,以取消安装并返回到“管理包”窗口。

📘

Note:

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

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

📘

Note:

如果活动包的安装过程中路径受损,安装不会完成。建议备份并清除下列本地文件夹中的内容:%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>

Updated 12 days ago



管理活动包


建议的编辑仅限用于 API 参考页面

You can only suggest edits to Markdown body content, but not to the API spec.