UiPath 安装平台

使用 UiPath 安装平台任务在 Azure DevOps 构建代理上下载并安装 CLI。

UiPathInstallPlatform任务下载特定版本的 UiPath CLI 并将其安装到 Azure DevOps 代理的工具缓存中。此任务适用于独立自动化项目（流程、库、测试）和解决方案。

何时使用此任务

在下列情况下，请使用UiPath 安装平台任务：

• 您想要显式控制管道中使用的 CLI 版本。
• 您需要根据项目类型安装特定的 CLI 风格（请参阅下面的CLI 风格）。
• 您的构建代理无法通过互联网访问 UiPath 公共订阅源。
• 您需要在智能体上缓存 CLI，以加快后续构建速度。

在管道中的任何其他 UiPath 任务之前执行UiPath 安装平台任务。

备注：

此任务是可选的。如果未指定，Azure DevOps 将自动使用与扩展程序捆绑的 CLI 版本。但是，使用此任务为您提供了显式控制，并通过缓存提高构建性能。

CLI 风格

UiPath CLI 在特定于平台的包中分发：

平台	架构	CLI 包	支持的项目类型
Windows	x64	UiPath.CLI.Windows	跨平台、Windows（非旧版）、解决方案
Linux	x64	UiPath.CLI.Linux	跨平台, 解决方案
macOS	ARM64 (Apple 芯片)	UiPath.CLI.macOS	跨平台, 解决方案
Windows	x64	UiPath.CLI.Windows.Legacy	Windows - 仅限旧版项目

备注：

macOS 支持当前仅适用于 ARM64（Apple 芯片）处理器。不支持基于 Intel 架构的 Mac。

所有 CLI 包都需要 .NET 8 Runtime：

• Windows 智能体：.NET Desktop Runtime 8
• Linux 代理：.NET Runtime 8
• macOS 智能体：.NET Runtime 8

处理混合项目类型

如果您的存储库包含多种项目类型（例如，Windows 旧版项目和跨平台项目），则需要安装多种 CLI 版本，并使用正确的 CLI 处理每种项目类型：

推荐方法

1. 安装UiPath.CLI.Windows并处理所有跨平台和 Windows（非旧版）项目。
2. 单独安装UiPath.CLI.Windows.Legacy并处理所有 Windows 旧版项目。

您可以通过以下方式在同一个 Azure DevOps 管道中实现此目的：

• 使用具有不同 CLI 版本的多个“UiPath 安装平台”任务。
• 组织管道阶段，以使用适当的 CLI 处理每个项目类型。
• 根据文件夹结构或命名约定使用条件逻辑来识别项目类型。

提示：

UiPath CLI 没有自动检测项目类型的方法。您必须知道存储库中的哪些项目是 Windows 旧版项目，并相应地组织管道。

CLI 版本选择器

从“选择 CLI 版本（必填）”下拉列表中选择要使用的 CLI 版本。

下拉列表中的选项包括：

• UiPath CLI 25.10 及更高版本的可用版本。
• CLI 风格（Windows、Linux、macOS 或 Windows.Legacy）。

CLI nupkg 的路径（离线方案）

如果您的 Azure DevOps 智能体无法访问 UiPath 公共订阅源，则可以手动提供 CLI 包：

1. 从 UiPath 公共订阅源中下载所需的 CLI 版本。

2. 将下载的.nupkg文件放置在生成代理的Agent.Tools目录中。

   示例：$(Agent.ToolsDirectory)\nupkg\UiPath.CLI.Windows.25.10.3.nupkg。

3. 在“UiPath 安装平台”任务配置中，将 CLI 版本设置为“自定义版本” ，并在“CLI 的 nupkg 的路径” 字段中提供.nupkg文件的路径。

重要提示：

确保自定义版本 CLI 包名称与官方订阅源中的包名称完全匹配，如下所示：

• UiPath.CLI.Windows.25.10.3.nupkg
• UiPath.CLI.Linux.25.10.3.nupkg

YAML 管道

您可以使用 YAML 格式配置 UiPath 安装平台任务：

基本示例

# Windows
- task: UiPathInstallPlatform@6
  displayName: 'Install UiPath CLI for Windows'
  inputs:
    cliVersion: 'Windows.25.10.3'

# Linux
- task: UiPathInstallPlatform@6
  displayName: 'Install UiPath CLI for Linux'
  inputs:
    cliVersion: 'Linux.25.10.3'

# macOS (Apple Silicon)
- task: UiPathInstallPlatform@6
  displayName: 'Install UiPath CLI for macOS'
  inputs:
    cliVersion: 'macOS.25.10.3'

# Windows Legacy
- task: UiPathInstallPlatform@6
  displayName: 'Install UiPath CLI for Windows Legacy'
  inputs:
    cliVersion: 'Windows.Legacy.25.10.9424.14050'

对于具有混合项目类型的存储库，请安装两种 CLI 风格：

# Install CLI for Cross-platform and Windows (non-legacy) projects
- task: UiPathInstallPlatform@6
  displayName: 'Install UiPath CLI Windows'
  inputs:
    cliVersion: 'Windows.25.10.3'

# Install CLI for Windows-Legacy projects
- task: UiPathInstallPlatform@6
  displayName: 'Install UiPath CLI Windows Legacy'
  inputs:
    cliVersion: 'Windows.Legacy.25.10.9424.14050'

要安装 CLI 的自定义版本，请执行以下操作：

- task: UiPathInstallPlatform@6
  displayName: 'UiPath Install Platform'
  inputs:
    cliVersion: 'CustomVersion'
    cliNupkgPath: 'C:\Tools\UiPath.CLI.Windows.25.10.3.nupkg'

后续步骤

• 执行 Azure DevOps 任务- 了解如何配置和执行 Azure DevOps 管道。
• Azure DevOps 项目任务- 探索独立自动化项目的任务。
• Azure DevOps 解决方案任务- 探索解决方案的任务。