- 发行说明
- 入门指南
- 设置和配置
- 自动化项目
- 依赖项
- 工作流类型
- 控制流程
- 文件比较
- 自动化最佳实践
- 源代码控件集成
- 调试
- 日志记录
- 诊断工具
- 工作流分析器
- 变量
- 参数
- 导入的命名空间
- 编码自动化
- 基于触发器的 Attended 自动化
- 对象存储库
- ScreenScrapeJavaSupport 工具
- 扩展程序
- Studio 测试
- 故障排除

Studio 用户指南
关于自动化项目
Studio 支持您创建以下类型的项目:
- “流程”- 设计并发布自动化流程,以便机器人可以执行该流程。
- 库 - 将工作流设计为可重用组件,并将项目发布为可作为依赖项添加到多个流程的库。有关更多信息,请参阅“关于库”。
- 测试自动化 - 设计测试自动化项目。有关测试自动化的更多信息,请参阅“Studio 测试”部分。
- 模板 - 设计流程并将其作为模板发布,以便具有共同特征的其他流程可以基于该模板。有关更多信息,请参阅“项目模板”。
要创建新的空白项目,请转到“主页”(Studio 后台视图)>“开始”,然后在“新建项目”下选择要创建的项目类型。或者,您可以从“从模板新建”下的其中一个默认模板开始,或转到“模板”选项卡以浏览来源多样的更多模板。

在新项目窗口中,为每个项目配置以下内容:
- 为新项目输入名称(最多 128 个字符)和描述,以概括您打算如何使用此自动化项目(最多 500 个字符)。
- 选择创建项目的位置。创建项目的默认位置为
%USERPROFILE%\Documents\UiPath。 - 选择“兼容性”和“语言”。
备注:
创建项目后,无法更改兼容性和语言。但是,您可以将 Windows 旧版项目转换为兼容 Windows 的版本。
默认情况下,项目文件夹包含以下文件和子文件夹:
- 文件
Main.xaml- 默认创建用于保存主工作流。此外,您添加到项目的所有其他自动化 XAML 文件都存储在项目文件夹中。(可选)您可以将其他文件设置为主文件。所有文件都必须通过“调用工作流文件”活动链接到设置为主文件的文件或标记为项目入口点的文件。对于测试自动化项目,默认情况下会创建TestCase.xaml文件,而不是Main.xaml。备注:- 您无法运行包含名为
Init.xaml的 XAML 文件的 Windows 项目。 - 放置在项目根文件夹中的 XAML 文件不能与包含其他 XAML 文件的子文件夹同名。
- 您无法运行包含名为
project.json- 包含有关自动化项目的信息。
- 子文件夹
.entities- 如果项目中使用了实体,则包含有关从 Data Service 导入的实体的数据。.local- 包含为项目在本地缓存的数据。备注:.local文件夹已隐藏。您可以从“Windows 文件资源管理器”设置中启用隐藏项目查看功能。.local文件夹不应在项目之间共享。
.objects- 如果项目中使用了添加到对象存储库的任何项目,则包含与此等项目相关的数据。.project- 包含添加到项目中的标签。.screenshots- 如果在项目中使用了任何用户界面自动化活动,则包含在此等活动中生成的参考截图。.settings- 包含运行时使用的活动项目设置。.templates- 包含添加到项目中的文件模板。.tmh-如果在项目中使用了任何测试用例,则包含与此等用例相关的数据。备注:使用较新版本 Studio 创建的项目可能无法与较旧 Studio 版本一起使用。阅读有关向后和向前兼容性的更多信息。
不能在文件名中使用以下字符:", <, >, |, :, *, ?, \, /,;。这些字符来自 Microsoft Windows 限制和其他特殊字符限制。
在 Automation Cloud™ Robot – VM 和 Automation Cloud™ Robot – Serverless 上运行 Studio 流程不适用于开发目的。
设置项目兼容性
创建新项目时,请根据要运行项目的环境选择兼容性:
- Windows - 使用具有 Windows 支持的 .NET 8。这是默认选项。
- 跨平台 - 使用具有跨平台支持的 .NET 8。
- Windows - 旧版 - 使用 .NET Framework 4.6.1,即 2021.10 之前的版本中使用的兼容性框架。
重要提示:
- Windows 和跨平台流程需要 Orchestrator 2021.10 及更高版本才能运行。
- “Windows - 旧版”选项不再适用于新项目。我们建议在创建新项目时选择 Windows 或跨平台。您可以将 Windows 旧版项目转换为 Windows 兼容项目,或使用监管策略还原创建 Windows 旧版项目的选项。
要了解兼容性之间的差异,请参阅下表格。要了解有关每个兼容性设计体验的更多信息,请参阅“设计自动化”。
| Windows - 旧版 | Windows | 跨平台 | |
|---|---|---|---|
| 流程执行 | 32 位 | 64 位 | 64 位 |
| 支持的执行平台 | Windows(64 位) | Windows(64 位) | Windows、Linux 和 macOS(64 位) |
| 流程在发布时进行编译 | 否。已发布的包中包含项目源文件。 | 是。已发布的包中包含已编译的 DLL 文件。 | 是。已发布的包中包含已编译的 DLL 文件。 |
只有支持所选兼容性的活动包才能从包管理器中安装。
每个项目的兼容性显示在 Studio 状态栏的右侧和“项目”面板 > 依赖项节点中。在“主页”(Studio 后台视图)>“开始”选项卡的“打开最近的项目”列表中,每个项目的条目中也会显示兼容性。
- 不支持在兼容性不同的项目之间复制和粘贴活动。
- 如果 Studio 在重新打开或重新加载 Windows 或跨平台项目时发现验证错误,系统会提示您自动导入缺少的引用。
设计跨平台项目
跨平台项目使您能够创建不需要用户交互的自动化,以及使用 Chrome 的网页浏览器自动化。跨平台自动化可以在 Windows 和 Unix 这样的操作系统(例如 Linux 和 macOS)上执行。
要创建具有跨平台支持的无人值守项目,请执行以下操作:
- 在 Studio 中,创建新项目,然后选择“跨平台兼容性”选项。此选项可用于所有项目类型。对于使用 VB 语言表达式的流程,您可以选择同时在 Studio 和 Studio Web 中工作。
- 设计自动化。请注意,并非所有活动包都与跨平台项目兼容,因此包管理器中仅提供一些包。详细了解跨平台项目的设计体验。 跨平台项目的默认依赖项包括:
- 在 Studio 配置文件中:UiPath.System.Activities、UiPath.Testing.Activities、UiPath.WebApi.Activities 和 UiPath.UIAutomation.Activities。
- 在 StudioX 配置文件中:UiPath.System.Activities、Microsoft Office 365、Google Workspace 和 UiPath.UIAutomation.Activities。
- 测试自动化。我们建议使用远程调试在将运行自动化的计算机上测试自动化程序,该调试程序适用于 Windows 机器人、Linux 机器人和 macOS 机器人。
- 在测试完自动化后,请将项目发布到 Orchestrator。Windows、macOS 和 Linux 运行 Unattended 作业的过程相同。
重要提示:
此版本的 Studio 与 Studio 2022.4 或更早版本中提供的旧版跨平台活动包版本不兼容。如果您在 Studio 2022.10 之前的版本中创建了跨平台项目,则在 Studio 2022.10 或更高版本中编辑它们之前,请将已安装的包更新为最新版本。某些属性可能无法再进行编辑。
在 Studio Web 中打开项目
只有最新的 Studio 企业版和社区版支持在 Studio Web 中打开项目。
如果您想直接从浏览器中通过任何设备随时随地设计跨平台项目,则可以将项目添加到云中,并在 UiPath Automation Cloud™ 中的自动化设计器 Studio Web 中进行编辑。将项目添加到云端时,系统始终会同步更改,从而使您可以在桌面和网页之间无缝切换,并从上次中断的地方继续操作。
- Studio Web 不支持使用 C# 语言编写表达式的跨平台项目,以及 Windows 项目(无论使用 VB 还是 C# 语言)。您可以将 C# 跨平台项目或 Windows 项目保存到云,但无法在 Studio Web 中进行编辑。
- 无法在 Studio Web 中打开包含流程图工作流的项目。
在 Studio 中管理云项目
要与 Studio Web 兼容,跨平台项目必须满足以下要求:
- 项目类型为流程。
- 表达式的语言是 VB。
要将本地项目保存到云中,请选择 Studio 功能区中的“保存”,然后选择“保存到 Cloud”。将项目保存到 Studio Web 后,状态栏中的标签将更改为“云项目”。单击标签以打开下拉菜单,其中包含使您能够管理项目的选项:
-
在 Studio Web 中打开 - 在 Studio Web 中打开项目。 如果项目被 Studio Web 锁定,系统会显示一条错误消息,并在新选项卡中以只读模式打开项目。
-
同步到云 - 获取您在 Studio Web 中所做的最新更改。如果远程项目和本地项目之间存在差异,则必须首先确认是否要覆盖本地版本。

其他选项可在 Studio 功能区中的“保存”下找到:
- 另存为 - 保存当前工作流文件。
- 全部保存 - 保存对项目所做的所有更改。
- 同步到 Cloud - 将您在 Studio 桌面版中所做的最新更改保存到 Studio Web 中的项目。如果远程项目有更改,则必须首先确认是否想要覆盖更改。如果项目被 Studio Web 锁定,则无法同步到 Cloud。
备注:
在已在 Studio Web 中打开的项目中尝试使用“在 Studio Web 中打开”选项时,会出现“保存到 Cloud 失败”错误。
- 保存副本 - 将当前项目在本地另存为新项目。您可以编辑名称,选择保存位置,并输入项目说明。
您可以在 Studio Web 的项目资源管理器中查看所有项目文件和文件夹,但只能编辑类型为“序列”的工作流。
同样,当您在 Studio Web 中创建项目时,您可以选择继续在 Studio 中工作。从 Studio Web 中的“项目”页面中,打开项目右侧的菜单,然后选择“在桌面版 Studio 中打开”。
如何在 Studio 和 Studio Web 之间同步更改
在 Studio 中保存并关闭云项目时,如果 Studio Web 未锁定该项目,则所做更改也会保存在远程项目中。 然后,当您在 Studio Web 中打开项目时,该项目将使用您在 Studio 中保存到 Cloud 的任何更改进行更新。
在 Studio 中打开云项目时,项目会使用您在 Studio Web 中所做的任何更改进行更新。要使用 Studio Web 中的最新更改更新已在 Studio 中打开的项目,请在 Studio 状态栏中选择“Cloud 项目”>“获取最新版本”。
在这两种情况下,如果本地项目和远程项目之间存在差异,系统均会提示您确认,然后再继续。
在 Studio Web 中对项目进行重大更改可能会使其与 Studio 不兼容,反之亦然。
将跨平台项目转换为 Windows 项目
通过将跨平台项目转换为 Windows 兼容性项目,您可利用仅在 Windows 项目中可用的活动(例如,桌面用户界面自动化、Excel 或表单活动),从而可以通过 Studio 中的桌面自动化轻松完善 Studio Web 项目。要将跨平台项目转换为 Windows,您可以:
- 在 Studio 中,右键单击“项目”面板中的项目,然后从菜单中选择“转换为 Windows”。在 StudioX 中,从 StudioX 窗口顶部的功能区选择“项目”>“转换为 Windows”。
- 将仅在 Windows 项目中可用的活动添加到您的项目中。“Windows 活动”面板类别列出了仅在 Windows 项目中可用的可安装活动。当您从“活动”面板或“添加活动”搜索栏中将此类活动添加到项目中时,系统会提示您将项目转换为 Windows。
在这两种情况下,系统都会显示一个新窗口,您可以在其中执行以下操作:
- 选择新建项目,以使用 Windows 兼容性创建当前项目的副本,并保留原始跨平台项目。
- 清除“新建项目”复选框,以更新现有项目并将其转换为 Windows 兼容的项目(此操作无法撤消)。
设置项目语言
在 Studio 配置文件中创建新项目时,您可以选择用于表达式的语言(VB 或 C#)。VB 是默认选择的语言,但您可以转到“主页”(Studio 后台视图)>“设置”>“设计”,将 C# 设置为新项目的默认语言。在 StudioX 配置文件中创建的项目使用 VB.NET 语言编写表达式。
不支持在同一项目中同时使用 VB 和 C# 表达式。无法在 C# 工作流中使用 VB 表达式,反之亦然。在复制其他项目中的活动、调用或导入工作流时,请确保其使用的语言与目标项目相同。
您可以将 C# 库安装为 VB 项目中的依赖项,反之亦然。但是,无法从安装库的项目访问使用语言特定的表达式为库项目中的参数定义的默认值。
C# 局限性
这些限制仅适用于 Windows 旧版项目,在此版本中默认不可用。
- 当前的 C# 实现基于使用 C# 版本 5 的 C# 编译器,因此限制了对诸如合并分配、null 条件运算符、null 合并运算符、字符串插补等新功能的访问。
- 包含带增量表达式的项目无效。
- 包含
nameof()运算符的表达式被标记为无效,并且当前 C# 实现中不允许使用。 - 包含对带可选参数方法的调用的表达式必须包含可选参数的值。
- 与 VB.NET 相比,C# 项目的设计时间和运行时性能较低。当运行时性能至关重要时,我们建议使用 VB.NET 而不是 C#。
- 每次使用 C# 运行 Windows - 旧版项目都会在文件夹
%appdata%\Temp中创建一个已编译的 DLL 文件,系统不会在运行项目后自动删除该文件。如果需要考虑存储问题,您可以:- 通过 C# 使用 Windows 或跨平台项目。
- 通过 VB 使用 Windows - 旧版项目。
- 执行后手动删除不必要的文件。
设置项目版本
语义版本控制
语义版本控制方案采用 Major.Minor.Patch[-Suffix] 格式,其中:
- Major 是主要版本。
- Minor 是次要版本。
- Patch 是补丁版本。
- -Suffix(可选)是连字符加一串句点分隔的标识符,紧接在补丁版本后。这表示预发行版本。
标识符必须仅由 ASCII 字母数字和连字符组成,并且不得为空。数字标识符不得以零开头。此外,内部版本元数据必须通过以下方式表示:附加一个加号及一串以句点分隔的标识符,紧接在补丁版本或预发行版本后面,例如 1.0.0-alpha+1。
在新建流程或库时,默认版本方案是语义版本。可以从“发布”窗口中更改,只需在版本号中添加额外一位数字即可。项目的语义版本可也从 project.json 文件修改。版本号为 major.minor 的项目将自动添加补丁编号 0。
传统版本控制
为项目生成的传统版本号采用 M.m.bbbb.rrrrr 格式,其中:
- M 表示主要版本。
- m 表示次要版本。
- bbbb 表示内部版本。
- rrrrr 表示修订版本。
也可以在 project.json 文件中编辑主要版本和次要版本,而内部版本和修订版本是根据某种算法生成 - 内部版本值是指自 01.01.2000 以来经过的天数。修订值是当天至发布时所经过的秒数。其结果除以 2,使得最大的修订编号不会超过 65535。
“发布”窗口中的建议版本号基于项目的以往版本控制方案生成,对于采用 4 位数版本控制方案的项目则考虑使用当前的日期和时间戳。
管理项目

“项目”面板可用于查看和筛选当前项目的内容,添加文件夹,打开文件位置,管理依赖项,以及调整项目设置。

将文件资源管理器中的文件直接复制并粘贴到“项目”面板。您还可使用拖放功能对一个或多个文件执行相同操作,包括 .xaml 工作流。您还可以使用 Ctrl + C 和 Ctrl + V 快捷键或上下文菜单中的“复制”和“粘贴”选项来复制面板内的文件或文件夹。
您可以双击小于 10 MB 的 TXT、CS、VB、JSON(不包括 project.json 文件)和 XML 文件,在 Studio 中使用文本编辑器进行编辑,并突出显示语法。
| 选项 | 描述 |
|---|
| 全部展开
| 展开自动化项目中的所有节点。 |
| 全部折叠
| 折叠自动化项目中的所有节点。 |
| 刷新
| 刷新项目。 |
| 与活动文档同步 | 聚焦于“设计器”面板中处于活动状态的项目元素。 |
| 显示所有文件
| 显示从属于自动化项目的所有文件,包括 project.json。 |
| 文件资源管理器
| 打开计算机上项目的位置。 |
| 项目设置
| 打开流程或库的“项目设置”窗口。 |
| 按文件类型筛选
| 按文件类型筛选当前项目中可以在 Studio 中编辑的文件:工作流、测试用例、表单、代码、文本、对象(默认禁用)、显示隐藏文件夹(默认禁用)。 要查看项目文件夹中的所有文件,请选择“其他”(默认禁用)。 |
项目的上下文菜单
右键单击“项目”面板中的任意位置以打开上下文菜单,其中包含下表中所述的选项。选项的不同子集是否可用,取决于您在面板中的右键单击位置、项目类型以及是否将项目添加到来源控件。
| 选项 | 描述 |
|---|---|
| 打开项目文件夹 | 打开包含项目的本地文件夹。 |
| 项目设置 | 打开用于调整屏幕首选项的“项目设置”窗口。 |
| 添加 | 使用工作流基于内置模板(序列、流程图、状态机)或本地文件模板创建工作流文件。 |
| 导入文件 | 打开“文件资源管理器”窗口,将文件导入项目。默认情况下,应用 *.xaml 筛选条件以仅列出工作流文件,但您可以将其更改为所有文件以导入其他文件类型。如果导入的文件名与当前项目中的工作流名称一致,则“已导入”将添加到该文件名中。 您只能导入使用与当前项目相同的表达式语言的工作流文件。导入工作流文件时,系统会将当前项目的依赖项与源项目文件中的依赖项(如果有)进行比较。如果存在任何差异,系统将显示“导入工作流”窗口,其中包含有关为避免未解决的活动而需要进行的更改的信息。默认情况下选择可用的依赖项更新,并在选择“导入”时安装。
(可选)您可以指定要用作参考的 project.json 文件,并选择是否在预发行包版本中搜索。 |
| 转换为 Windows | 在 Windows - 旧版和跨平台项目中,打开“转换为 Windows”窗口,您可以在其中将项目转换为兼容 Windows 的项目。 |
| 添加到来源控件 | 将项目添加到来源控件后,上下文菜单中将提供其他选项。请参阅 Git 选项以及 SVN 和 TFS 选项。 |
| 打开 | 使用默认程序打开所选文件。 |
| 打开文件位置 | 打开包含该文件的本地文件夹。 |
| 重命名 | 用于重命名选定的文件或文件夹,并打开重命名项目窗口。在所有情况下,该项目均已重命名。注意:新文件的完整路径不得超过 258 个字符。 |
| 复制 | 将选定的文件或文件夹复制到剪贴板。然后,您可以将其粘贴到项目面板或“Windows 文件资源管理器”中。 |
| 粘贴 | 粘贴已复制到剪贴板的文件或文件夹。 |
| 删除 | 仅会从本地计算机中删除选定的项目。 |
| 选择进行比较 | 选择当前文件以进行比较。 |
| 与选定项比较 | 使用“比较文件”将当前文件与之前选定的文件进行比较。 |
| 查找引用 | 查找项目中对文件的所有引用。结果显示在“查找引用”面板中。 |
| 在文本编辑器中打开 | 在 Studio 的文本编辑器中以只读模式打开选定的文本文件。 要以编辑模式打开文本文件,请双击该文件。您可以双击小于 10 MB 的 TXT、CS、VB、JSON(不包括 project.json 文件)和 XML 文件,在 Studio 中使用文本编辑器进行编辑,并突出显示语法。 |
| 调试文件 | 调试所选的 .xaml 文件。 |
| 设置为“主要” | 在项目定义中将选定的 .xaml 文件设置为“主要”,这意味着项目执行从该文件开始。只能有一个主项目文件。设置为主文件的文件名称将在“项目”面板中以粗体显示。 |
| 活动布局 | 打开库项目中文件的“属性”窗口,您可以在其中自定义所生成活动的设计。 |
| 设置为全局处理程序 | 将 .xaml 文件设置为项目的“全局异常处理程序”。这适用于每个项目/流程的工作流。 |
| 删除处理程序 | 从 .xaml 文件中删除“全局异常处理程序”标签。 |
| 启用入口点 |
|
| 禁用入口点 | 不再将选定的工作流文件标记为流程的入口点。此选项不适用于设置为“主要”的工作流文件。 |
| 参数属性 | 打开“参数属性”窗口,以配置参数的显示设置。 此选项仅适用于设置为主或标记为项目入口点的 XAML 文件。 |
| 提取为模板 | 将选定的工作流或测试用例另存为模板,然后项目中的其他文件可以以此为基础。当您需要创建具有相同结构的多个文件时,使用文件模板可以节省时间。添加新的工作流或测试用例时,您可以选择基于“模板”项目文件夹中存在的相同类型的任何模板。 |
| “从发布中忽略”/“设置为可发布” | 将一个或多个选定文件标记为已从发布中排除或可发布。
|
| “设为私有”/“设为公开” | 将库项目中的一个或多个选定文件标记为私有或公开。已发布的包中包含私有工作流文件,但在将库作为依赖项安装的项目中,“活动”面板中并未创建且提供可重用组件。
|
| 创建测试用例 | |
| “转换为测试用例”/“转换为工作流” | 将选定的工作流转换为测试用例,或将选定的测试用例转换为工作流。 |
| 导入测试用例 | 将测试用例作为测试用例草稿导入项目中。 |
| 添加测试数据 | 打开“导入数据变体源”窗口,该窗口用于将测试数据添加到项目中。此选项仅适用于测试用例。 |
| 链接到 Test Manager | 打开“链接到测试管理器”窗口,该窗口用于将选定的测试用例链接到“测试管理器”。 |
| “运行测试用例”/“调试测试用例” | 运行或调试多个选定的测试用例。 |
GIT 的上下文菜单选项
在添加到 GIT 存储库的项目中,“项目”面板中的每个文件旁边都会显示一个图标,以指示文件状态:
该文件与存储库同步。
该文件已被修改。
已添加该文件。
该文件已被移除。
在项目面板中,右键单击一个文件或项目节点打开 GIT 专属上下文菜单,以使用 GIT 管理项目。

| 选项 | 描述 |
|---|---|
| 提交 | 将当前更改提交到本地 GIT 存储库。 |
| 推送 | 将当前版本推送到远程存储库。 |
| 拉取(重定基准) | 拉取远程文件,并为当前分支重定基准。 |
| 管理分支 | 打开“GIT”窗口,其中含有管理当前添加的分支的选项。 |
| 显示更改 | 打开“文件区别”窗口,以比较文件的本地版本和远程版本相比的更改。 |
| 显示历史 | 打开“显示历史”窗口,以比较同一文件的两个版本。 |
| 撤消 | 如果文件未提交或推送到远程存储库,则打开“撤消待定更改”窗口。 |
| 复制存储库 URL | 将项目的存储库 URL 复制到剪贴板。 |
SVN 和 TFS 的上下文菜单选项
在添加到 SVN 或 TFS 存储库的项目中,“项目”面板中的每个文件旁边都会显示一个图标,以指示文件状态:
该文件未签出以进行编辑。
该文件已签出进行编辑。
该文件已被编辑。
已添加该文件。

| 选项 | 描述 |
|---|---|
| 打开 | 如果没有从 TFS/SVN 存储库签出所选 .xaml 文件进行编辑,请在“设计器”面板中以只读模式打开所选 .xaml 文件。 |
| 重命名 | 用于重命名选定的文件或文件夹,并打开“重命名项目”窗口。在签入重命名 .xaml 文件后,还必须签入先前修改的版本。 |
| 删除 | 仅会从本地计算机中删除选定的项目。文件的最新签入版本在 TFS/SVN 存储库中仍然可用。 |
| 签出以进行编辑 | 将选定的文件或文件夹标记为锁定以进行编辑。签出某个文件会在服务器上锁定此文件,这样其他人就无法编辑此文件。 |
| 完成编辑 | 签入存储库中的 project.json 文件,包括变更和提交消息。 |
| 添加 | 将选定项目上传到 TFS/SVN 服务器。如果项目先前已上传到服务器,则此选项不可用。 |
| 获取最新版本 | 从 TFS/SVN 存储库下载所选项的最新版本。 |
| 显示更改... | 打开“文件区别”,以比较版本化文件和本地映射文件之间的更改。 |
| 签入 | 显示“签入更改”窗口,用于将选定的项目作为最新版本上载到服务器。必须首先保存 .xaml 文件,然后才能将其上传。签入后,文件在 Studio 中变为只读。 |
| 撤消 | 显示“撤消待定更改”窗口,并用于还原已对项目所做的更改:或者将已修改的文件还原为先前状态或无版本控制状态,或者检索已从本地计算机中删除的文件。 在签入文件后,无法恢复更改。 |
| 运行 | 运行所选工作流,即使它没有签出或没有添加到存储库。 |
| 设置为“主要” | 在项目中,将选定的 .xaml 文件设置为“主要”。默认情况下,第一个创建的 .xaml 被设置为“主要”。 |
| 复制存储库 URL | 将项目的存储库 URL 复制到剪贴板。 |
调整项目设置
可以为您正在处理的每个自动化项目建立一组单独设置。这些设置位于“项目设置”窗口中,单击“项目”面板中的
即可打开此窗口。

设置窗口字段说明
下表描述了流程、测试自动化和模板项目的项目设置。有关库可用设置的信息,请参阅关于库。
| 字段 | 描述 |
|---|---|
| 名称 | 更改项目名称。此类名称可能包含空格字符。在命名项目时,请记住在发布时删除空格字符。该字段最多接受使用 128 个字符。 |
| 描述 | 更改项目说明。该字段最多接受使用 500 个字符。 |
| 项目标签 | 您可以通过创建新标签或重用 Orchestrator 中已定义的标签来向项目添加一个或多个标签。标签有两种类型:“标签”和“属性”(键值对)。标签包含在已发布的包中,它们有助于描述项目并对其进行分类。例如,它们可以引用自动化应用程序( 当您开始输入时,系统会根据已定义的标签建议可能的匹配项,您可以通过从匹配项列表中选择一个标签来重复使用它。对于属性匹配,首先显示紧跟着 要添加新标签,请在输入名称后,单击名称旁边带有加号的条目。通过使用 标签和键值属性限制为 256 个字符。标签名称不能包含以下字符:<、>、%、&、\、?、/、: 项目标签可以自动应用于 Orchestrator 中的流程。有关使用标签的更多信息,请参阅 Orchestrator 指南中的“使用标签组织资源”。 |
| Automation Hub URL | 链接到项目的 Automation Hub 概念的 URL。有关详细信息,请参阅将项目链接到 Automation Hub 中的概念。 |
| 程序包图标 | (可选)定义项目的自定义图标。您可以浏览并选择一个文件,或者为大小至多 1MB 的 jpeg、jpg 或 png 文件输入路径或公共 URL。 项目发布后,图标显示如下:
如果将本地文件用于发布到 Orchestrator 的库或不支持嵌入式图标的订阅源,则此图标在“管理包”中不可见。在这种情况下,请使用 URL 指明该图标。 |
| 禁用暂停 | 启用或阻止用户从 UiPath Assistant 暂停执行。如果在执行期间暂停流程可导致其崩溃,请设为“是”。例如,如果工作流中的某一活动使用了 Timeout 属性,暂停执行可能会导致超时过期,因而破坏执行。 |
| 有人值守的自动化 | 设为“是”表示仅应在有人值守上下文中执行项目。为包含“用户界面自动化”活动或其他需要用户交互的活动的项目使用此设置。 |
| 在后台启动 | 设置为“是”以将项目转变为“后台流程”,并允许它与其他流程同时在后台运行,只要不使用用户界面交互功能即可。 |
| 支持暂留 | 设置为“是”,以标记流程支持暂留。 |
| 单独的 Runtime 依赖项 | 为了提高机器人性能并缩小已发布包的大小,现在将库分为设计包和运行时包。设计包由 Studio 使用,更精简的执行包由机器人使用。 |
| 包含的源 | 设为 Yes 以打包发布的包中的所有 .xaml 源,包括先前设为私有的工作流。对于 Windows - 旧版库,这些文件保存在生成的程序集文件和 lib\net45 文件的 .nupkg 文件夹中。对于 Windows 和跨平台库与流程,文件将保存在 content 文件的 .nupkg 文件夹中。 |
| PiP 选项 | 指明项目是否已使用画中画 (PiP) 进行测试,以及是否应默认在 PiP 中启动项目。
|
| PiP 类型 | 选择以 PiP 运行项目时如何将自动化与用户会话隔离:“新建会话”(计算机上的子会话)或“新建桌面”(用户会话中的虚拟桌面)。 |
单击“确定”,所做的更改即可在“项目”面板和 project.json 文件中查看。
查看“配置活动项目设置”页面,了解如何在项目级别调整活动属性。
请注意,每当要将一个序列中的大量活动复制到另一个序列时,我们均建议您事先向下滚动到“设计器”面板底部。这是因为 Windows Workflow Foundation 限制的关系。
删除未使用的项目资源
不必要的资源可能会使项目更难理解,并可能影响性能。为避免此问题,请从项目中删除未使用的资源,方法是单击 Studio 功能区中的删除未使用的,然后选择要删除的资源:
- 工作流 - 删除项目中未引用的工作流文件。
- 变量 - 删除当前已打开文件中未使用的变量。
- 参数 - 删除当前已打开文件中未使用的参数。
- 依赖项 - 删除项目中未使用任何活动的已安装活动程序包。
- 导入 - 删除当前已打开文件中未使用的已导入命名空间。
- 屏幕截图 - 删除项目中任何活动未使用的信息截图。
表示缺少应安装的依赖项。
表示应更新到的源项目中使用的较新版本。