Compartir a través de


NuGetPackager@0: tarea del empaquetador de NuGet v0

NuGetPackager@0 está en desuso. En su lugar, use la tarea NuGet. Funciona con el nuevo marco del instalador de herramientas para que pueda usar fácilmente nuevas versiones de NuGet sin esperar una actualización de tareas, proporciona una mejor compatibilidad con fuentes autenticadas fuera de esta organización o colección y usa NuGet 4 de forma predeterminada.

NuGetPackager@0 está en desuso. En su lugar, use la tarea NuGet. Funciona con el nuevo marco del instalador de herramientas para que pueda usar fácilmente nuevas versiones de NuGet sin esperar una actualización de tareas, proporciona una mejor compatibilidad con fuentes autenticadas fuera de esta cuenta o colección y usa NuGet 4 de forma predeterminada.

Syntax

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

Entradas

searchPattern - Ruta de acceso a csproj o archivos nuspec que se van a empaquetar
string. Obligatorio. Valor predeterminado: **\*.csproj.

Patrón que la tarea usa para buscar csproj archivos o nuspec empaquetar.

Puede separar varios patrones con un punto y coma y puede hacer que un patrón sea negativo con el prefijo -:. Ejemplo: **\*.csproj;-:**\*.Tests.csproj.


outputdir - Carpeta del paquete
string.

Carpeta donde la tarea crea paquetes. Si esta cadena está vacía, los paquetes se crearán en la carpeta donde se encuentra el csproj archivo o nuspec .


includeReferencedProjects - Incluir proyectos a los que se hace referencia
boolean. Valor predeterminado: false.

Incluye proyectos a los que se hace referencia como dependencias o como parte del paquete. No se puede usar con versiones automáticas de paquetes. Si un proyecto al que se hace referencia tiene un archivo correspondiente nuspec que tiene el mismo nombre que el proyecto, ese proyecto al que se hace referencia se agrega como una dependencia. De lo contrario, el proyecto al que se hace referencia se agrega como parte del paquete. Obtenga más información sobre el uso del comando pack para la CLI de NuGet para crear paquetes NuGet.


versionByBuild - Control automático de versiones de paquetes
string. Obligatorio. Valores permitidos: false (Desactivado), byPrereleaseNumber (Use la fecha y hora), byEnvVar (Use una variable de entorno) true (Use el número de compilación). Valor predeterminado: false.

Aplica el control de versiones automático del paquete en función del valor especificado. Esta cadena no se puede usar con includeReferencedProjects. Los valores permitidos son:

  • byPrereleaseNumber - Use la fecha y hora: la tarea generará una versión compatible con SemVer con formato X.Y.Z-ci-datetime, donde se especifican los valores de X, Y y Z.
  • byEnvVar - Usar una variable de entorno: la tarea usará una variable de entorno que especifique y contiene el número de versión que desea usar.
  • true - Use el número de compilación: la tarea usará el número de compilación para versionar el paquete.

Nota:

En General, establezca el formato de compilación en $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r).


versionEnvVar - Variable de entorno
string. Necesario cuando versionByBuild = byEnvVar.

Especifica el nombre de la variable sin $, $envo %.


requestedMajorVersion - Destacado
string. Necesario cuando versionByBuild = byPrereleaseNumber. Valor predeterminado: 1.

en la X versión X.Y.Z.


requestedMinorVersion - Menor
string. Necesario cuando versionByBuild = byPrereleaseNumber. Valor predeterminado: 0.

en la Y versión X.Y.Z.


requestedPatchVersion - Parche
string. Necesario cuando versionByBuild = byPrereleaseNumber. Valor predeterminado: 0.

en la Z versión X.Y.Z.


configurationToPack - Configuración en el paquete
string. Valor predeterminado: $(BuildConfiguration).

Especifica la configuración que se va a empaquetar cuando se usa un csproj archivo.


buildProperties - Propiedades de compilación adicionales
string.

Lista delimitada por punto y coma de propiedades usadas para compilar el paquete.


nuGetAdditionalArgs - Argumentos de NuGet
string.

Argumentos adicionales pasados a NuGet.exe pack. Obtenga más información sobre el uso del comando pack para la CLI de NuGet para crear paquetes NuGet.


nuGetPath - Ruta de acceso a NuGet.exe
string.

Opcional. Proporciona la ruta de acceso a NuGet.exe.


Opciones de control de tareas

Todas las tareas tienen opciones de control además de las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Requisitos

Requisito Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Se ejecuta en Agente, DeploymentGroup
Peticiones Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes demandas para ejecutar trabajos que usan esta tarea: Cmd
Capabilities Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Any
Variables que se pueden establecer Any
Versión del agente 1.83.0 o superior
Categoría de la tarea: Paquete