Studio 用户指南

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

关于 Windows - 旧版兼容性

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

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

Studio LTS - 以一年为发布周期提供长期稳定性。
Studio 持续发布，短期支持 (STS) - 提供频繁更新和新功能，同时保持可靠性。

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

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

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

在可预见的未来，您可以使用 Studio LTS 创建、打开和编辑 Windows - Legacy 项目。可以通过监管策略启用创建 Windows – Legacy 项目的选项。

Studio STS 不再允许创建或编辑 Windows - Legacy 项目。

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

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

具有 Windows 或跨平台兼容性可以帮助您开启未来创新，并帮助您为实现 UiPath 智能体自动化愿景做好准备。它具有以下特点：

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

智能体自动化使您能够利用 AI 驱动的决策，在企业系统中实现更复杂流程的自动化。

访问新功能

Windows 和跨平台项目让您可以访问不适用于 Windows - Legacy 的新一代功能，包括：

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

增强了性能和可扩展性

Windows 和跨平台项目：

经过编译，性能得到显著提升，缩短了自动化的执行时间。
非常适合交易量大的大规模自动化场景。
具有现代内存管理和即时 (JIT) 编译功能。

增强了安全性

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

减少了技术债务

转换 Windows-Legacy 项目可以减少对已弃用库和过时技术的依赖。
未来的升级和增强将更加轻松、更加经济高效。
现代工作流更易于调试、扩展并适应不断变化中的业务需求。

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

Important: Dependencies for which no versions with the Windows compatibility are found are marked as unresolved and the version used in the Windows - Legacy project is displayed in the Explorer panel after the conversion. Most activity packages developed by UiPath and available on the Official feed support the Windows compatibility. For a complete list, see the Activities Guides.

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

将项目转换为 Windows 项目时：

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

备注：

在转换库在其中作为依赖项安装的流程之前，请转换并重新发布 Windows - 旧版库。
Windows 项目和跨平台项目不支持 SOAP Web 服务。您只能在 Windows - Legacy 项目中使用此集成。

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

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

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

旧版库迁移场景

迁移旧版库时，请参阅以下场景：

使用 Studio 创建的旧版库（提供源代码）：先迁移库，将库发布，然后再迁移流程。
目标为 .NET Framework 的 .NET 库（提供源代码）：对于 .NET 库，请将目标更改为 .NET。您可以：
- 查看支持的 .NET Studio 版本（例如，Studio 24.10.X 可以在 .NET 8 上运行）。
- 设置多目标，以便同时支持 .NET Framework 和 .NET。
- 根据 .NET 版本使用不同的变体。net6.0-windows 目标仅与 Windows 项目兼容，而 net6.0 与 Windows 和跨平台项目都兼容。
注意：请参阅以下资源：
- 《SDK 指南》中的“使用代码创建活动”。
- 将活动迁移到。《SDK 指南》中的 "NET 6"。
- .NET SDK 项目的 MSBuild 参考。
第三方旧版库（不提供源代码）：使用 UiPath 推荐的替代方案替换活动。

转换 Windows - Legacy 项目的蓝图

本分步指南旨在帮助您将自动化从 Windows-Legacy 无缝过渡到 Windows。

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

已知问题

问题	解决方案
某些表达式与 Windows 项目不兼容，需要手动更改才能成功将 Windows - Legacy 项目转换为 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.`	转换包含较低版本的 IntelligentOCR 活动包的项目后，请务必升级到最新版本的 IntelligentOCR 包。
`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.`	移除 Computer Vision 活动参数，然后重新添加。
`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）。
Windows 项目和跨平台项目不支持 SOAP Web 服务。您只能在 Windows - Legacy 项目中使用此集成