Bagikan melalui


NuGetCommand@2 - Tugas NuGet v2

Gunakan tugas ini untuk memulihkan, mengemas, atau mendorong paket NuGet, atau menjalankan perintah NuGet. Tugas ini mendukung NuGet.org dan umpan terautentikasi seperti Artefak Azure dan MyGet. Tugas ini juga menggunakan NuGet.exe dan berfungsi dengan aplikasi .NET Framework. Untuk aplikasi .NET Core dan .NET Standard, gunakan tugas .NET Core.

Sintaksis

# NuGet v2
# Restore, pack, or push NuGet packages, or run a NuGet command. Supports NuGet.org and authenticated feeds like Azure Artifacts and MyGet. Uses NuGet.exe and works with .NET Framework apps. For .NET Core and .NET Standard apps, use the .NET Core task.
- task: NuGetCommand@2
  inputs:
    command: 'restore' # 'restore' | 'pack' | 'push' | 'custom'. Required. Command. Default: restore.
    restoreSolution: '**/*.sln' # string. Alias: solution. Required when command = restore. Path to solution, packages.config, or project.json. Default: **/*.sln.
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.
    #nuGetFeedType: 'internal' # 'internal' | 'external'. Required when command = push. Target feed location. Default: internal.
    #publishVstsFeed: # string. Alias: feedPublish. Required when command = push && nuGetFeedType = internal. Target feed. 
    #allowPackageConflicts: false # boolean. Optional. Use when command = push && nuGetFeedType = internal. Allow duplicates to be skipped. Default: false.
    #publishFeedCredentials: # string. Alias: externalEndpoint. Required when command = push && nuGetFeedType = external. NuGet server. 
    #packagesToPack: '**/*.csproj' # string. Alias: searchPatternPack. Required when command = pack. Path to csproj or nuspec file(s) to pack. Default: **/*.csproj.
    #configuration: '$(BuildConfiguration)' # string. Alias: configurationToPack. Optional. Use when command = pack. Configuration to package. Default: $(BuildConfiguration).
    #packDestination: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package folder. Default: $(Build.ArtifactStagingDirectory).
    #arguments: # string. Required when command = custom. Command and arguments. 
  # Feeds and authentication
    feedsToUse: 'select' # 'select' | 'config'. Alias: selectOrConfig. Required when command = restore. Feeds to use. Default: select.
    #vstsFeed: # string. Alias: feedRestore. Optional. Use when selectOrConfig = select && command = restore. Use packages from this Azure Artifacts/TFS feed. Select from the dropdown or enter [project name/]feed name. 
    #includeNuGetOrg: true # boolean. Optional. Use when selectOrConfig = select && command = restore. Use packages from NuGet.org. Default: true.
    #nugetConfigPath: # string. Optional. Use when selectOrConfig = config && command = restore. Path to NuGet.config. 
    #externalFeedCredentials: # string. Alias: externalEndpoints. Optional. Use when selectOrConfig = config && command = restore. Credentials for feeds outside this organization/collection. 
  # Advanced
    #noCache: false # boolean. Optional. Use when command = restore. Disable local cache. Default: false.
    #disableParallelProcessing: false # boolean. Optional. Use when command = restore. Disable parallel processing. Default: false.
    #restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory. 
    #verbosityRestore: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = restore. Verbosity. Default: Detailed.
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = push && nuGetFeedType = internal && command = push. Publish pipeline metadata. Default: true.
    #verbosityPush: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = push. Verbosity. Default: Detailed.
  # Pack options
    #versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
    #includeReferencedProjects: false # boolean. Optional. Use when versioningScheme = off && command = pack. Include referenced projects. Default: false.
    #versionEnvVar: # string. Required when versioningScheme = byEnvVar && command = pack. Environment variable. 
    #majorVersion: '1' # string. Alias: requestedMajorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Major. Default: 1.
    #minorVersion: '0' # string. Alias: requestedMinorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Minor. Default: 0.
    #patchVersion: '0' # string. Alias: requestedPatchVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Patch. Default: 0.
    #packTimezone: 'utc' # 'utc' | 'local'. Optional. Use when versioningScheme = byPrereleaseNumber && command = pack. Time zone. Default: utc.
    #includeSymbols: false # boolean. Optional. Use when command = pack. Create symbols package. Default: false.
    #toolPackage: false # boolean. Optional. Use when command = pack. Tool Package. Default: false.
  # Advanced
    #buildProperties: # string. Optional. Use when command = pack. Additional build properties. 
    #basePath: # string. Optional. Use when command = pack. Base path. 
    #verbosityPack: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = pack. Verbosity. Default: Detailed.
# NuGet v2
# Restore, pack, or push NuGet packages, or run a NuGet command. Supports NuGet.org and authenticated feeds like Azure Artifacts and MyGet. Uses NuGet.exe and works with .NET Framework apps. For .NET Core and .NET Standard apps, use the .NET Core task.
- task: NuGetCommand@2
  inputs:
    command: 'restore' # 'restore' | 'pack' | 'push' | 'custom'. Required. Command. Default: restore.
    restoreSolution: '**/*.sln' # string. Alias: solution. Required when command = restore. Path to solution, packages.config, or project.json. Default: **/*.sln.
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.
    #nuGetFeedType: 'internal' # 'internal' | 'external'. Required when command = push. Target feed location. Default: internal.
    #publishVstsFeed: # string. Alias: feedPublish. Required when command = push && nuGetFeedType = internal. Target feed. 
    #allowPackageConflicts: false # boolean. Optional. Use when command = push && nuGetFeedType = internal. Allow duplicates to be skipped. Default: false.
    #publishFeedCredentials: # string. Alias: externalEndpoint. Required when command = push && nuGetFeedType = external. NuGet server. 
    #packagesToPack: '**/*.csproj' # string. Alias: searchPatternPack. Required when command = pack. Path to csproj or nuspec file(s) to pack. Default: **/*.csproj.
    #configuration: '$(BuildConfiguration)' # string. Alias: configurationToPack. Optional. Use when command = pack. Configuration to package. Default: $(BuildConfiguration).
    #packDestination: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package folder. Default: $(Build.ArtifactStagingDirectory).
    #arguments: # string. Required when command = custom. Command and arguments. 
  # Feeds and authentication
    feedsToUse: 'select' # 'select' | 'config'. Alias: selectOrConfig. Required when command = restore. Feeds to use. Default: select.
    #vstsFeed: # string. Alias: feedRestore. Optional. Use when selectOrConfig = select && command = restore. Use packages from this Azure Artifacts/TFS feed. 
    #includeNuGetOrg: true # boolean. Optional. Use when selectOrConfig = select && command = restore. Use packages from NuGet.org. Default: true.
    #nugetConfigPath: # string. Optional. Use when selectOrConfig = config && command = restore. Path to NuGet.config. 
    #externalFeedCredentials: # string. Alias: externalEndpoints. Optional. Use when selectOrConfig = config && command = restore. Credentials for feeds outside this organization/collection. 
  # Advanced
    #noCache: false # boolean. Optional. Use when command = restore. Disable local cache. Default: false.
    #disableParallelProcessing: false # boolean. Optional. Use when command = restore. Disable parallel processing. Default: false.
    #restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory. 
    #verbosityRestore: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = restore. Verbosity. Default: Detailed.
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = push && nuGetFeedType = internal && command = push. Publish pipeline metadata. Default: true.
    #verbosityPush: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = push. Verbosity. Default: Detailed.
  # Pack options
    #versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
    #includeReferencedProjects: false # boolean. Optional. Use when versioningScheme = off && command = pack. Include referenced projects. Default: false.
    #versionEnvVar: # string. Required when versioningScheme = byEnvVar && command = pack. Environment variable. 
    #majorVersion: '1' # string. Alias: requestedMajorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Major. Default: 1.
    #minorVersion: '0' # string. Alias: requestedMinorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Minor. Default: 0.
    #patchVersion: '0' # string. Alias: requestedPatchVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Patch. Default: 0.
    #packTimezone: 'utc' # 'utc' | 'local'. Optional. Use when versioningScheme = byPrereleaseNumber && command = pack. Time zone. Default: utc.
    #includeSymbols: false # boolean. Optional. Use when command = pack. Create symbols package. Default: false.
    #toolPackage: false # boolean. Optional. Use when command = pack. Tool Package. Default: false.
  # Advanced
    #buildProperties: # string. Optional. Use when command = pack. Additional build properties. 
    #basePath: # string. Optional. Use when command = pack. Base path. 
    #verbosityPack: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = pack. Verbosity. Default: Detailed.
# NuGet v2
# Restore, pack, or push NuGet packages, or run a NuGet command. Supports NuGet.org and authenticated feeds like Package Management and MyGet. Uses NuGet.exe and works with .NET Framework apps. For .NET Core and .NET Standard apps, use the .NET Core task.
- task: NuGetCommand@2
  inputs:
    command: 'restore' # 'restore' | 'pack' | 'push' | 'custom'. Required. Command. Default: restore.
    restoreSolution: '**/*.sln' # string. Alias: solution. Required when command = restore. Path to solution, packages.config, or project.json. Default: **/*.sln.
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.
    #nuGetFeedType: 'internal' # 'internal' | 'external'. Required when command = push. Target feed location. Default: internal.
    #publishVstsFeed: # string. Alias: feedPublish. Required when command = push && nuGetFeedType = internal. Target feed. 
    #allowPackageConflicts: false # boolean. Optional. Use when command = push && nuGetFeedType = internal. Allow duplicates to be skipped. Default: false.
    #publishFeedCredentials: # string. Alias: externalEndpoint. Required when command = push && nuGetFeedType = external. NuGet server. 
    #packagesToPack: '**/*.csproj' # string. Alias: searchPatternPack. Required when command = pack. Path to csproj or nuspec file(s) to pack. Default: **/*.csproj.
    #configuration: '$(BuildConfiguration)' # string. Alias: configurationToPack. Optional. Use when command = pack. Configuration to package. Default: $(BuildConfiguration).
    #packDestination: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package folder. Default: $(Build.ArtifactStagingDirectory).
    #arguments: # string. Required when command = custom. Command and arguments. 
  # Feeds and authentication
    feedsToUse: 'select' # 'select' | 'config'. Alias: selectOrConfig. Required when command = restore. Feeds to use. Default: select.
    #vstsFeed: # string. Alias: feedRestore. Optional. Use when selectOrConfig = select && command = restore. Use packages from this Azure Artifacts/TFS feed. 
    #includeNuGetOrg: true # boolean. Optional. Use when selectOrConfig = select && command = restore. Use packages from NuGet.org. Default: true.
    #nugetConfigPath: # string. Optional. Use when selectOrConfig = config && command = restore. Path to NuGet.config. 
    #externalFeedCredentials: # string. Alias: externalEndpoints. Optional. Use when selectOrConfig = config && command = restore. Credentials for feeds outside this account/collection. 
  # Advanced
    #noCache: false # boolean. Optional. Use when command = restore. Disable local cache. Default: false.
    #disableParallelProcessing: false # boolean. Optional. Use when command = restore. Disable parallel processing. Default: false.
    #restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory. 
    #verbosityRestore: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = restore. Verbosity. Default: Detailed.
  # Advanced
    #verbosityPush: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = push. Verbosity. Default: Detailed.
  # Pack options
    #versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
    #includeReferencedProjects: false # boolean. Optional. Use when versioningScheme = off && command = pack. Include referenced projects. Default: false.
    #versionEnvVar: # string. Required when versioningScheme = byEnvVar && command = pack. Environment variable. 
    #majorVersion: '1' # string. Alias: requestedMajorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Major. Default: 1.
    #minorVersion: '0' # string. Alias: requestedMinorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Minor. Default: 0.
    #patchVersion: '0' # string. Alias: requestedPatchVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Patch. Default: 0.
    #packTimezone: 'utc' # 'utc' | 'local'. Optional. Use when versioningScheme = byPrereleaseNumber && command = pack. Time zone. Default: utc.
    #includeSymbols: false # boolean. Optional. Use when command = pack. Create symbols package. Default: false.
    #toolPackage: false # boolean. Optional. Use when command = pack. Tool Package. Default: false.
  # Advanced
    #buildProperties: # string. Optional. Use when command = pack. Additional build properties. 
    #basePath: # string. Optional. Use when command = pack. Base path. 
    #verbosityPack: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = pack. Verbosity. Default: Detailed.

Input

Perintah
string. Diperlukan. Nilai yang diizinkan: restore, pack, push, custom. Nilai default: restore.

Menentukan perintah NuGet untuk dijalankan. Gunakan nilai custom untuk menambahkan argumen atau menggunakan perintah yang berbeda.


restoreSolution - Jalur ke solusi, packages.config, atau project.json
Alias input: solution. string. Diperlukan saat command = restore. Nilai default: **/*.sln.

Menentukan jalur ke file solusi, packages.config, atau project.json yang mereferensikan paket yang akan dipulihkan.


Umpan feedsToUse - untuk digunakan
Alias input: selectOrConfig. string. Diperlukan saat command = restore. Nilai yang diizinkan: select (Umpan yang saya pilih di sini), config (Umpan di NuGet.configsaya ). Nilai default: select.

Menentukan umpan dari Artefak Azure dan/atau NuGet.org untuk tugas yang akan digunakan dengan nilai select. Atau, Anda dapat menerapkan file NuGet.config ke repositori kode sumber Anda dan mengatur jalurnya sebagai nilai menggunakan nilai config.


vstsFeed - Gunakan paket dari umpan Azure Artifacts/TFS ini. Pilih dari menu dropdown atau masukkan [nama proyek/]nama umpan.
Alias input: feedRestore. string. Fakultatif. Gunakan saat selectOrConfig = select && command = restore.

Menentukan umpan terpilih dalam NuGet.configyang dihasilkan. Anda harus menginstal Manajemen Paket dan berlisensi untuk menentukan umpan di sini.


vstsFeed - Menggunakan paket dari umpan Azure Artifacts/TFS ini
Alias input: feedRestore. string. Fakultatif. Gunakan saat selectOrConfig = select && command = restore.

Menentukan umpan terpilih dalam NuGet.configyang dihasilkan. Anda harus menginstal Manajemen Paket dan berlisensi untuk menentukan umpan di sini.


includeNuGetOrg - Menggunakan paket dari NuGet.org
boolean. Fakultatif. Gunakan saat selectOrConfig = select && command = restore. Nilai default: true.

Termasuk NuGet.org dalam NuGet.configyang dihasilkan.


Jalur nugetConfigPath - ke NuGet.config
string. Fakultatif. Gunakan saat selectOrConfig = config && command = restore.

Menentukan jalur ke NuGet.config di repositori Anda yang menentukan umpan untuk memulihkan paket.


kredensial externalFeedCredentials - untuk umpan di luar organisasi/kumpulan ini
Alias input: externalEndpoints. string. Fakultatif. Gunakan saat selectOrConfig = config && command = restore.

Menentukan kredensial yang akan digunakan untuk registri eksternal yang terletak di NuGet.configyang dipilih. Ini adalah nama koneksi layanan NuGet Anda. Untuk umpan dalam organisasi atau koleksi ini, biarkan kosong; kredensial build digunakan secara otomatis.


externalFeedCredentials - Kredensial untuk umpan di luar akun/koleksi ini
Alias input: externalEndpoints. string. Fakultatif. Gunakan saat selectOrConfig = config && command = restore.

Menentukan kredensial yang akan digunakan untuk registri eksternal yang terletak di NuGet.configyang dipilih. Ini adalah nama koneksi layanan NuGet Anda. Untuk umpan di akun atau koleksi ini, biarkan kosong ini; kredensial build digunakan secara otomatis.


noCache - Menonaktifkan cache lokal
boolean. Fakultatif. Gunakan saat command = restore. Nilai default: false.

Mencegah NuGet menggunakan paket dari cache komputer lokal saat diatur ke true.


disableParallelProcessing - Menonaktifkan pemrosesan paralel
boolean. Fakultatif. Gunakan saat command = restore. Nilai default: false.

Mencegah NuGet menginstal beberapa paket dalam proses paralel saat diatur ke true.


direktori Tujuan
Alias input: packagesDirectory. string. Fakultatif. Gunakan saat command = restore.

Menentukan folder tempat paket diinstal. Jika tidak ada folder yang ditentukan, paket dipulihkan ke folder packages/ bersama solusi yang dipilih, packages.config, atau project.json.


Verbosity
string. Fakultatif. Gunakan saat command = restore. Nilai yang diizinkan: Quiet, Normal, Detailed. Nilai default: Detailed.

Menentukan jumlah detail yang ditampilkan dalam output.


packagesToPush - Jalur ke paket NuGet untuk menerbitkan
Alias input: searchPatternPush. string. Diperlukan saat command = push. Nilai default: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.

Menentukan pola yang akan dicocokkan atau jalur ke file nupkg yang akan diunggah. Beberapa pola dapat dipisahkan oleh titik koma.


lokasi umpan target
string. Diperlukan saat command = push. Nilai yang diizinkan: internal (Organisasi/koleksi ini), external (Server NuGet Eksternal (termasuk akun/koleksi lainnya)). Nilai default: internal.

Menentukan apakah umpan target adalah umpan/koleksi internal atau server NuGet eksternal.


lokasi umpan target
string. Diperlukan saat command = push. Nilai yang diizinkan: internal (Akun/koleksi ini), external (Server NuGet Eksternal (termasuk akun/koleksi lainnya)). Nilai default: internal.

Menentukan apakah umpan target adalah umpan/koleksi internal atau server NuGet eksternal.


umpan Target
Alias input: feedPublish. string. Diperlukan saat command = push && nuGetFeedType = internal.

Menentukan umpan yang dihosting di akun ini. Anda harus menginstal dan melisensikan Artefak Azure untuk memilih umpan di sini.


publishPackageMetadata - Menerbitkan metadata alur
boolean. Fakultatif. Gunakan saat command = push && nuGetFeedType = internal && command = push. Nilai default: true.

Mengubah nomor versi subset paket yang diubah dalam satu set paket yang terus diterbitkan.


allowPackageConflicts - Izinkan duplikat dilewati
boolean. Fakultatif. Gunakan saat command = push && nuGetFeedType = internal. Nilai default: false.

Melaporkan keberhasilan tugas meskipun beberapa paket Anda ditolak dengan kesalahan Konflik 409.

Opsi ini saat ini hanya tersedia di Azure Pipelines dan agen Windows. Jika NuGet.exe mengalami konflik, tugas akan gagal. Opsi ini tidak akan berfungsi dan penerbitan akan gagal jika Anda berada dalam lingkungan proksi.


server NuGet
Alias input: externalEndpoint. string. Diperlukan saat command = push && nuGetFeedType = external.

Menentukan koneksi layanan NuGet yang berisi kredensial server NuGet eksternal.


Verbosity
string. Fakultatif. Gunakan saat command = push. Nilai yang diizinkan: Quiet, Normal, Detailed. Nilai default: Detailed.

Menentukan jumlah detail yang ditampilkan dalam output.


packagesToPack - Jalur ke file csproj atau nuspec untuk mengemas
Alias input: searchPatternPack. string. Diperlukan saat command = pack. Nilai default: **/*.csproj.

Menentukan pola yang digunakan tugas untuk mencari direktori csproj untuk dikemas.

Anda dapat memisahkan beberapa pola dengan titik koma, dan Anda dapat membuat pola negatif dengan mengawalinya dengan !. Contoh: **\*.csproj;!**\*.Tests.csproj.


Konfigurasi configuration - untuk mengemas
Alias input: configurationToPack. string. Fakultatif. Gunakan saat command = pack. Nilai default: $(BuildConfiguration).

Menentukan konfigurasi ke paket saat menggunakan file csproj.


folder Paket
Alias input: outputDir. string. Fakultatif. Gunakan saat command = pack. Nilai default: $(Build.ArtifactStagingDirectory).

Menentukan folder tempat tugas membuat paket. Jika nilai kosong, tugas akan membuat paket di akar sumber.


penerapan versi paket otomatis
string. Diperlukan saat command = pack. Nilai yang diizinkan: off, byPrereleaseNumber (Gunakan tanggal dan waktu), byEnvVar (Gunakan variabel lingkungan), byBuildNumber (Gunakan nomor build). Nilai default: off.

Menerapkan penerapan versi paket otomatis tergantung pada nilai yang ditentukan. String ini tidak dapat digunakan dengan includeReferencedProjects. Nilai yang diizinkan adalah:

  • byPrereleaseNumber - Gunakantanggal dan waktu : Tugas akan menghasilkan versi SemVeryang diformat sebagai X.Y.Z-ci-datetime, di mana Anda menentukan nilai X, Y, dan Z.
  • byEnvVar - Gunakan variabel lingkungan: Tugas akan menggunakan variabel lingkungan yang Anda tentukan dan berisi nomor versi yang ingin Anda gunakan.
  • byBuildNumber - Gunakan nomor build: Tugas akan menggunakan nomor build untuk membuat versi paket.

Nota

Di bawah Umum, atur format build menjadi $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r).


includeReferencedProjects - Menyertakan proyek yang dirujuk
boolean. Fakultatif. Gunakan saat versioningScheme = off && command = pack. Nilai default: false.

Termasuk proyek yang dirujuk baik sebagai dependensi atau sebagai bagian dari paket. Tidak dapat digunakan dengan penerapan versi paket otomatis. Jika proyek yang dirujuk memiliki file nuspec terkait yang memiliki nama yang sama dengan proyek, proyek yang dirujuk tersebut ditambahkan sebagai dependensi. Jika tidak, proyek yang dirujuk ditambahkan sebagai bagian dari paket. Pelajari selengkapnya tentang menggunakan perintah paket untuk NuGet CLI untuk membuat paket NuGet.


variabel lingkungan
string. Diperlukan saat versioningScheme = byEnvVar && command = pack.

Menentukan nama variabel tanpa $, $env, atau %.


Mayor
Alias input: requestedMajorVersion. string. Diperlukan saat versioningScheme = byPrereleaseNumber && command = pack. Nilai default: 1.

X dalam versi X.Y.Z.


minorVersion - Kecil
Alias input: requestedMinorVersion. string. Diperlukan saat versioningScheme = byPrereleaseNumber && command = pack. Nilai default: 0.

Y dalam versi X.Y.Z.


Patch
Alias input: requestedPatchVersion. string. Diperlukan saat versioningScheme = byPrereleaseNumber && command = pack. Nilai default: 0.

Z dalam versi X.Y.Z.


Zona waktu
string. Fakultatif. Gunakan saat versioningScheme = byPrereleaseNumber && command = pack. Nilai yang diizinkan: utc, local (Waktu lokal Agen). Nilai default: utc.

Menentukan zona waktu yang diinginkan yang digunakan untuk menghasilkan versi paket. Memilih utc disarankan jika Anda menggunakan agen build yang dihosting, karena tanggal dan waktunya mungkin berbeda.


includeSymbols - Membuat paket simbol
boolean. Fakultatif. Gunakan saat command = pack. Nilai default: false.

Menentukan bahwa paket berisi sumber dan simbol. Ketika digunakan dengan file .nuspec, ini membuat file paket NuGet reguler dan paket simbol yang sesuai.


Paket Alat
boolean. Fakultatif. Gunakan saat command = pack. Nilai default: false.

Menentukan apakah file output proyek harus berada di folder alat.


buildProperties - Properti build tambahan
string. Fakultatif. Gunakan saat command = pack.

Menentukan daftar pasangan token=value, dipisahkan oleh titik koma, di mana setiap kemunculan $token$ dalam file .nuspec akan diganti dengan nilai yang diberikan. Nilai dapat berupa string dalam tanda kutip.


jalur Dasar
string. Fakultatif. Gunakan saat command = pack.

Menentukan jalur dasar file yang ditentukan dalam file nuspec.


Verbosity
string. Fakultatif. Gunakan saat command = pack. Nilai yang diizinkan: Quiet, Normal, Detailed. Nilai default: Detailed.

Menentukan jumlah detail yang ditampilkan dalam output.


Perintah dan argumen
string. Diperlukan saat command = custom.

Menentukan perintah dan argumen yang akan diteruskan ke NuGet.exe untuk eksekusi. Jika NuGet 3.5 atau yang lebih baru digunakan, perintah terautentikasi seperti list, restore, dan publish terhadap umpan apa pun di organisasi ini atau koleksi yang dapat diakses oleh Project Collection Build Service akan diautentikasi secara otomatis.


Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugasnya. Untuk informasi selengkapnya, lihat opsi Kontrol dan properti tugas umum.

Variabel output

Tidak.

Komentar

Penting

Tugas Autentikasi NuGet adalah cara baru yang direkomendasikan untuk mengautentikasi dengan Azure Artifacts dan repositori NuGet lainnya. Tugas ini tidak lagi mengambil fitur baru, dan hanya bug penting yang ditangani.

Gunakan tugas ini untuk menginstal dan memperbarui dependensi paket NuGet, atau mengemas dan menerbitkan paket NuGet. Menggunakan NuGet.exe dan bekerja dengan aplikasi .NET Framework. Untuk aplikasi .NET Core dan .NET Standard, gunakan tugas .NET Core.

Jika kode Anda bergantung pada paket NuGet, pastikan untuk menambahkan langkah ini sebelum tugas Visual Studio Build Anda. Pastikan juga untuk menghapus kotak centang Pulihkan Paket NuGet yang tidak digunakan lagi dalam tugas tersebut.

Jika Anda bekerja dengan .NET Core atau .NET Standard, gunakan tugas .NET Core, yang memiliki dukungan penuh untuk semua skenario paket dan saat ini didukung oleh dotnet.

Ujung

Versi tugas NuGet ini menggunakan NuGet 4.1.0 secara default. Untuk memilih versi NuGet yang berbeda, gunakan Tool Installer.

Skema penerapan versi

Untuk byPrereleaseNumber, versi akan diatur ke nilai yang Anda pilih untuk versi utama, versi minor, dan patch, ditambah tanggal dan waktu, dalam format yyyymmdd-hhmmss.

Untuk olehEnvVar, versi akan diatur ke nilai variabel lingkungan yang memiliki nama yang ditentukan oleh parameter versionEnvVar, misalnya MyVersion (tidak ada $, hanya nama variabel lingkungan). Pastikan variabel lingkungan diatur ke SemVer yang tepat, seperti 1.2.3 atau 1.2.3-beta1.

Untuk byBuildNumber, versi akan diatur menggunakan nomor build eksekusi alur. Ini adalah nilai yang ditentukan untuk properti name alur, yang disimpan ke variabel lingkungan BUILD_BUILDNUMBER). Pastikan bahwa nomor build yang digunakan berisi SemVer yang tepat, seperti 1.0.$(Rev:r). Saat menggunakan byBuildNumber, tugas akan mengekstrak versi putus-putus, 1.2.3.4, dari string nomor build, dan hanya menggunakan bagian tersebut. Sisa string akan dihilangkan. Jika Anda ingin menggunakan nomor build apa adanya, Anda dapat menggunakan byEnvVar seperti yang dijelaskan di atas, dan mengatur versionEnvVar ke BUILD_BUILDNUMBER.

Bermigrasi dari NuGetInstaller@0 atau NuGetRestore@1

NuGetInstaller@0 dan NuGetRestore@1 tidak digunakan lagi, dan Anda harus menggantinya di alur Anda dengan NuGetCommand@2.

Jika Anda menggunakan NuGetInstaller@0 dengan restoreMode: restore, konfigurasikan input berikut saat menggunakan NuGetCommand@2.

NuGetCommand@2 input tugas Nilai
command restore
restoreSolution Jalur file .sln

Jika Anda menggunakan NuGetInstaller@0 dengan restoreMode: install, konfigurasikan input berikut saat menggunakan NuGetCommand@2.

NuGetCommand@2 input tugas Nilai
command custom
arguments Seperti apa perintah penginstalan lengkap di NuGet CLI. Misalnya, jika Anda ingin menjalankan nuget install ninject -OutputDirectory c:\proj yang setara di alur Anda, parameter arguments akan install ninject -OutputDirectory c:\proj. Jika Anda menggunakan parameter NuGetInstaller@0nuGetRestoreArgs, ini juga sekarang masuk arguments.

Jika Anda menggunakan NuGetRestore@1, konfigurasikan input berikut saat menggunakan NuGetCommand@2.

NuGetCommand@2 input tugas Nilai
command restore
restoreSolution Jalur file .sln

Mirip dengan menggunakan NuGetRestore@1 atau opsi NuGetInstaller@0restore, NuGetCommand@2 memiliki input untuk mengatur umpan, memutuskan antara select atau config, tentukan jalur ke file NuGet.config, dan gunakan paket dari nuget.org.

Untuk informasi selengkapnya, lihat contoh berikut ini.

Contoh

Mengembalikan

Pulihkan semua solusi Anda dengan paket dari umpan yang dipilih.

# Restore from a project scoped feed in the same organization
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    vstsFeed: 'my-project/my-project-scoped-feed'
    includeNuGetOrg: false
    restoreSolution: '**/*.sln'
# Restore from an organization scoped feed in the same organization
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    vstsFeed: 'my-organization-scoped-feed'
    restoreSolution: '**/*.sln'
# Restore from a feed in a different organization
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: config
    nugetConfigPath: ./nuget.config
    restoreSolution: '**/*.sln'
    externalFeedCredentials: 'MyServiceConnectionName'
    noCache: true
  continueOnError: true
# Restore from feed(s) set in nuget.config
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: 'config'
    nugetConfigPath: 'nuget.config'

Paket

Buat paket NuGet di folder tujuan.

# Package a project
- task: NuGetCommand@2
  inputs:
    command: 'pack'
    packagesToPack: '**/*.csproj'
    packDestination: '$(Build.ArtifactStagingDirectory)'

Dorong

Nota

Artefak alur diunduh ke direktori Pipeline.Workspace, dan ke direktori System.ArtifactsDirectory untuk alur rilis klasik. nilai packagesToPush dapat diatur ke $(Pipeline.Workspace)/**/*.nupkg atau $(System.ArtifactsDirectory)/**/*.nupkg masing-masing.

  • Dorong/Terbitkan paket ke umpan yang ditentukan dalam NuGet.configAnda .

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg'
        feedsToUse: 'config'
        nugetConfigPath: '$(Build.WorkingDirectory)/NuGet.config'
    
  • Mendorong/Menerbitkan paket ke umpan terlingkup organisasi

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        nuGetFeedType: 'internal'
        publishVstsFeed: 'my-organization-scoped-feed'
    
  • Mendorong/Menerbitkan paket ke umpan cakupan proyek

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        nuGetFeedType: 'internal'
        publishVstsFeed: 'my-project/my-project-scoped-feed'
    
  • Mendorong/Menerbitkan paket ke NuGet.org

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        feedsToUse: 'config'
        includeNugetOrg: 'true'
    

Adat

Jalankan perintah NuGet lainnya selain perintah default: paket, dorong, dan pulihkan.

# list local NuGet resources.
- task: NuGetCommand@2
  displayName: 'list locals'
  inputs:
    command: custom
    arguments: 'locals all -list'

Persyaratan

Syarat Deskripsi
Jenis alur YAML, Build klasik, Rilis klasik
Berjalan pada Agen, DeploymentGroup
Permintaan Tidak
Kemampuan Tugas ini tidak memenuhi tuntutan apa pun untuk tugas berikutnya dalam pekerjaan.
pembatasan Perintah Apa pun
variabel yang Dapat Diatur Apa pun
Versi agen 2.144.0 atau lebih tinggi
Kategori tugas Paket
Syarat Deskripsi
Jenis alur YAML, Build klasik, Rilis klasik
Berjalan pada Agen, DeploymentGroup
Permintaan Tidak
Kemampuan Tugas ini tidak memenuhi tuntutan apa pun untuk tugas berikutnya dalam pekerjaan.
pembatasan Perintah Apa pun
variabel yang Dapat Diatur Apa pun
Versi agen 2.115.0 atau lebih tinggi
Kategori tugas Paket