关于 Windows - 旧版兼容性

在 2021.10 版本引入基于.NET 的项目类型后，在 Studio 中迁移和管理 Windows 旧版兼容性项目。

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

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

现在，新项目默认兼容 Windows，尽管我们继续支持 Windows - 旧版兼容性，但新功能仅适用于具有 Windows 和跨平台兼容性的项目。

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

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

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

访问新功能

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

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

增强了性能和可扩展性

Windows 和跨平台项目：

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

增强了安全性

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

减少了技术债务

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

如何继续创建 Windows - 旧版项目

虽然您只能从“后台”视图创建具有 Windows 或跨平台兼容性的新项目，但组织仍然可以通过配置“允许的兼容性框架”设置，使用监管策略来恢复创建 Windows - 旧版项目的选项。要执行此操作：

1. 导航到 Automation Ops™ > “监管”。
2. 定义一个新的 Studio 监管策略。请务必使用 24.10.0 Studio 策略模板。
3. 在“监管策略”窗口中，选择“设计”选项卡，然后滚动到“设计样式”区域。
4. 启用“允许的兼容框架”设置，然后选择“Windows - Legacy”目标框架。
5. 保存并部署监管策略。

有关详细信息，请参阅《Automation Ops 指南》中的“Studio 策略设置”。

您也可以使用文件格式的监管模型来配置设置：

1. 从 Studio 生成 JSON 监管文件。
2. 在监管文件中找到“允许的项目框架”设置。
3. 将“经典”参数的值设置为“真”。
4. 保存并部署监管文件。

有关详细信息，请参阅《Studio 指南》中的“监管”部分。

要及时了解即将到来的更改情况，请参阅弃用时间表。

如何编辑现有 Windows - 旧版项目

未来版本将继续支持编辑、发布和运行 Windows - 旧版项目。Windows - 旧版项目可在专用于 Windows - 旧版项目的新 Studio 旧版实例中打开。此 Studio 旧版实例用于编辑、发布 Windows - 旧版项目并将其转换为 Windows 兼容项目。

备注：

Studio 旧版实例目前不适用于 Studio 持续发布，短期支持（STS）。 Studio STS 目前不允许创建或编辑 Windows - 旧版项目。

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

重要提示：

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

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

将项目转换为 Windows 项目时：

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

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

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

1. 在 Studio 中打开 Windows - 旧版项目，并且仅在一个 Studio 实例中打开该项目。
2. 在“项目”面板中打开项目节点的上下文菜单，然后选择“转换为 Windows” 。系统将显示一个新窗口。

3. 选择转换方式：
   • 要使用 Windows 兼容性创建当前项目的副本并保留原始的 Windows - Legacy 项目，请选择“新建项目”。输入要创建项目的位置。新项目的名称为“旧项目名称 + _Windows”。
   • 要更新现有项目并将其转换为与 Windows 兼容的项目，请清除“新建项目”复选框。如果选择此选项，则对项目所做的更改将无法撤消。
4. 选择“转换” 。

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

旧版库迁移场景

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

1. 使用 Studio 创建的旧版库（提供源代码）：先迁移库，将库发布，然后再迁移流程。
2. 目标为 .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 参考。
3. 第三方旧版库（不提供源代码）：使用 UiPath 推荐的替代方案替换活动。

转换 Windows - Legacy 项目的蓝图

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

1. 盘点和评估 - 整理所有 Windows - Legacy 项目及其依赖项的详细清单：
   • 列出所有项目、库和依赖项。
   • 评估与 Windows (.NET) 环境的兼容性。
   • 确定需要更新或更换的组件。
   备注：

   NuGet 包资源管理器应用程序可用于检查 .NET 目标框架。

2. 概念验证 - 在工作流的一个小子集上测试转换流程：
   • 选择已将库添加为依赖项的代表性工作流。
   • 进行转换试验，以确定面临的挑战和阻碍。
   • 通过测试验证结果。
   提示：

   • 创建 Windows - Legacy 项目和库的备份。
   • 迁移时请勿更改项目或库的名称。
   • 先迁移库，然后再发布。不用担心——库的迁移版本无法用于 Windows - Legacy 项目。
3. 扩展 - 系统地转换所有项目和库：
   • 迁移所有库，然后发布。
   • 迁移所有项目。
4. 验证和测试 - 确保转换后的工作流按预期运行：
   • 执行测试。
   • 以迭代方式解决错误或兼容性问题。
   • 测试与外部系统和数据源的交互。
5. 生产部署 - 将项目迁移到生产环境：
   • 将工作流部署到生产环境。
   • 监控稳定性及性能相关问题。
   • 必要时，提供用户培训或更新文档。
6. 迁移后监控 - 向 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）。