UiPath 包

用于通过 Azure DevOps 打包 UiPath 项目的“UiPath 打包”任务配置和参数。

使用 UiPathPack 任务，您可以将现有的 UiPath 项目打包到 NuGet 包中。

配置

使用下表配置 UiPath Pack 输入。

参数	描述
显示名称是必填项	输入租户的名称。
选择版本控制方法(必需)	您可以选择自动生成的版本、使用项目版本或定义新版本。有关更多信息，请参阅“包版本”。
版本(必填项)	仅与动态分配策略一起在新式文件夹中可用。手动指定包版本可更高效追踪已生成的包及其源版本控制。例如，可利用 Microsoft 程序集模式生成 NuGet 包版本：[Major].[Minor].[BuildNumber].[RevisionNumber]。 可用的选项包括： 自动版本：此选项自动将版本更新为下一个连续编号。您可以使用以下任务配置示例： 任务 - task: UiPathPack@3 inputs: versionType: AutoVersion projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' - 任务：UiPathPack@3 输入：版本类型：AutoVersion 项目 Json 路径：'$(projectFolder)/project.json' 输出路径：'$(Build.artifactStagingDirectory)\artifact-manifests' “手动版本”（默认版本） ：使用此选项，您可以指定自己的版本号。您可以使用以下任务配置示例： 任务 - task: UiPathPack@3 inputs: versionType: ManualVersion version: '$(Build.BuildNumber)' projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' - 任务：UiPathPack@3 输入：版本类型：手动版本版本：“$(Build.BuildNumber)”项目 Json 路径：“$(projectFolder)/project.json”输出路径：“$(Build.artifactStagingDirectory)\artifact-manifests” “当前版本”（不推荐） ：此选项使版本保持与project.json文件中指定的版本相同。您可以使用以下任务配置示例： 任务 - task: UiPathPack@3 inputs: versionType: CurrentVersion projectJsonPath: '$(projectFolder)/project.json' outputPath: '$(Build.ArtifactStagingDirectory)\artifact-manifests' - 任务：UiPathPack@3 输入：版本类型：当前版本项目 Json 路径：'$(projectFolder)/project.json' 输出路径：'$(Build.artifactStagingDirectory)\artifact-manifests'
项目路径(必填)	选择要打包的项目的位置。该位置可为 project.json 文件的直接路径，或包含一个或多个项目的目录。如果是后者，则针对每个级别，系统均会分别打包每个项目。
选择输出类型（仅手动版本控制需要）	为要打包的项目设置项目类型。如果设置None ，则将从项目的 JSON 文件中提取项目类型。支持以下项目类型：“流程”、“库”、“测试”、“对象”、“无”。
需要 Orchestrator 连接。	配置服务连接以访问 UiPath Orchestrator 服务。您只能为此步骤配置连接，也可以使用现有的全局连接。有关更多信息，请参阅“配置 UiPath Orchestrator 服务连接”。
输出路径（必填）	设置要放置包的文件夹路径。
将输出拆分为设计库和运行时库	选择此选项可将输出拆分为设计库和运行时库。默认情况下，此选项未激活。
禁用内置 NuGet 订阅源	选择此选项以禁用内置 NuGet 订阅源。默认情况下，此设置为 false。
源代码版本信息和 Automation Hub 概念 URL	选择此选项可启用包元数据，包括源代码版本信息和 Automation Hub 概念 URL。启用后，您可以指定存储库详细信息和项目 URL。
远程存储库中 project.json 的完整路径	指定远程存储库中“project.json”的完整路径。当启用包元数据时可用。
提交 ID	指定版本控制系统中的提交 ID。当启用包元数据时可用。示例： $(Build.SourceVersion)
存储库分支	指定存储库分支名称。当启用包元数据时可用。示例： $(Build.SourceBranchName)
存储库的类型（例如：Git）	指定存储库的类型（例如，git）。当启用包元数据时可用。
Automation Hub 概念 URL	指定 Automation Hub 概念 URL，以将包链接到特定自动化概念。当启用包元数据时可用。
发行说明	指定包的发行说明。当启用包元数据时可用。
运行工作流分析	选择此选项可对自动化项目运行工作流分析规则（例如，出现错误时失败的作业）。默认情况下，此选项未激活。有关更多信息，请参阅“应用程序测试工作流分析器规则”。
监管文件路径	指定包含工作流分析器规则的监管策略的路径。可以从 Automation Ops 下载策略，也可以从 Studio 导出的压缩 ZIP 文件中提取策略。在启用工作流分析时可用。
证书路径	指定 .pfx 中证书文件的路径用于对包进行签名的格式。如果提供，系统将使用证书对包进行数字签名。示例： $(Build.SourcesDirectory)\certificates\signing-cert.pfx
证书密码	指定证书的密码。建议将此值作为密码变量存储在 Azure DevOps 中。示例： $(CertificatePassword)
时间戳服务器 URL	指定要在对包进行签名时使用的时间戳服务器的 URL。即使在证书过期后，时间戳记也可确保签名有效。示例： https://timestamp.digicert.com
追踪级别	从下拉列表中选择用户。

YAML 管道

您可以为 UiPath 包预览完全解析的 YAML 文档。

示例：基本包创建

- task: UiPathPack@2
  inputs:
    versionType: AutoVersion
    projectJsonPath: '$(Build.SourcesDirectory)\MyFirstProcess'
    outputPath: '$(Build.ArtifactStagingDirectory)\Packages\MyFirstProcess'
    outputType: 'Process'
    orchestratorConnection: 'service-connection-name'
    traceLevel: 'Information'

示例：使用签名的包

- task: UiPathPack@2
  displayName: 'Pack and Sign UiPath Project'
  inputs:
    versionType: 'ManualVersion'
    version: '1.0.$(Build.BuildId)'
    projectJsonPath: '$(Build.SourcesDirectory)\MyAutomationProject'
    outputPath: '$(Build.ArtifactStagingDirectory)\Packages'
    outputType: 'Process'
    orchestratorConnection: 'uipath-orchestrator-connection'
    certificatePath: '$(Build.SourcesDirectory)\certificates\signing-cert.pfx'
    certificatePassword: '$(SigningCertPassword)'
    timestampServerUrl: 'http://timestamp.digicert.com'
    traceLevel: 'Information'

示例：包含工作流分析和签名的包

- task: UiPathPack@2
  displayName: 'Pack, Analyze, and Sign Project'
  inputs:
    versionType: 'ManualVersion'
    version: '$(Major).$(Minor).$(Build.BuildId)'
    projectJsonPath: '$(Build.SourcesDirectory)\EnterpriseAutomation'
    outputPath: '$(Build.ArtifactStagingDirectory)\Packages'
    outputType: 'Process'
    orchestratorConnection: 'uipath-orchestrator-connection'
    runWorkflowAnalysis: true
    certificatePath: '$(Pipeline.Workspace)\secure-files\company-cert.pfx'
    certificatePassword: '$(CertPassword)'
    timestampServerUrl: 'http://timestamp.digicert.com'
    traceLevel: 'Verbose'

备注：

使用包签名时，请将证书密码作为密码变量存储在 Azure DevOps 中。导航到“管道”>“库”>“变量组” ，或在管道变量中定义，并启用锁形图标以确保安全。