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
。
任务用于搜索要打包的 csproj
或 nuspec
文件的模式。
可以使用分号分隔多个模式,并通过以 -:
作为前缀来使模式为负。 示例:**\*.csproj;-:**\*.Tests.csproj
。
outputdir
-
包文件夹
string
。
任务在其中创建包的文件夹。 如果此字符串为空,则会在 csproj
或 nuspec
文件所在的文件夹中创建包。
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
-
环境变量
string
。
versionByBuild = byEnvVar
时是必需的。
指定不带 $
、$env
或 %
的变量名。
将配置 configurationToPack
- 打包
string
。 默认值:$(BuildConfiguration)
。
指定使用 csproj
文件时要打包的配置。
buildProperties
-
其他生成属性
string
。
用于生成包的属性的分号分隔列表。
nuGetAdditionalArgs
-
NuGet 参数
string
。
传递给 NuGet.exe pack
的其他参数。 详细了解 如何使用 NuGet CLI 的 pack 命令创建 nuGet 包。
nuGetPath
-
NuGet.exe 的路径
string
。
可选。 提供 NuGet.exe
的路径。
任务控制选项
除任务输入之外,所有任务都具有控制选项。 有关详细信息,请参阅 控件选项和常见任务属性。
输出变量
没有。