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

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

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.
# 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 account/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.

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


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

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


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

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

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

注意

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


versionEnvVar - 环境变量
string. 当 versionByBuild = byEnvVar 时,需要此选项。

指定不带 、 $env%$变量名称。


requestedMajorVersion - 主要
string. 当 versionByBuild = byPrereleaseNumber 时,需要此选项。 默认值:1

X版本 X.Y.Z 中的


requestedMinorVersion -
string. 当 versionByBuild = byPrereleaseNumber 时,需要此选项。 默认值:0

Y版本 X.Y.Z 中的


requestedPatchVersion - 补丁
string. 当 versionByBuild = byPrereleaseNumber 时,需要此选项。 默认值:0

Z版本 X.Y.Z 中的


configurationToPack - 配置到包
string. 默认值:$(BuildConfiguration)

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


buildProperties - 其他生成属性
string.

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


nuGetAdditionalArgs - NuGet 参数
string.

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


nuGetPath - NuGet.exe的路径
string.

可选。 提供 的路径 NuGet.exe


任务控制选项

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

输出变量

无。

要求

要求 说明
管道类型 YAML,经典内部版本,经典版本
运行平台 Agent、DeploymentGroup
需求 自承载代理必须具有满足以下要求的功能才能运行使用此任务的作业:Cmd
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任意
可设置的变量 任意
代理版本 1.83.0 或更高版本
任务类别