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

Статья
07/02/2024

NuGetPackager@0 не рекомендуется. Вместо этого используйте задачу NuGet. Он работает с новой платформой установщика инструментов, что позволяет легко использовать новые версии NuGet, не дожидаясь обновления задачи, обеспечивает улучшенную поддержку веб-каналов, прошедших проверку подлинности за пределами этой организации или коллекции, и использует NuGet 4 по умолчанию.

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.

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

Входные данные

searchPattern - Путь к файлам csproj или nuspec для упаковки
string. Обязательный. Значение по умолчанию: **\*.csproj.

Шаблон, используемый задачей для поиска или nuspec файлов для csproj упаковки.

Вы можете разделить несколько шаблонов точкой с запятой и сделать шаблон отрицательным, указав для него -:префикс . Например, **\*.csproj;-:**\*.Tests.csproj.

outputdir - Папка пакета
string.

Папка, в которой задача создает пакеты. Если эта строка пуста, пакеты будут созданы в папке csproj , где находится файл или nuspec .

includeReferencedProjects - Включение проектов, на которые имеются ссылки
boolean. Значение по умолчанию: false.

Включает проекты, на которые имеются ссылки, как зависимости или как часть пакета. Не может использоваться с автоматическим управлением версиями пакетов. Если упоминаемый проект имеет соответствующий nuspec файл с тем же именем, что и проект, этот проект добавляется в качестве зависимости. В противном случае проект, на который указывает ссылка, добавляется как часть пакета. Узнайте больше об использовании команды pack для Интерфейса командной строки 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. Узнайте больше об использовании команды pack для Интерфейса командной строки NuGet для создания пакетов NuGet.

nuGetPath - Путь к NuGet.exe
string.

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

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

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

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

Нет.

Требования

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

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