Library 是包含多个可重用组件的包。Libraries 都会被存储为 .nupkg
文件,并可以在 Package Manager 作为依赖安装到流程中
管理可重用组件活动
可重用活动代表一个或者多个作为活动打包在一起的工作流,它们被用于其它流程中。
创建一个库
在后台视图中,依次点击 Start > Library。将会打开 New Blank Library 窗口。
填写名称和选择库的路径。默认的位置是
C:\Users\<current_user>\Documents\UiPath
。添加描述并点击 Create。这一系列步骤将会在你的计算机上创建并保存一个新的库项目。Project 面板显示了项目文件夹的树状结构,依赖以及包含在流程中的
NewActivity.xaml
文件。
注意 默认情况下,新的库项目可用的依赖和新建的新项目是一样的,它们是
UiPath.Excel.Activities
,UiPath.Mail.Activities
,UiPath.System.Activities
, andUiPath.UIAutomation.Activities
,遵循最低可用版本 的运行时规则。打开 Properties 窗口,为库填写 Tooltip (工具提示) 和 Help Link(帮助链接) 信息。
在添加新活动之后,只需添加一个 Tooltip (工具提示) 就可以在 Activities 面板中显示。在选定活动上按 F1 后,将打开 Help Link(帮助链接)
当从模板中创建一个新的库项目时,Designer 面板并不会自动打开 .xaml
文件,除非该库项目模板拥有一个 Main.xaml
文件。
调整库项目的设置
可以为库项目建立一组单独的设置。这些设置可以在 Project Settings 窗口中使用,该窗口可以通过单击 Project
面板中的按钮打开。
Project Settings (项目设置) 窗口允许更改库的名称和说明。将Include Sources 切换到 Yes ,可以将所有 .xaml
源打包到生成的程序集文件中,包括以前已成为私有的工作流。
发布库项目
- 在菜单栏的 Design 选项卡中,点击 Publish 按钮。将会打开 Publish Library 窗口。
- 在 Publish Location 目录,可以将库设置为发布到 Orchestrator,自定义 NuGet 源或者本地计算机。可以使用 API key 来认证自定义 NuGet 源。
库项目一旦到达了 Orchestrator,它要么被保存在主机源文件夹,要么被保存在租户(tenant)的源文件夹,该选项可以在 Settings 中配置。可以参考 [这里] 阅读关于库的源位置相关的更多信息。
注意 由于 NuGet 的限制,在 Windows 环境中,不可以将库发布到包含仅限于当前用户的子文件夹的位置。
在 Release Notes 目录中,键入版本和其它相关的详细信息。已发布项目的 Release notes(发布说明)将会在Orchestrator 中的 Packages 部分可见。
填写项目的 New Version 字段,如有必要,勾选 Is Prerelease 复选框来标记该项目版本是否处于
alpha
阶段。请注意,这会自动将项目的版本模式更改为语义模式。请参考 About Automation Projects 页面获取更多关于版本的信息。
注意 由于 NuGet v3 的限制,库项目的 Release notes(发布说明) 只可以在 Orchestrator 中可见。
- In the Library Settings category, set a name for the Activities Root Category or leave the default library name. This creates a new category for the reusable component in the Activities panel.
Select the check box next to the Include Sources to package all .xaml
sources within the generated assembly file, including workflows that were previously made private. This is helpful during debugging workflows.
在 Library Settings 目录中,为 Activities Root Category 设置名称或者让它使用默认名称。这将会在 Activities 面板中为可重用组件在创建一个目录。
勾选 Include Sources 旁边的复选框,打包所有的.xaml
源文件到即将生成的编译文件,同时包含此前设置为私有的工作流。这在调试工作流的时候将会非常有用。在 Certificate Signing 部分,在 Certificate文本框旁边添加本地的 Certificate Path 。如有必要,可以进一步填写 Certificate Password 和 Optional Certificate Timestamper (可选的认证时间戳)。请查阅 Signing Packages 了解更多细节。
注意 目前,带签名的项目接受 .pfx 和 .p12 后缀的证书。
点击 Publish 按钮。整个项目文件夹都会被存档到一个
.nupkg
文件中,并上传到 Orchestrator,自定义 NuGet 源或者保存到本地目录。项目发布成功时,会显示 Info 对话框,对话框中将会显示:
- 发布到 Orchestrator 的程序包的名字,改名字将会显示在 Packages 页面或者在本地显示。
- 发布程序包的版本号码
- 如果程序被发布在本地,将会显示该项目被发布的路径
- Copy to Clipboard(复制到粘贴板)选项
发布项目时的限制
以下限制了库项目的发布:
库中含有已经勾选了 Isolated 选项的 Invoke Workflow File 活动,将不能发布。否则会在 Output 面板中输出一条错误信息。
当使用 Invoke Workflow File 时,要确保被调用的文件被放置在库项目的相同文件夹内。
Launch Workflow Interactive 不能在库项目中使用
在自动化项目中添加可重用组件
- 打开或者创建一个新的项目
- 在 All Packages 目录下,选择库或包
- 点击 OK 按钮,它们将会被添加到项目中。
- 可在 Activities 面板的自定义目录中找到相关的活动
注意 Libraries 是后向兼容的,这意味着它们只可以在 v2018.3 及更新版本中创建的项目中可用。在 2018.3 之前的版本中,库不能被发布到 Orchestrator 中。
请注意,在库项目中使用 Import Workflows 添加包含库的工作流时,库中引用的依赖项不会被导入。