NuGetPackager@0 — zadanie narzędzia NuGet packager v0
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 używać nowych wersji pakietu 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.
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.
Dane wejściowe
searchPattern
-
ścieżka do plików csproj lub nuspec do spakowania
string
. To jest wymagane. Wartość domyślna: **\*.csproj
.
Wzorzec używany przez zadanie do wyszukiwania plików csproj
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 znajduje się plik csproj
lub nuspec
.
includeReferencedProjects
-
uwzględnij przywołytowane projekty
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 plik nuspec
o takiej samej nazwie jak projekt, ten przywoływany projekt jest dodawany jako zależność. W przeciwnym razie w ramach pakietu zostanie dodany przywoływany projekt. Dowiedz się więcej o przy użyciu polecenia pack dla interfejsu wiersza polecenia nuGet w celu utworzenia pakietów NuGet.
versionByBuild
-
automatyczne przechowywanie wersji pakietów
string
. To jest 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żyjdaty i godziny: zadanie wygeneruje wersji zgodnej ze standardemX.Y.Z-ci-datetime
, gdzie określa się 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
-
zmiennej środowiskowej
string
. Wymagane, gdy versionByBuild = byEnvVar
.
Określa nazwę zmiennej bez $
, $env
lub %
.
requestedMajorVersion
-
Główne
string
. Wymagane, gdy versionByBuild = byPrereleaseNumber
. Wartość domyślna: 1
.
X
w wersji X.Y.Z.
requestedMinorVersion
-
pomocnicza
string
. Wymagane, gdy versionByBuild = byPrereleaseNumber
. Wartość domyślna: 0
.
Y
w wersji X.Y.Z.
poprawki
string
. Wymagane, gdy versionByBuild = byPrereleaseNumber
. Wartość domyślna: 0
.
Z
w wersji X.Y.Z.
konfiguracja configurationToPack
- do pakietu
string
. Wartość domyślna: $(BuildConfiguration)
.
Określa konfigurację pakietu podczas korzystania z pliku csproj
.
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 NuGet.exe pack
. Dowiedz się więcej o przy użyciu polecenia pack dla interfejsu wiersza polecenia nuGet w celu utworzenia pakietów NuGet.
ścieżka nuGetPath
- do NuGet.exe
string
.
Opcjonalny. Dostarcza ścieżkę do NuGet.exe
.
Opcje sterowania zadaniami
Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz opcje kontroli i typowe właściwości zadań.
Zmienne wyjściowe
Żaden.
Wymagania
Wymaganie | Opis |
---|---|
Typy potoków | YAML, klasyczna kompilacja, wersja klasyczna |
Działa na | Agent, DeploymentGroup |
Wymagania | Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami do 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ń | Jakikolwiek |
zmienne ustawiane | Jakikolwiek |
Wersja agenta | 1.83.0 lub nowsza |
Kategoria zadań | Pakiet |