Udostępnij za pośrednictwem


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 standardem X.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 $, $envlub %.


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