SDK

Using The Activity Creator

活动是流程自动化的构建块。每个活动都包含一个原子操作，这些原子操作与其他活动堆叠在一起，构成工作流。

UiPath Studio 包含许多预构建的活动，您可以通过包管理器安装这些活动。

此外，您可以使用 UiPath适用于 Visual Studio 的 Activity Creator 扩展程序根据需要创建自己的自定义活动。以下步骤将为您提供在 5 分钟内构建自定义活动的基础知识。在本节中，我们将创建一个活动包，在下一节中，我们将向其中填充功能性活动。

您需要满足的条件

安装了 .NET 桌面开发工作负载的 Visual Studio 2022 社区版/专业版/企业版
UiPath 的 UiPath 市场订阅源 (https://Gallery.uipath.com/api/v3/index.json) 作为 Visual Studio 中的包源。有关添加包来源的说明，请参阅此处。
.NET 6
UiPath Studio

重要提示：

请注意，Activity Creator 4.0 版仅适用于 Visual Studio 2022。同样，生成的活动以 .NET 6 Windows 项目为目标。要创建与旧版 Visual Studio 或 .NET 兼容的活动，请使用版本 3 的扩展程序。

此外，此扩展程序创建的活动依赖于 UiPath 市场订阅源 (https://gmail.uipath.com/api/v3/index.json) 上当前可用的 UiPath 库。在开发过程中，此订阅源在 Visual Studio 中必须可用，否则将无法成功构建活动。

步骤 1：将 UiPath Activities Creator 扩展程序添加到 Visual Studio

打开 Visual Studio 并单击 “扩展程序” >“管理扩展程序” 。

在出现的向导中，单击“在线”，然后单击“搜索”（ Ctrl+E ）以查找 UiPath。下载 UiPath Activity Creator 扩展程序。

Close Visual Studio and, once the VSIX Installer appears, complete the installation.

步骤 2：创建 UiPath 项目

重新打开 Visual Studio 并双击主屏幕上的“创建新项目”。

在“新建项目”屏幕上，在搜索栏中键入“uipath”，选择“ UiPath 标准活动项目” ，然后单击 “下一步” 。

为您的项目命名。 UiPath 约定为 <Your company's name>.<Your product's name> （例如 UiPath.Orchestrator）。然后单击 “创建” 。

导航到“解决方案资源管理器”，请注意，3 个项目、一个共享文件夹和许多文件现已添加到解决方案中。这是每个活动包的基础。用于添加第一个活动的简单活动。

The Simple Activity

创建包后，我们可以向其中添加活动！在此示例中，您将创建如上所示的活动：将两个数字相加的简单活动。

您需要满足的条件

步骤 1：打开 Activity Creator

首先打开在上一节中创建的 Visual Studio 解决方案，然后在“解决方案资源管理器”中选择任何主项目（这些是标记为 MyCompany.MyProduct... 的项目）。然后在工具栏中导航至“ 扩展程序”>“UiPath”>“添加活动 ”。请注意，在选择其中一个项目之前，系统将禁用此菜单。

步骤 2：构建活动

这将打开一个新的“活动创建者”窗口。第一个屏幕为您提供两个选项：

创建：从头开始构建一个或多个活动。
导入: 导入以标准格式保存的预定义活动列表。

现在，选择“创建”。

步骤 3：定义活动

单击“添加”按钮并填写每个字段，如下所示。这将使创建者准备好构建名为“加法”的活动。准备就绪后，单击“编辑”按钮以将属性添加到“加法”活动。

步骤 4：添加属性

这将打开一个新的“ 定义属性 ”窗口。使用“ 添加 ”按钮创建 3 个属性，如下所示。

确保前两个为输入，最后一个为输出。这些属性将表示两个数字及其总和。

步骤 5：生成活动

在属性窗口中单击确定，在活动窗口中单击完成。然后，您将看到一些新文件添加到项目中。

步骤 6：添加功能

打开刚才创建的 Addition.cs 文件，然后展开其中的 Protected Methods 区域，以显示活动的 ExecuteAsync 方法。每当在 UiPath Studio 中运行活动时都会调用此方法。

请注意，在步骤 4 中创建的两个输入（第一个数字和第二个数字）以及一个输出（Sum）已添加到此方法中。最后一步是弥合它们之间的差距，方法是将注释块替换为将两个输入相加的代码，然后将结果设置为 Sum。见下文：

步骤 7：构建包

在“解决方案资源管理器”中，右键单击“设计”项目，然后选择“ 发布”。此选项将构建您的项目，将它们打包在一起，然后将包发送到您想要的任何位置。

在下一个屏幕中，输入要用于保存活动包的文件夹。最好从 UiPath Studio 中选择一个包来源（可在 Studio 主页上的 “设置” >“管理源” 中找到这些包来源），以便直接从 Visual Studio 发布到 UiPath Studio。

单击“ 创建配置文件 ”以继续。

在下一页上，将包来源重命名为 UiPath Packages （或任何您喜欢的名称），并将配置更改为 Debug。然后单击 “发布”。

有关调试与发布配置的更多信息，请参阅包元数据。

然后，您的输出将显示所有三个项目都已成功构建并已发布生成的包。您现在拥有一个有效的活动包！

步骤 8：在 UiPath Studio 中使用您的活动

打开 UiPath Studio，导航到包管理器，然后将活动集添加到工作流中。

请注意，“活动”窗格中已添加一个新类别。

就是这样！尝试新活动!

Package Metadata

查看本教程中构建的活动包，您会看到几个占位符，其中应包含作者、许可证、图标等信息。让我们通过将这些占位符替换为真实信息来个性化包。

本节的重点是“设计”项目，该项目包含所有包信息。

您需要满足的条件

步骤 1：打开设计项目

双击打开 MyCompany.MyProduct.Activities.Design 项目，您会发现其中包含三个已标记的部分：

Package Metadata
程序包版本
程序包图标

Package Metadata

字段	描述
`PackageLicenseExpression`	您要使用的许可证的SPDX 标识符。默认值为Apache 2.0 。
`Description`	将显示在 UiPath Studio 包管理器中的活动的简短说明。
`Authors and Company`	包的作者和所有者。
`Copyright`	标准版权声明。
`PackageTags`	用户可以搜索以查找您的包的术语列表。
`PackageProjectUrl`	指向活动文档或公司主页的链接。
`PackageIconUrl`	指向用作包图标的图像文件的链接。请注意，UiPath Studio 当前不支持 `PackageIcon` 标签。

<PropertyGroup>
    <PackageRequireLicenseAcceptance>true</PackageRequireLicenseAcceptance>
    <PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>
    <Description>A package used to perform simple arithmetic operations in UiPath Studio.</Description>
    <Authors>My Company</Authors>
    <Company>My Company</Company>
    <Copyright>@ 2020 My Company</Copyright>
    <PackageTags>UiPath Activity MyCompany MyProduct Math Addition Arithmetic</PackageTags>
    <PackageProjectUrl>https://docs.uipath.com/integrations/docs/how-to-create-activities</PackageProjectUrl>
    <PackageIconUrl>https://raw.githubusercontent.com/NuGet/Samples/master/PackageIconNuspecExample/icon.png</PackageIconUrl>
    ...
</PropertyGroup><PropertyGroup>
    <PackageRequireLicenseAcceptance>true</PackageRequireLicenseAcceptance>
    <PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>
    <Description>A package used to perform simple arithmetic operations in UiPath Studio.</Description>
    <Authors>My Company</Authors>
    <Company>My Company</Company>
    <Copyright>@ 2020 My Company</Copyright>
    <PackageTags>UiPath Activity MyCompany MyProduct Math Addition Arithmetic</PackageTags>
    <PackageProjectUrl>https://docs.uipath.com/integrations/docs/how-to-create-activities</PackageProjectUrl>
    <PackageIconUrl>https://raw.githubusercontent.com/NuGet/Samples/master/PackageIconNuspecExample/icon.png</PackageIconUrl>
    ...
</PropertyGroup>

Package Version

请注意，此处有两个 PackageVersion 标签，分别对应于可构建包的两种模式（调试和发布）。

调试在开发过程中非常有用。版本随每个内部版本而递增，因此可以进行更新，然后立即在 UiPath Studio 中进行测试。

“版本 ”用于创建可供发布的最终包。开发完成后，您可以在此处设置所需的版本。

<PropertyGroup Condition="'$(Configuration)' == 'Debug'">
    <PackageVersion>0.2.0.$([System.DateTime]::UtcNow.ToString(MMddHmmss)) Version</PackageVersion>
</PropertyGroup>
  
<PropertyGroup Condition="'$(Configuration)' == 'Release'">
    <PackageVersion>0.2.0</PackageVersion>
</PropertyGroup><PropertyGroup Condition="'$(Configuration)' == 'Debug'">
    <PackageVersion>0.2.0.$([System.DateTime]::UtcNow.ToString(MMddHmmss)) Version</PackageVersion>
</PropertyGroup>
  
<PropertyGroup Condition="'$(Configuration)' == 'Release'">
    <PackageVersion>0.2.0</PackageVersion>
</PropertyGroup>