Partilhar via


NuGetPackager@0 - Tarefa do empacotador NuGet v0

NuGetPackager@0 foi preterido. Em alternativa, utilize a tarefa NuGet. Funciona com a nova arquitetura do Instalador de Ferramentas para que possa utilizar facilmente novas versões do NuGet sem esperar por uma atualização de tarefas, fornecer um melhor suporte para feeds autenticados fora desta organização/coleção e utilizar o NuGet 4 por predefinição.

NuGetPackager@0 foi preterido. Em alternativa, utilize a tarefa NuGet. Funciona com a nova arquitetura do Instalador de Ferramentas para que possa utilizar facilmente novas versões do NuGet sem esperar por uma atualização de tarefas, fornecer um melhor suporte para feeds autenticados fora desta conta/coleção e utilizar o NuGet 4 por predefinição.

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 - Caminho para csproj ou ficheiro(s) nuspec para empacotar
string. Obrigatório. Valor predefinido: **\*.csproj.

O padrão que a tarefa utiliza para procurar csproj ou nuspec ficheiros a empacotar.

Pode separar múltiplos padrões com um ponto e vírgula e pode tornar um padrão negativo ao prefixá-lo com -:. Exemplo: **\*.csproj;-:**\*.Tests.csproj.


outputdir - Pasta de Pacote
string.

A pasta onde a tarefa cria pacotes. Se esta cadeia estiver vazia, os pacotes serão criados na pasta onde o csproj ficheiro ou nuspec está localizado.


includeReferencedProjects - Incluir projetos referenciados
boolean. Valor predefinido: false.

Inclui projetos referenciados como dependências ou como parte do pacote. Não é possível utilizar com o controlo de versões automático do pacote. Se um projeto referenciado tiver um ficheiro correspondente nuspec com o mesmo nome que o projeto, esse projeto referenciado é adicionado como uma dependência. Caso contrário, o projeto referenciado é adicionado como parte do pacote. Saiba mais sobre como utilizar o comando de pacote da CLI NuGet para criar pacotes NuGet.


versionByBuild - Controlo de versões automática do pacote
string. Obrigatório. Valores permitidos: false (Desativado), byPrereleaseNumber (Utilize a data e hora) byEnvVar (Utilize uma variável de ambiente) true (Utilize o número de compilação). Valor predefinido: false.

Aplica o controlo de versões automático do pacote consoante o valor especificado. Esta cadeia não pode ser utilizada com includeReferencedProjects. Os valores permitidos são:

  • byPrereleaseNumber - Utilizar a data e hora: a tarefa irá gerar uma versão compatível com SemVer formatada como X.Y.Z-ci-datetime, onde especifica os valores de X, Y e Z.
  • byEnvVar - Utilizar uma variável de ambiente: a tarefa utilizará uma variável de ambiente que especificar e contém o número da versão que pretende utilizar.
  • true - Utilizar o número de compilação: a tarefa utilizará o número de compilação para criar a versão do pacote.

Nota

Em Geral, defina o formato de compilação como $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r).


versionEnvVar - Variável de ambiente
string. Necessário quando versionByBuild = byEnvVar.

Especifica o nome da variável sem $, $envou %.


requestedMajorVersion - Principal
string. Necessário quando versionByBuild = byPrereleaseNumber. Valor predefinido: 1.

A X versão in X.Y.Z.


requestedMinorVersion - Menor
string. Necessário quando versionByBuild = byPrereleaseNumber. Valor predefinido: 0.

A Y versão in X.Y.Z.


requestedPatchVersion - Patch
string. Necessário quando versionByBuild = byPrereleaseNumber. Valor predefinido: 0.

A Z versão in X.Y.Z.


configurationToPack - Configuração para Pacote
string. Valor predefinido: $(BuildConfiguration).

Especifica a configuração a empacotar ao utilizar um csproj ficheiro.


buildProperties - Propriedades de compilação adicionais
string.

A lista delimitada por ponto e vírgula das propriedades utilizadas para criar o pacote.


nuGetAdditionalArgs - Argumentos NuGet
string.

Os argumentos adicionais passaram para NuGet.exe pack. Saiba mais sobre como utilizar o comando de pacote da CLI NuGet para criar pacotes NuGet.


nuGetPath - Caminho para NuGet.exe
string.

Opcional. Fornece o caminho para NuGet.exe.


Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Requisitos

Requisito Description
Tipos de pipeline YAML, Compilação clássica, Versão clássica
É executado em Agent, DeploymentGroup
Exigências Os agentes autoalojados têm de ter capacidades que correspondam às seguintes exigências para executar tarefas que utilizem esta tarefa: Cmd
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos Qualquer
Variáveis de definição Qualquer
Versão do agente 1.83.0 ou superior
Categoria da tarefa Pacote