关于库

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

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

创建库

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

   • 库名称不能超过 128 个字符，描述不能超过 500 个字符。
   • 不要使用 lib 作为库名称，因为这将导致安装库的项目中出现编译错误。
3. “项目”面板显示一个树视图，其中包括“项目”文件夹、“依赖项”以及包含实际工作流的 NewActivity.xaml。

   在将库作为依赖项安装的项目中，库中的每个工作流文件都可作为活动提供。如果要将某个文件设为私有，请右键单击该文件，然后选择“设为私有”。在本例中，该文件包含在库包中，但是在“活动”面板中不能作为可重用组件使用。

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

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

您在库中定义的参数将成为将库作为依赖项安装的项目中的活动属性。在“设计器”面板的活动主体中提供了标记为必需的参数。添加到库中参数的注释将在生成的活动的“属性”面板中显示为该属性的工具提示。有关参数的更多信息，请参见“参数面板”。

备注：

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

调整库设置

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

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

• 名称 - 编辑项目的名称。
• 描述 - 编辑项目的描述。
• Automation Hub URL - 链接到项目的 Automation Hub 概念的 URL。有关详细信息，请参阅将项目链接到 Automation Hub 中的概念。
• 项目图标 -（可选）定义项目的自定义图标。您可以浏览并选择一个文件，或者为大小至多 1MB 的 ico、jpeg、jpg 或 png 文件输入路径或公共 URL。

  项目发布后，该图标将在 Studio 中“管理包”窗口中程序包旁显示。

• 包含源 - 设为“是”以包含库包中的所有 .xaml 源，包括先前设为私有的工作流。对于 Windows - 旧版库，这些文件保存在生成的程序集文件和 .nupkg 文件的 lib\net45 文件夹中。对于 Windows 和跨平台库，文件将保存在 .nupkg 文件的 content 文件夹中。
• 编译活动表达式 - 设置为“是”以编译所有活动表达式并将其与库打包。这可缩短执行时间。可用于 Windows - 仅旧版库。
• 准备运行 - 设置为“是”以优化生成的程序集，以便在运行时更快地进行 JIT 编译。仅可用于 Windows - 旧版库。
• 新式设计体验 - 设置为是以实现使用用户界面自动化的新式体验，包括新活动和改进的活动、录制器和向导，以及对象存储库。

发布库

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

发布库时的限制

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

• 由于 NuGet 的限制：

  • 您无法使用 Windows 环境路径变量将库发布到包含用户受限的子文件夹所在的位置。
  • 已发布库的发行说明仅在 Orchestrator 中可见。
• 如果库中 .xaml 文件的名称中包含特殊字符，则该库可能无法成功发布。
• 如果库包含名称相同的 .xaml 文件和参数，则无法发布该库。
• 具有 Windows - 旧版兼容性的库项目如果包含已选中“隔离”选项的“调用工作流文件”活动，则无法发布。尝试发布时，“输出”面板中会显示一条错误消息。此限制不适用于使用 Windows 或跨平台兼容性的库。
• 在使用“调用工作流文件”活动时，请确保所调用的文件与库项目位于同一个文件夹中。
• 库不支持“启动工作流交互”活动。
• 不支持在库中使用“调用工作流文件”来引用库本身。
• 如果库包含接受文件路径作为输入的活动，则在项目中使用组件时，包含环境变量的路径将解释为相对于库文件夹的路径。要解决此问题，请使用 Environment.GetEnvironmentVariable 方法或“获取环境文件夹”活动来检索文件夹路径，然后使用输出来构建传递到可重用组件的绝对路径。
• 如果将放置在库文件夹中的工作流文件用作项目中的命名空间，则在项目中更改文件夹名称、重新发布和安装更新的库会导致未知活动。

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

1. 打开现有项目，或创建一个新项目。
2. 在“所有包”类别下，选择保存库的订阅源并安装包。
3. 选择“确定”，然后包将被添加到项目定义中。
4. 该活动位于“活动”面板中的自定义类别中。

在项目中安装库的注意事项

• 库只能安装在具有相同兼容性的项目中。
• 如果跨平台库包含具有用户界面自动化活动的工作流，则在跨平台项目中添加生成的活动会导致执行项目时出现验证错误。
• 当您运行的项目包含自定义活动的项目时，可能会发生错误，这些自定义活动来自在 2019.10.1 之前的 Studio 版本中创建并通过 Studio 2019.10.1 或更高版本发布的库中。在这种情况下，您必须重新创建并重新发布库。
• 在库项目中，当使用“导入工作流”来添加包含库的工作流时，不会导入库中引用的依赖项。
• 将同一自定义库的两个版本导入项目时，仅包含在第二个库中的额外自定义活动在“活动”面板中不可见，除非您删除第一个导入的库。