NuGetPackager@0 - NuGet 打包程序 v0 任务

NuGetPackager@0已弃用。 请改用 NuGet 任务。 它适用于新的工具安装程序框架,因此,无需等待任务更新即可轻松使用新版本的 NuGet,从而更好地支持此组织/集合外部经过身份验证的源,并默认使用 NuGet 4。

语法

# NuGet packager v0
# Deprecated: use the “NuGet” task instead. It works with the new Tool Installer framework so you can easily use new versions of NuGet without waiting for a task update, provides better support for authenticated feeds outside this organization/collection, and uses NuGet 4 by default.
- task: NuGetPackager@0
  inputs:
    searchPattern: '**\*.csproj' # string. Required. Path to csproj or nuspec file(s) to pack. Default: **\*.csproj.
    #outputdir: # string. Package Folder. 
  # Pack options
    #includeReferencedProjects: false # boolean. Include referenced projects. Default: false.
    versionByBuild: 'false' # 'false' | 'byPrereleaseNumber' | 'byEnvVar' | 'true'. Required. Automatic package versioning. Default: false.
    #versionEnvVar: # string. Required when versionByBuild = byEnvVar. Environment variable. 
    #requestedMajorVersion: '1' # string. Required when versionByBuild = byPrereleaseNumber. Major. Default: 1.
    #requestedMinorVersion: '0' # string. Required when versionByBuild = byPrereleaseNumber. Minor. Default: 0.
    #requestedPatchVersion: '0' # string. Required when versionByBuild = byPrereleaseNumber. Patch. Default: 0.
  # Advanced
    #configurationToPack: '$(BuildConfiguration)' # string. Configuration to Package. Default: $(BuildConfiguration).
    #buildProperties: # string. Additional build properties. 
    #nuGetAdditionalArgs: # string. NuGet Arguments. 
    #nuGetPath: # string. Path to NuGet.exe.

输入

searchPattern - csproj 或 nuspec 文件的路径以打包
string。 必填。 默认值:**\*.csproj

任务用于搜索要打包的 csprojnuspec 文件的模式。

可以使用分号分隔多个模式,并通过以 -:作为前缀来使模式为负。 示例:**\*.csproj;-:**\*.Tests.csproj


outputdir - 包文件夹
string

任务在其中创建包的文件夹。 如果此字符串为空,则会在 csprojnuspec 文件所在的文件夹中创建包。


includeReferencedProjects - 包括引用的项目
boolean。 默认值:false

包括作为依赖项或包的一部分引用的项目。 不能与自动包版本控制一起使用。 如果引用的项目具有与项目同名的相应 nuspec 文件,则将引用的项目添加为依赖项。 否则,将引用的项目添加为包的一部分。 详细了解 如何使用 NuGet CLI 的 pack 命令创建 nuGet 包


versionByBuild - 自动包版本控制
string。 必填。 允许的值:false(关闭)、byPrereleaseNumber(使用日期和时间)、byEnvVar(使用环境变量)、true(使用内部版本号)。 默认值:false

根据指定的值应用自动包版本控制。 此字符串不能与 includeReferencedProjects一起使用。 允许的值为:

  • byPrereleaseNumber - 使用日期和时间:该任务将生成一个 SemVer兼容版本,其格式为 X.Y.Z-ci-datetime,可在其中指定 X、Y 和 Z 的值。
  • byEnvVar - 使用环境变量:该任务将使用指定的环境变量,并包含要使用的版本号。
  • true - 使用内部版本号:任务将使用内部版本号来对包进行版本控制。

注释

在“常规”下,将生成格式设置为 $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r)


versionEnvVar - 环境变量
stringversionByBuild = byEnvVar时是必需的。

指定不带 $$env%的变量名。


requestedMajorVersion - 主要
stringversionByBuild = byPrereleaseNumber时是必需的。 默认值:1

版本 X中的


requestedMinorVersion - 次要
stringversionByBuild = byPrereleaseNumber时是必需的。 默认值:0

版本 Y中的


requestedPatchVersion - 补丁
stringversionByBuild = byPrereleaseNumber时是必需的。 默认值:0

版本 Z中的


将配置 configurationToPack - 打包
string。 默认值:$(BuildConfiguration)

指定使用 csproj 文件时要打包的配置。


buildProperties - 其他生成属性
string

用于生成包的属性的分号分隔列表。


nuGetAdditionalArgs - NuGet 参数
string

传递给 NuGet.exe pack的其他参数。 详细了解 如何使用 NuGet CLI 的 pack 命令创建 nuGet 包


nuGetPath - NuGet.exe 的路径
string

可选。 提供 NuGet.exe的路径。


任务控制选项

除任务输入之外,所有任务都具有控制选项。 有关详细信息,请参阅 控件选项和常见任务属性

输出变量

没有。

要求

要求 说明
管道类型 YAML,经典版本,经典版本
运行时间 代理,DeploymentGroup
需求 自承载代理必须具有与以下 要求 运行使用此任务的作业 功能: Cmd
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任何
Settable 变量 任何
代理版本 1.83.0 或更高版本
任务类别 封装件