Studio 用户指南

上次更新日期 2025年3月24日

关于 Windows - 旧版兼容性

Studio 2021.10 支持基于 .NET 的项目，并引入了基于机器人类型的项目兼容性概念。在 2021.10 之前的版本中，所有项目都使用 Windows - 旧版兼容性。从 Studio 2021.10 至 Studio 2024.10，除了“Windows 旧版”之外，您还可以选择创建具有 Windows 和跨平台兼容性的项目。

Automation Cloud 用户可以在以下几项之间选择：

Studio LTS - 以一年为发布周期提供长期稳定性。
Studio 持续发布 - 经常提供更新和新功能，同时保持可靠性。

要了解更多信息，请参阅产品生命周期支持条款页面。

下表突出显示了两个 Studio 版本之间的主要区别：

Studio 版本	目标受众	云连接要求	“Windows - 旧版”支持	支持模型	发布周期
Studio LTS Studio 年份.10.补丁例如：2024.10.8	需要长期支持、稳定性和“Windows - 旧版”支持的企业用户。可用于本地部署连接和 Automation Cloud/Automation Suite 连接。			长期支持 (LTS) 24 个月主流支持 + 12 个月扩展支持。	每年一次。
Studio 持续发布 Studio 年份.0.补丁例如：2025.0.157	希望经常更新和添加新功能，同时保持可靠性的企业用户。只能与 Automation Cloud 连接一起使用。			持续发布支持在下一次更新之前，每个版本都受支持。	每两个月检查一次。

在可预见的将来，Studio LTS 将继续允许打开和编辑“Windows - 旧版”项目。

Studio 持续发布不再允许创建或编辑“Windows - 旧版”项目。

允许创建“Windows - 旧版”项目的最后一个 Studio LTS 是 Studio 2024.10。您可以通过监管策略启用此选项。

将 Windows - 旧版项目转换为 Windows 兼容项目的优势

现在，新项目默认兼容 Windows。不再支持创建和编辑具有“Windows - 旧版”兼容性的项目，这意味着新功能仅在具有 Windows 和跨平台兼容性的项目中可用。

使用 Windows 或跨平台兼容性可释放未来的创新潜力，并为实现 UiPath Agentic Automation愿景做好准备，该愿景具有以下特征：

能够高效处理基于规则的结构化任务的机器人。
AI 驱动的代理，可处理非结构化数据并做出智能决策。
验证和监督关键自动化工作流的人工。

代理自动化使您能够利用 AI 驱动的跨企业系统决策，自动化更复杂的流程。

访问新功能

Windows 和跨平台项目使您可以使用在 Windows - 旧版中不可用的新一代功能，包括：

支持在数据管理器中创建全局变量和常量。
新的设计体验可用于跨平台项目和 Windows 项目中的某些活动。
能够自定义从库生成的活动的布局。
编码自动化。
Autopilot™功能。
通过长时间运行的工作流进行业务流程模型和表示法建模。

增强的性能和可扩展性

Windows 和跨平台项目：

已编译，可显着提高性能，从而减少自动化的执行时间。
适用于具有高事务量的大规模自动化场景。
具有新式内存管理和实时 (JIT) 编译。

增强的安全性

.NET 包含最新的加密算法和安全协议，以保护敏感数据。
主动维护可确保快速解决漏洞，将风险降到最低。

减少技术债务

转换 Windows 旧版项目可消除对已弃用库和过时技术的依赖。
未来的升级和增强将更加容易，也更具成本效益。
新式工作流更易于调试、扩展和适应不断变化的业务需求。

如何将 Windows - 旧版项目转换为 Windows 兼容的项目

重要提示：未找到与 Windows 兼容的版本的依赖项将标记为“未解析”，并且在转换后，“Windows - 旧版”项目中使用的版本将显示在“项目”面板中。由 UiPath 开发并在官方订阅源上提供的大多数活动包都支持 Windows 兼容性。有关完整列表，请参阅活动指南。

Studio 附带一个内置的转换工具，可用于将任何 Windows - 旧版项目转换为 Windows 项目。

将项目转换为 Windows 项目时：

项目依赖项是根据以下规则管理的：
- 如果配置的包源中存在相同版本的软件包，则不会更改 Windows - 旧版项目中使用的版本。
- 如果不存在相同版本的软件包，则 Windows - 旧版项目中使用的版本将更改为最近版本的最新补丁。
转换后的项目中将保留所有活动和属性。
Windows - 旧版和 Windows 项目中不同的命名空间已更新。
系统将添加 Windows 项目中所需的命名空间，并删除仅在 Windows - 旧版项目中使用的命名空间。

注意：在转换库在其中作为依赖项安装的流程之前，请转换并重新发布 Windows - 旧版库。

要将旧项目转换为 Windows 兼容的项目，请执行以下操作：

在 Studio 中打开 Windows - 旧版项目，并确保仅在一个 Studio 实例中打开该项目。系统将显示一个新窗口。
选择转换方式：
- 要使用 Windows 兼容性创建当前项目的副本并保留原始 Windows 旧版项目，请选择“新建项目”。输入新项目的名称、创建位置以及（可选）说明。
- 要更新现有项目并将其转换为与 Windows 兼容的项目，请清除“新建项目”复选框。如果选择此选项，则对项目所做的更改将无法撤消。
单击“转换”。

如果依赖项问题导致转换后活动无法解析，则每个此类活动顶部都会显示一条消息，指出该活动缺失或无法加载。每个活动都会提供以下信息：显示名称、活动命名空间、活动属性和值。单击“替换”以查找替代方法并替换缺失或无效的活动。有关更多信息，请参阅缺少活动或活动无效。

用于转换 Windows 旧版项目的蓝图

本分步指南旨在帮助您将自动化从 Windows 旧版无缝迁移到 Windows。

清单和评估- 准备所有 Windows - 旧版项目及其依赖项的详细清单：
- 列出所有项目、库和依赖项。
- 评估与 Windows (.NET) 环境的兼容性。
- 识别需要更新或替换的组件。
注意： NuGet Package Explorer应用程序可用于检查 .NET 目标框架。
概念验证- 在一小部分工作流上测试转换流程：
- 选择已添加库作为依赖项的代表性工作流。
- 执行试验性转换，以找出挑战和阻碍。
- 通过测试验证结果。
提示：
- 创建“Windows - 旧版”项目和库的备份。
- 迁移时，请勿更改项目或库的名称。
- 请先迁移库，然后发布。别担心 – 库的迁移版本不能在 Windows 旧版项目中使用。
扩展- 系统地转换所有项目和库：
- 迁移所有库并发布。
- 迁移所有项目。
“验证和测试” - 确保转换后的工作流按预期运行：
- 执行测试。
- 迭代解决错误或兼容性问题。
- 测试与外部系统和数据源的交互。
生产部署- 将项目转移到生产环境：
- 将工作流部署到生产中。
- 监控稳定性和性能问题。
- 如有必要，提供用户培训或更新的文档。
迁移后监控- 向 UiPath 报告迁移问题以供日后改进：
- 发送反馈。
- 与 UiPath 代表分享挑战或解决方案。

已知问题

问题	解决方案
某些表达式与 Windows 项目不兼容，需要手动更改才能成功将 Windows - 旧版项目转换为 Windows 项目。	`{}`为 `new Object() {}` `new Object() {task_output.Id.ToString,task_action,now,I_comment }`为 `new Object() {task_output.Id.ToString,task_action,now,I_comment }`
在转换之前有效的其他表达式生成的验证错误。	使用CTRL + X键盘快捷键剪切表达式，然后使用CTRL + V将其粘贴回活动字段。
在“遍历循环”活动中，将要迭代其值的变量命名为“表达式”会导致编译错误。	不要将变量命名为“表达式”。
`Communication between UiPath Studio and the Taxonomy Manager ended unexpectedly.`	转换包含旧版本智能 OCR 活动包的项目后，请确保升级到最新版本的智能 OCR 活动包。
`BC36915: Cannot infer an element type because more than one type is possible. Specifying the type of the array might correct this error.` `BC30512: Option Strict On disallows implicit conversions from 'Object()' to 'String()'. The selected value is incompatible with the property type.` `BC36914: Cannot infer an element type, and Option Strict On does not allow 'Object' to be assumed. Specifying the type of the array might correct this error.`	与旧版本相比，新式编程语言强制执行更严格的类型推断。将数组或元素转换为所需类型，例如： `{}`为 `new Object() {}` `<object>.ToString()` `CType(<element>, Object)`
编码敏感操作	使用InvokeMethod添加`System.Text.Encoding.RegisterProvider(System.Text.CodePagesEncodingProvider.Instance)` 。
`“` (0x201C) 与`"` (0x22)	将所有实例替换为`"` (0x22)，这是新式 .NET 中字符串文本唯一有效的引号。
`BC30311: Value of type 'SecureString' cannot be converted to 'CvString'. The selected value is incompatible with the property type.`	删除并重新添加计算机视觉活动参数。
`BC31424: Type ‘System.Data.DataTable' in assembly ‘…’ has been forwarded to assembly 'System.Data.Common’ …` `BC30652: Reference required to assembly ‘System.Collections’ … containing the type 'List(Of )'. Add one to your project.` `BC30057: Too many arguments to 'Public Overloads Property SpecificContent As Dictionary(Of String, Object)'.`	要修复这些验证错误，请执行以下操作：导航至包含错误的活动属性。删除配置（剪切或 Ctrl + X）。在活动外部单击。重新添加配置（“粘贴”或“Ctrl + V”）。