NuGetPackager@0 — zadanie modułu pakietów NuGet w wersji 0
NuGetPackager@0 jest przestarzała. Zamiast tego użyj zadania NuGet. Współdziała ona z nową strukturą Instalatora narzędzi, dzięki czemu można łatwo korzystać z nowych wersji narzędzia NuGet bez oczekiwania na aktualizację zadania, zapewnia lepszą obsługę uwierzytelnionych źródeł danych poza tą organizacją/kolekcją i domyślnie używa pakietu NuGet 4.
NuGetPackager@0 jest przestarzała. Zamiast tego użyj zadania NuGet. Współdziała ona z nową strukturą Instalatora narzędzi, dzięki czemu można łatwo korzystać z nowych wersji narzędzia NuGet bez oczekiwania na aktualizację zadania, zapewnia lepszą obsługę uwierzytelnionych źródeł danych poza tym kontem/kolekcją i domyślnie używa pakietu NuGet 4.
Składnia
# 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.
Dane wejściowe
searchPattern
-
Ścieżka do plików csproj lub nuspec do spakowania
string
. Wymagane. Wartość domyślna: **\*.csproj
.
Wzorzec używany przez zadanie do wyszukiwania csproj
plików lub nuspec
do spakowania.
Można oddzielić wiele wzorców średnikami i utworzyć wzorzec ujemny, prefiksując go za pomocą -:
. Przykład: **\*.csproj;-:**\*.Tests.csproj
.
outputdir
-
Folder pakietu
string
.
Folder, w którym zadanie tworzy pakiety. Jeśli ten ciąg jest pusty, pakiety zostaną utworzone w folderze, w którym csproj
znajduje się plik lub nuspec
.
includeReferencedProjects
-
Dołączanie projektów, do których odwołuje się odwołanie
boolean
. Wartość domyślna: false
.
Zawiera przywołyne projekty jako zależności lub jako część pakietu. Nie można używać z automatycznym przechowywaniem wersji pakietów. Jeśli przywoływany projekt ma odpowiedni nuspec
plik o tej samej nazwie co projekt, ten przywoływany projekt zostanie dodany jako zależność. W przeciwnym razie w ramach pakietu zostanie dodany przywoływany projekt. Dowiedz się więcej o używaniu polecenia pack dla interfejsu wiersza polecenia nuGet do tworzenia pakietów NuGet.
versionByBuild
-
Automatyczne przechowywanie wersji pakietów
string
. Wymagane. Dozwolone wartości: false
(Wyłączone), byPrereleaseNumber
(użyj daty i godziny), byEnvVar
(użyj zmiennej środowiskowej) true
(Użyj numeru kompilacji). Wartość domyślna: false
.
Stosuje automatyczne przechowywanie wersji pakietu w zależności od określonej wartości. Tego ciągu nie można używać z includeReferencedProjects
. Dozwolone wartości to:
-
byPrereleaseNumber
- Użyj daty i godziny: zadanie wygeneruje zgodną ze standardem SemVer wersję w formacieX.Y.Z-ci-datetime
, w której określisz wartości X, Y i Z. -
byEnvVar
- Użyj zmiennej środowiskowej: zadanie będzie używać określonej zmiennej środowiskowej i zawiera numer wersji, którego chcesz użyć. -
true
- Użyj numeru kompilacji: zadanie użyje numeru kompilacji do wersji pakietu.
Uwaga
W obszarze Ogólne ustaw format kompilacji na $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r)
.
versionEnvVar
-
Zmienna środowiskowa
string
. Wymagane, gdy versionByBuild = byEnvVar
.
Określa nazwę zmiennej bez $
, $env
lub %
.
requestedMajorVersion
-
Głównych
string
. Wymagane, gdy versionByBuild = byPrereleaseNumber
. Wartość domyślna: 1
.
Element X
w wersji X.Y.Z.
requestedMinorVersion
-
Drobne
string
. Wymagane, gdy versionByBuild = byPrereleaseNumber
. Wartość domyślna: 0
.
Element Y
w wersji X.Y.Z.
requestedPatchVersion
-
Patch
string
. Wymagane, gdy versionByBuild = byPrereleaseNumber
. Wartość domyślna: 0
.
Element Z
w wersji X.Y.Z.
configurationToPack
-
Konfiguracja do pakietu
string
. Wartość domyślna: $(BuildConfiguration)
.
Określa konfigurację pakietu podczas korzystania z csproj
pliku.
buildProperties
-
Dodatkowe właściwości kompilacji
string
.
Rozdzielana średnikami lista właściwości używanych do kompilowania pakietu.
nuGetAdditionalArgs
-
Argumenty narzędzia NuGet
string
.
Dodatkowe argumenty przekazane do metody NuGet.exe pack
. Dowiedz się więcej o używaniu polecenia pack dla interfejsu wiersza polecenia nuGet do tworzenia pakietów NuGet.
nuGetPath
-
Ścieżka do NuGet.exe
string
.
Opcjonalny. Dostarcza ścieżkę do NuGet.exe
.
Opcje sterowania zadania
Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.
Zmienne wyjściowe
Brak.
Wymagania
Wymaganie | Opis |
---|---|
Typy potoków | YAML, klasyczna kompilacja, wersja klasyczna |
Działa w | Agent, DeploymentGroup |
Wymagania | Agenci hostowani samodzielnie muszą mieć funkcje zgodne z następującymi wymaganiami dotyczącymi uruchamiania zadań korzystających z tego zadania: Cmd |
Możliwości | To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu. |
Ograniczenia poleceń | Dowolne |
Zmienne ustawialne | Dowolne |
Wersja agenta | 1.83.0 lub nowsza |
Kategoria zadania | Pakiet |