Studio 用户指南

上次更新日期 2023年12月20日

关于库

库是一个项目，其中包含一个或多个工作流，这些工作流可在其他项目中作为活动重用。库在发布时会另存为 NUPKG 文件，并且可以从包管理器作为依赖项进行安装。

例如，您可以创建一个库，使其从 Excel 电子表格中收集数据，并将所收集的数据附加到另一个电子表格，如创建基本库页面所述。接着便可将库打包，并将其作为活动用于其他流程。

转到“Studio 后台视图”>“开始”>“库”。这将打开“新建空白库”窗口。
填写库的名称并为库选择一个位置。默认位置为 C:\Users\<current_user>\Documents\UiPath。添加描述，然后选择“创建”。系统将创建新库并将其保存在本地计算机上。

注意：库名称不能超过 128 个字符，描述不能超过 500 个字符。

“项目”面板显示一个树视图，其中包括“项目”文件夹、“依赖项”以及包含实际工作流的 NewActivity.xaml。

库中的每个工作流文件都可作为项目中的活动提供，而在此类项目中，库作为依赖项安装。如果要将某个文件设为私有，请右键单击该文件，然后选择“从发布中忽略”。在这种情况下，该文件包含在库包中，但是在“活动”面板中不能作为可重用组件使用。

注意：默认情况下，新库可以使用的依赖项与空白新项目可以使用的依赖项相同，即 UiPath.Excel.Activities、UiPath.Mail.Activities、UiPath.System.Activities 和 UiPath.UIAutomation.Activities（“最低适用版本”运行时规则有效）。

要添加工具提示并帮助链接到活动，请在“项目”面板中右键单击工作流文件，然后选择“属性”。当您在安装了库的项目中，将鼠标悬停在“活动”和“设计器”面板中的活动上时，则可以看到该工具提示。当您在“设计器”面板中选择活动并按 F1 时，“帮助链接”将打开。

您在库中定义的参数将成为将库作为依赖项安装的项目中的活动属性。添加到库中参数的注释将在生成的活动的属性面板中显示为该属性的工具提示。有关参数的更多信息，请参见参数面板。

备注：

就库而言，建议使用 Nothing（而非 ""）将 null 值分配给变量。如此一来，在将打包的库作为依赖项用于项目中时，便能避免发生任何不一致的情况。
不支持 System.Activities.ActivityBuilder 对象的“实现版本”属性。为该属性设置值将导致参数无法保存。当您选择“设计器”面板的空白区域，该对象显示在“属性”面板中。

要配置库项目的设置，请单击“项目”面板中的“设置”，打开“项目设置”窗口。

“常规”选项卡中提供以下选项：

名称 - 编辑项目的名称。
描述 - 编辑项目的描述。
包含来源 - 设置为“是”以打包生成的程序集文件中的所有 .xaml 来源，包括以前已设为私有的工作流。如有需要，您可以反编译程序集文件并提取工作流，这在调试时很有帮助。
编译活动表达式 - 设置为“是”以编译所有活动表达式并将其与库打包。这可缩短执行时间。
准备运行 - 设置为“是”以优化生成的程序集，以便在运行时更快地进行 JIT 编译。
新式设计体验 - 设置为是以实现使用用户界面自动化的新式体验，包括新活动和改进的活动、录制器和向导，以及对象存储库。

发布库类似于发布流程。有关更多信息，请参见关于发布自动化项目。

发布库时，请考虑以下限制：

由于 NuGet 的限制：
- 您无法使用 Windows 环境路径变量将库发布到包含用户受限的子文件夹所在的位置。
- 已发布库的发行说明仅在 Orchestrator 中可见。
如果库中 .xaml 文件的名称中包含特殊字符，则该库可能无法成功发布。
无法发布包含“调用工作流文件”活动且已选取“隔离”选项的库。输出面板中将显示错误消息。
在使用“调用工作流文件”活动时，请确保所调用的文件与库项目位于同一个文件夹中。
库不支持“启动工作流交互”活动。
不支持在库中使用“调用工作流文件”来引用库本身。

打开现有项目，或创建一个新项目。
在“所有包”类别下，选择保存库的订阅源并安装包。
选择“确定”，然后包将被添加到项目定义中。
该活动位于“活动”面板中的自定义类别中。
备注：
- 库是向前兼容的，这意味着它们只能用于使用 Studio v2018.3 及更高版本创建的项目。无法将库发布到 2018.3 之前的 Orchestrator 版本。
- 当您运行的项目包含自定义活动的项目时，可能会发生错误，这些自定义活动来自在 2019.10.1 之前的 Studio 版本中创建并通过 Studio 2019.10.1 或更高版本发布的库中。在这种情况下，您必须重新创建并重新发布库。