关于 UiPath CLI

UiPath™ 提供命令行界面 (CLI)，允许您执行某些预定义任务，以管理和测试 RPA 包。 UiPath CLI 的目的是轻松地将这些功能与第三方工具（如 GitLab、Jenkins 等）集成，而无需插件。

备注：

UiPath CLI 可与通过 Automation Cloud™、Automation Suite 部署的 Orchestrator 一起使用，或独立使用。

UiPath CLI 的常见用例包括：

• 将 Studio 项目打包到 NuGet 包中。
• 正在将 NuGet 包部署到 Orchestrator。
• 在 Orchestrator 中运行作业。
• 在 Orchestrator 中运行测试集。

UiPath CLI 包含两种类型：

1. UiPath.CLI.Windows

   • 仅在 Windows 设备上运行。
   • 构建 Windows - Legacy、Windows和 跨平台 项目。

2. UiPath.CLI

   • 仅在 Linux 设备上运行。
   • 仅构建 跨平台 项目。

备注：

• 注意：UiPath CLI 不支持 SSO 连接。

• UiPath CLI 不能用于构建使用本地触发器的项目。

• UiPath CLI 缺少对包进行签名的功能，而从 Studio 发布包时可以使用此功能。 在这种情况下，唯一的选项是在使用 UiPath CLI 构建包后对包进行签名。 有关详细信息，请参阅签名命令。 此签名选项也适用于 Azure DevOps 和 Jenkins。

先决条件

在这里，您可以验证 CLI 版本、所需的 .NET 版本和目标机器人版本之间的兼容性。

CLI 版本	需要 .NET 版本	已构建自动化的目标 Robot 版本
24.10	.NET 8	2024.10+
23.10	.NET 6	2023.10+
23.4	.NET 6	2023.4 及更高版本

对于UiPath.CLI.Windows ，您还必须安装附带 .NET SDK 的.NET Desktop Runtime 。

下载 UiPath CLI

您可以从UiPath 官方公共订阅源下载任何版本的 UiPath CLI。

1. 转到 UiPath 官方公共订阅源。
2. 在“ 按关键字筛选” 搜索栏中，键入uipath.cli 。
3. 选择以下任一选项：
   • UiPath.CLI - 专为 Linux 设备设计的 UiPath CLI
   • UiPath.CLI.Windows - 专为 Windows 设备设计的 UiPath CLI
4. 转到“ 版本 ” 选项卡，然后选择要下载的 CLI 版本。
5. 选择“ 下载”。
6. 打开下载 NUPKG 文件的文件夹，右键单击该文件夹，然后将文件提取到文件夹中。

结果：系统将创建一个与 NUPKG 文件同名的文件夹。 此文件夹包含 UiPath CLI 的内容。 所有操作的入口点为uipcli.exe （对于 UiPath.CLI.Windows）或uipcli.dll （对于 UiPath.CLI），位于tools文件夹中。

UiPath.CLI.Windows 兼容性列表

您用于创建项目的 UiPath Studio 版本需要与 UiPath.CLI.Windows 的版本匹配。

图例： - 兼容； - 不兼容。

Orchestrator	项目类型	UiPath.CLI.Windows 23.10	UiPath.CLI.Windows 23.6	UiPath.CLI.Windows 22.10
版本 2023.10.x PaaS	Windows - 旧版
版本 2023.10.x PaaS	Windows
版本 2023.10.x PaaS	跨平台
2021.10.x内部部署	Windows - 旧版
2021.10.x内部部署	Windows
2021.10.x内部部署	跨平台
2021.10.xPaaS	Windows - 旧版
2021.10.xPaaS	Windows
2021.10.xPaaS	跨平台
2022.4.x	Windows - 旧版
2022.4.x	Windows
2022.4.x	跨平台
2022.10.x	Windows - 旧版
2022.10.x	Windows
2022.10.x	跨平台
2023.4.x	Windows - 旧版
2023.4.x	Windows
2023.4.x	跨平台
Cloud	Windows - 旧版
Cloud	Windows
Cloud	跨平台

UiPath.CLI 兼容性列表

您用于创建项目的 UiPath Studio 的版本需要与 UiPath.CLI 的版本匹配。 例如，如果您使用 UiPath Studio 2021.10 创建项目， 您需要使用 21.10 版本的 UiPath.CLI。

图例： - 兼容； - 不兼容。

Orchestrator	项目类型	UiPath.CLI 23.10	UiPath.CLI 23.6	UiPath.CLI 22.10	UiPath.CLI 22.4	UiPath.CLI 21.10
版本 2023.10.x PaaS	Windows - 旧版
版本 2023.10.x PaaS	Windows
版本 2023.10.x PaaS	跨平台
2021.10.x内部部署	Windows - 旧版
2021.10.x内部部署	Windows
2021.10.x内部部署	跨平台
2021.10.xPaaS	Windows - 旧版
2021.10.xPaaS	Windows
2021.10.xPaaS	跨平台
2022.4.x	Windows - 旧版
2022.4.x	Windows
2022.4.x	跨平台
2022.10.x	Windows - 旧版
2022.10.x	Windows
2022.10.x	跨平台
2023.4.x	Windows - 旧版
2023.4.x	Windows
2023.4.x	跨平台
Cloud	Windows - 旧版
Cloud	Windows
Cloud	跨平台

管理 NuGet 订阅源

本节介绍如何管理内置 NuGet 订阅源。 此外，它还提供有关如何根据特定项目要求使用自定义 NuGet 订阅源的信息。

禁用内置 NuGet 订阅源

默认情况下， uipcli在以下内置订阅源中搜索依赖项：

• https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json

• https://gallery.uipath.com/api/v2

• https://api.nuget.org/v3/index.json

• C:\Program Files\Microsoft SDKs\NuGetPackages （如果此路径位于当前代理上）
• C:\Program Files (x86)\Microsoft SDKs\NuGetPackages （如果此路径位于当前代理上）

您可以通过设置--disableBuiltInNugetFeeds参数来指定uipcli不使用内置订阅源。 此参数可用于以下任务： analyze 、 pack和test run 。使用配置文件运行uipcli时，请设置"disableBuiltInNugetFeeds": true 。

使用自定义 NuGet 订阅源

打包自动化时可以使用自定义订阅源。

在 UiPath CLI 中使用自定义 nuget.config

要使用自定义订阅源，请执行以下步骤：

1. 使用以下格式创建自定义nuget.config文件：

   <?xml version="1.0" encoding="utf-8"?>
   <configuration>
     <packageSources>
       <add key="test custom feed" value="custom_feed_url" />
     </packageSources>
   </configuration>

2. 将自定义nuget.config文件放置在缓存uipcli的文件夹中：

   

在 Azure DevOps 中使用自定义 nuget.config

在InstallPlatform步骤之后，您需要更新配置并将nuget.config复制到$(Agent.ToolsDirectory)/uipcli ，如以下示例所示：

trigger:
- main

pool:
  vmImage: ubuntu-latest

stages:
- stage: Demo
  jobs:
    - job: Demo
      steps:
        - task: UiPathInstallPlatform@4
          inputs:
            cliVersion: 'X_23.6.8581.19168'
        
        - task: CopyFiles@2
          inputs:
            SourceFolder: '$(Build.SourcesDirectory)'
            Contents: 'nuget.config'
            TargetFolder: '$(Agent.ToolsDirectory)/uipcli'

        - task: UiPathPack@4
          inputs:
            versionType: 'AutoVersion'
            projectJsonPath: '$(Build.SourcesDirectory)/AutomationProjects/CrossPlatform/VB/ProjectWithCustomLibraryFromOrchestrator_CrossPlatform_VB/project.json'
            outputPath: '$(Build.ArtifactStagingDirectory)/Output'
            traceLevel: 'Information'

在 Jenkins 中使用自定义 nuget.config

在InstallPlatform步骤之后，您需要更新配置并将nuget.config复制到${WORKSPACE}/CLI ，如以下示例所示：

pipeline {
    agent {
        label 'plugins-jenkins-lts-agent-01'
    }

    stages {
        stage('Clone') {
            steps {
                git (
                    branch: 'main',
                    url: 'https://github.com/al3xandru-uipath-qa/CI-Plugins-Customer-Support.git'
                )
            }
        }
        
        stage('Install Platform') {
            steps {
                UiPathInstallPlatform (
                    traceLevel: 'Information'
                )
            }
        }
        
        stage('Copy nuget.config') {
            steps {
                bat 'copy nuget.config CLI\\nuget.config'
            }
        }
        
        stage('Pack') {
            steps {
                UiPathPack (
                    outputPath: '${WORKSPACE}/Output',
                    projectJsonPath: '${WORKSPACE}/AutomationProjects/CrossPlatform/VB/ProjectWithCustomLibraryFromOrchestrator_CrossPlatform_VB/project.json',
                    traceLevel: 'Information',
                    version: AutoVersion()
                )
            }
        }
    }
}