Compartilhar via


tarefa NuGetPackager@0 - Empacotador do NuGet v0

NuGetPackager@0 foi preterido. Em vez disso, use a tarefa NuGet. Ele funciona com a nova estrutura do Instalador de Ferramentas para que você possa usar facilmente novas versões do NuGet sem esperar por uma atualização de tarefa, fornece melhor suporte para feeds autenticados fora dessa organização/coleção e usa o NuGet 4 por padrão.

NuGetPackager@0 foi preterido. Em vez disso, use a tarefa NuGet. Ele funciona com a nova estrutura do Instalador de Ferramentas para que você possa usar facilmente novas versões do NuGet sem esperar por uma atualização de tarefa, fornece melhor suporte para feeds autenticados fora dessa conta/coleção e usa o NuGet 4 por padrã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 arquivos nuspec para empacotar
string. Obrigatórios. Valor padrão: **\*.csproj.

O padrão que a tarefa usa para pesquisar csproj arquivos ou nuspec para empacotar.

Você pode separar vários padrões com um ponto e vírgula e você pode tornar o padrão negativo prefixando-o com -:. Exemplo: **\*.csproj;-:**\*.Tests.csproj.


outputdir - Pasta do Pacote
string.

A pasta em que a tarefa cria pacotes. Se essa cadeia de caracteres estiver vazia, os pacotes serão criados na pasta em que o csproj arquivo ou nuspec está localizado.


includeReferencedProjects - Incluir projetos referenciados
boolean. Valor padrão: false.

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


versionByBuild - Controle de versão automático do pacote
string. Obrigatórios. Valores permitidos: false (Desativado), byPrereleaseNumber (Usar a data e a hora) byEnvVar (Usar uma variável de ambiente) true (Use o número de build). Valor padrão: false.

Aplica o controle de versão automático do pacote dependendo do valor especificado. Essa cadeia de caracteres não pode ser usada com includeReferencedProjects. Os valores permitidos são:

  • byPrereleaseNumber - Use a data e a hora: a tarefa gerará uma versão em conformidade com SemVer formatada como X.Y.Z-ci-datetime, em que você especificará os valores de X, Y e Z.
  • byEnvVar- Usar uma variável de ambiente: a tarefa usará uma variável de ambiente que você especificar e conterá o número de versão que você deseja usar.
  • true - Use o número de build: a tarefa usará o número de build para versão do pacote.

Observação

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


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

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


requestedMajorVersion - Principais
string. Obrigatório quando versionByBuild = byPrereleaseNumber. Valor padrão: 1.

O X na versão X.Y.Z.


requestedMinorVersion - Menor
string. Obrigatório quando versionByBuild = byPrereleaseNumber. Valor padrão: 0.

O Y na versão X.Y.Z.


requestedPatchVersion - Patch
string. Obrigatório quando versionByBuild = byPrereleaseNumber. Valor padrão: 0.

O Z na versão X.Y.Z.


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

Especifica a configuração a ser empacotada ao usar um csproj arquivo.


buildProperties - Propriedades de build adicionais
string.

A lista delimitada por ponto e vírgula de propriedades usadas para compilar o pacote.


nuGetAdditionalArgs - Argumentos do NuGet
string.

Os argumentos adicionais passados para NuGet.exe pack. Saiba mais sobre como usar o comando pack da CLI do NuGet para criar pacotes NuGet.


nuGetPath - Caminho para NuGet.exe
string.

Opcional. Fornece o caminho para NuGet.exe.


Opções de controle da tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
É executado em Agent, DeploymentGroup
Demandas Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas para executar trabalhos que usam esta tarefa: Cmd
Funcionalidades Essa tarefa não atende a nenhuma demanda por tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 1.83.0 ou superior
Categoria da tarefa Pacote