NuGetPackager@0 — задача пакета NuGet версии 0

Статья
03/24/2025

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 для создания пакетов 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или %.

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 для создания пакетов NuGet.

Путь к NuGet.exenuGetPath -
string.

Необязательно. Предоставляет путь к NuGet.exe.

Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.

Выходные переменные

Нет.

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
требования	Локальные агенты должны иметь возможности, соответствующие следующим требованиям для выполнения заданий, использующих эту задачу: Cmd
возможностей	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Любое
переменные settable	Любое
Версия агента	1.83.0 или более поздней версии
Категория задач	Пакет

Поделиться через