关于库

A library is a project which contains one or more workflows that can be reused as activities in other projects. Libraries are saved as NUPKG files when published and can be installed as dependencies from the Package Manager.

For example, you could create a library that collects data from an Excel spreadsheet and appends it to another, as explained in the Creating a Basic Library page. Next, the library can be packaged and used in other processes as an activity.

创建库

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

备注：

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

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

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

   备注：

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

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

Arguments you define in the library become activity properties in the projects where the library is installed as a dependency. Annotations you add to an argument in the library are displayed as a tooltip for the property in the resulting activity's Properties panel. For more information about arguments, see Arguments Panel.

备注：

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

调整库设置

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

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

• 名称 - 编辑项目的名称。
• 描述 - 编辑项目的描述。
• 包含源 - 设置为“是”以打包生成的程序集文件中的所有 .xaml 源，包括以前已设为私有的工作流。如有需要，您可以反编译程序集文件并提取工作流，这在调试时很有帮助。
• 编译活动表达式 - 设置为“是”以编译所有活动表达式并将其与库打包。这可缩短执行时间。
• 准备运行 - 设置为“是”以优化生成的程序集，以便在运行时更快地进行 JIT 编译。
• Modern Design Experience - set to Yes to enable a modern experience of working with UI Automation, including new and improved activities, recorders, and wizards, as well as the Object Repository.

发布库

Publishing libraries is similar to publishing processes. For more information, see About Publishing Automation Projects.

发布库时的限制

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

• 由于 NuGet 的限制：
  • 您无法使用 Windows 环境路径变量将库发布到包含用户受限的子文件夹所在的位置。
  • 已发布库的发行说明仅在 Orchestrator 中可见。
• 如果库中 .xaml 文件的名称中包含特殊字符，则该库可能无法成功发布。
• Libraries containing Invoke Workflow File activities with the Isolated option selected cannot be published. An error message is displayed in the Output panel.
• 在使用“调用工作流文件”活动时，请确保所调用的文件与库项目位于同一个文件夹中。
• 库不支持“启动工作流交互式”活动。
• 不支持在库中使用“调用工作流文件”来引用库本身。

向自动化项目中添加可重用组件

1. 打开现有项目，或创建一个新项目。

2. 在“所有包”类别下，选择保存库的订阅源并安装包。

3. 选择“确定”，然后包将被添加到项目定义中。

4. 该活动位于“活动”面板中的自定义类别中。

   备注：

   • 库是向前兼容的，这意味着它们只能用于使用 Studio v2018.3 及更高版本创建的项目。库不能发布到版本低于 2018.3 的 Orchestrator。
   • 当您运行的项目包含自定义活动的项目时，可能会发生错误，这些自定义活动来自在 2019.10.1 之前的 Studio 版本中创建并通过 Studio 2019.10.1 或更高版本发布的库中。在这种情况下，您必须重新创建并重新发布库。

请注意，在库项目中，当使用“导入工作流”来添加包含库的工作流时，不会导入库中引用的依赖项。

将同一自定义库的两个版本导入 Studio 中的项目时，只有第二个库中包含的额外自定义活动在“活动”面板中不可见，除非您删除第一个导入的库。