- 发行说明
- 简介
- 监管
- 源代码控件
- CI/CD 管道
- 订阅源管理
- 日志记录
关于 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 包含两种类型:
-
UiPath.CLI.Windows
- 仅在 Windows 设备上运行。
- 构建 Windows - Legacy、Windows和 跨平台 项目。
-
UiPath.CLI
- 仅在 Linux 设备上运行。
- 仅构建 跨平台 项目。
在这里,您可以验证 CLI 版本、所需的 .NET 版本和目标机器人版本之间的兼容性。
CLI 版本 |
需要 .NET 版本 |
已构建自动化的目标 Robot 版本 |
---|---|---|
24.10 |
.NET 8 |
24.10 及以上版本 |
23.10 |
.NET 6 |
23.10+ |
23.4 |
.NET 6 |
23.4 及以上版本 |
uipcli.exe
(对于 UiPath.CLI.Windows)或uipcli.dll
(对于 UiPath.CLI),位于tools
文件夹中。
您用于创建项目的 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 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 订阅源的信息。
uipcli
在以下内置订阅源中搜索依赖项:
-
C:\Program Files\Microsoft SDKs\NuGetPackages
(如果此路径位于当前代理上) -
C:\Program Files (x86)\Microsoft SDKs\NuGetPackages
(如果此路径位于当前代理上)
--disableBuiltInNugetFeeds
参数来指定uipcli
不使用内置订阅源。 此参数可用于以下任务: analyze
、 pack
和test run
。使用配置文件运行uipcli
时,请设置"disableBuiltInNugetFeeds": true
。
打包自动化时可以使用自定义订阅源。
在 UiPath CLI 中使用自定义 nuget.config
要使用自定义订阅源,请执行以下步骤:
-
使用以下格式创建自定义
nuget.config
文件:<?xml version="1.0" encoding="utf-8"?> <configuration> <packageSources> <add key="test custom feed" value="custom_feed_url" /> </packageSources> </configuration>
<?xml version="1.0" encoding="utf-8"?> <configuration> <packageSources> <add key="test custom feed" value="custom_feed_url" /> </packageSources> </configuration> -
将自定义
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'
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()
)
}
}
}
}
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()
)
}
}
}
}