Studio 用户指南

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

关于 Windows - 旧版兼容性

Studio 2021.10 支持基于 .NET 的项目，并引入了基于目标框架的项目兼容性概念。在 2021.10 之前的版本中，所有项目都使用 .NET Framework 4.6.1，但自 Studio 2021.10 起，您可以选择使用 Windows - 旧版兼容性 (.NET Framework 4.6.1) 或基于 .NET 的 Windows 和跨平台兼容性创建项目。

Windows - 旧版项目不会收到新功能

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

例如，Studio 2022.10 中引入的以下功能在 Windows - 旧版项目中不可用：

支持在数据管理器中创建全局变量和常量。
新的设计体验可用于跨平台项目和 Windows 项目中的某些活动。
能够自定义从库生成的活动的布局。

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

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

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

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

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

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

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

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

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

编辑、发布和运行 Windows - 未来的版本将继续支持旧项目，这意味着您可以像其他 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 兼容的项目，请清除“新建项目”复选框。如果选择此选项，则对项目所做的更改将无法撤消。
单击“转换”。

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

旧版库迁移场景

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

使用 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）。