CICD 集成 - UiPath Install Platform

cicd-integrations

2025.10

true

CI/CD 集成用户指南

重要 :

请注意，此内容已使用机器翻译进行了部分本地化。新发布内容的本地化可能需要 1-2 周的时间才能完成。

UiPath 安装平台

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

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

何时使用此任务

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

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

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

备注：

此任务是可选的。如果未指定，Jenkins 将自动使用与插件捆绑的 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 - 仅限旧版项目

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

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

处理混合项目类型

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

UiPath CLI 版本选取器

从“选择 CLI 版本”下拉列表中选择要使用的 UiPath CLI 版本。

下拉列表中的选项包括：

UiPath CLI 25.10 及更高版本的可用版本。
CLI 风格（Windows、Linux 或 Windows.Legacy）。
每个版本的 .NET 运行时要求。

UiPath CLI nupkg 的路径（离线方案）

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

从UiPath 公共订阅源下载所需的 UiPath CLI 版本。
将下载的.nupkg文件置于智能体工作区目录中可访问的位置。

示例： ${WORKSPACE}/nupkg/UiPath.CLI.Windows.25.10.3.nupkg ${env.ProgramFiles}\\CLIVersions\\UiPath.CLI.Windows.Legacy.25.10.9424.14050.nupkg
在“UiPath 安装平台”任务配置中，将 CLI 版本设置为“自定义版本” ，并在“CLI nupkg 路径”字段中提供.nupkg文件的路径。

重要提示：

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

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

管道示例

pipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('Build') {
      steps {
         UiPathInstallPlatform(
            cliVersion: 'Windows.25.10.0-20251104-11',
            traceLevel: 'Information',
         )
      }
    }
  }
}
pipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('Build') {
      steps {
         UiPathInstallPlatform(
            cliVersion: 'Windows.25.10.0-20251104-11',
            traceLevel: 'Information',
         )
      }
    }
  }
}

pipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('Build') {
      steps {
        UiPathInstallPlatform(
            cliVersion: 'CustomVersion',
            cliNupkgPath: 'C:\Tools\UiPath.CLI.Windows.25.10.3.nupkg',
            traceLevel: 'Information',
         )
      }
    }
  }
}
pipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('Build') {
      steps {
        UiPathInstallPlatform(
            cliVersion: 'CustomVersion',
            cliNupkgPath: 'C:\Tools\UiPath.CLI.Windows.25.10.3.nupkg',
            traceLevel: 'Information',
         )
      }
    }
  }
}

后续步骤

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

在此页面上

何时使用此任务
CLI 风格
处理混合项目类型
推荐方法
UiPath CLI 版本选取器
UiPath CLI nupkg 的路径（离线方案）
管道示例
后续步骤

此页面有帮助吗？

前一个运行 Jenkins 作业

下一个项目任务

何时使用此任务​

CLI 风格​

处理混合项目类型​

推荐方法​

UiPath CLI 版本选取器​

UiPath CLI nupkg 的路径（离线方案）​

管道示例​

后续步骤​