CI/CD 集成发行说明
发布日期：2026 年 5 月 18 日
新增功能
打包库时覆盖活动根类别
打包库项目时，生成的包公开的每个活动都会获得一个根类别前缀。默认情况下，该前缀是库项目名称。使用新的--activitiesRootCategory参数，您可以覆盖它，而无需重命名项目。
uipcli package pack "C:\projects\MyLibrary\project.json" -o "C:\Output" --activitiesRootCategory "MyCompany.Finance.Invoicing"
uipcli package pack "C:\projects\MyLibrary\project.json" -o "C:\Output" --activitiesRootCategory "MyCompany.Finance.Invoicing"
生成的.nupkg中的活动将显示在安装该库的任何项目的“Studio 活动”面板中的MyCompany.Finance.Invoicing下。
该参数仅在打包库项目时有效。对于Process 、 Tests和Objects输出类型，系统会忽略它。若省略此项，行为保持不变：根类别回退为库项目名称，与 Studio 中的“库发布”对话框生成的名称相符。
在打包期间跳过分析器和验证
工作流分析器和项目验证作为package pack的一部分自动运行。有两个新的标志可让您选择退出任一步骤：
--skipAnalyze— 在打包步骤中跳过运行工作流分析器。--skipValidate— 在打包步骤中跳过项目验证步骤。
uipcli package pack "C:\projects\MyProject\project.json" -o "C:\Output" --skipAnalyze --skipValidate
uipcli package pack "C:\projects\MyProject\project.json" -o "C:\Output" --skipAnalyze --skipValidate
在以下情况下使用这些标志：
- 您的管道已运行
package analyze或在早期阶段（例如，在合并前检查中）验证了项目，并且您不想在pack再次支付相同的成本。 - 您正在生成用于本地调试的快速包，并且仅需要工件。
对于发布管道，建议仍启用这两个步骤。
仅从以下位置解析依赖项 --nugetConfigFilePath
新的--excludeConfiguredSources标志不包括 UiPath 的内置订阅源以及运行 CLI 的主机上的用户级别和计算机级别 NuGet 配置（通常为%AppData%\NuGet\NuGet.Config和%ProgramFiles(x86)%\NuGet\Config ）。CLI 仅解析通过--nugetConfigFilePath传递的nuget.config文件中定义的订阅源中的包。
uipcli package pack "C:\projects\MyProject\project.json" -o "C:\Output" \
--nugetConfigFilePath "C:\ci\nuget.config" \
--excludeConfiguredSources
uipcli package pack "C:\projects\MyProject\project.json" -o "C:\Output" \
--nugetConfigFilePath "C:\ci\nuget.config" \
--excludeConfiguredSources
在以下情况下使用此标志：
- 您需要可重现的隔离内部版本，其中仅会查阅您在版本控制中声明的订阅源。
- 共享的构建智能体具有您不希望进入特定管道的计算机级别订阅源。
- 您正在调试由于主机级别 NuGet 配置不同而导致的“在智能体 A 上有效，在智能体 B 上失败”问题。
使用配置文件运行uipcli时，请设置"excludeConfiguredSources": true 。
确保您的nuget.config声明了项目所需的每个订阅源，包括任何等效的 UiPath 订阅源，因为设置此标志时不会查阅其他来源。
为分析器繁重的项目提高了 Linux 和 macOS 上的性能
以前，当在 Linux 或 macOS 上打包产生大量工作流分析器警告的项目时，CLI 以前在实际编译完成后需要几分钟才能排出分析器消息。CLI 与 SolutionPackager 之间的内部通信通道已切换到命名管道/Unix 域套接字传输，从而消除了该瓶颈。
不需要用户操作 — 以前在 Linux 上需要 15 分钟以上才能生成详细分析器输出的包，现在编译完成后只需几秒钟即可完成。Windows 行为保持不变。
更快还原 — 单次运行不再重复进行 NuGet 下载
当单次 CLI 调用触发多个还原步骤（例如，验证然后打包的pack ，或还原每个项目的solution pack ）时，可能会多次下载相同的 NuGet 包，因为 HTTP 缓存窗口已经用完步骤之间已过期。CLI 现在可在单次运行中缓存已下载的包 15 分钟，因此后续还原步骤会重用本地副本，而不是从订阅源中重新获取。
不需要用户操作 — 具有许多依赖项的项目的执行 NuGet 还原的命令速度显着加快。
启动时打印的版本和 runtime
现在，每个 CLI 调用都会在其第一行输出中打印一个横幅：
uipcli: version 25.10.16, running on .NET 8.0.x
uipcli: version 25.10.16, running on .NET 8.0.x
这使支持日志具有自描述性 — 可以明确哪个 CLI 内部版本或哪个 Runtime 生成了给定的日志文件。