NuGetCommand@2 - Tugas NuGet v2

Gunakan tugas ini untuk memulihkan, mengemas, atau mendorong paket NuGet, atau menjalankan perintah NuGet. Tugas ini mendukung umpan NuGet.org dan 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.

Sintaks

# 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

command - Perintah
string. Wajib diisi. Nilai yang diizinkan: restore, pack, push, custom. Nilai default: restore.

Menentukan perintah NuGet untuk dijalankan. custom Gunakan nilai 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 solusi, packages.config, atau project.json file yang mereferensikan paket yang akan dipulihkan.


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

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


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

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


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

Termasuk NuGet.org dalam yang dihasilkan NuGet.config.


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

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


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

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


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

Menentukan kredensial yang akan digunakan untuk registri eksternal yang terletak di yang dipilih NuGet.config. 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. Pilihan. Gunakan saat command = restore. Nilai default: false.

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


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

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


restoreDirectory - Direktori tujuan
Alias input: packagesDirectory. string. Pilihan. 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.


verbosityRestore - Verbositas
string. Pilihan. Gunakan saat command = restore. Nilai yang diizinkan: Quiet, Normal, dan Detailed. Nilai default: Detailed.

Menentukan jumlah detail yang ditampilkan dalam output.


packagesToPush - Jalur ke paket NuGet untuk diterbitkan
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 nupkg file yang akan diunggah. Beberapa pola dapat dipisahkan oleh titik koma.


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

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


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

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


publishVstsFeed - 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. Pilihan. Gunakan saat command = push && nuGetFeedType = internal && command = push. Nilai default: true.

Mengubah nomor versi subset paket yang diubah dalam sekumpulan paket yang terus diterbitkan.


allowPackageConflicts - Perbolehkan duplikat dilewati
boolean. Pilihan. 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.


publishFeedCredentials - Server NuGet
Alias input: externalEndpoint. string. Diperlukan saat command = push && nuGetFeedType = external.

Menentukan koneksi layanan NuGet yang berisi kredensial server NuGet eksternal.


verbosityPush - Verbositas
string. Pilihan. Gunakan saat command = push. Nilai yang diizinkan: Quiet, Normal, dan Detailed. Nilai default: Detailed.

Menentukan jumlah detail yang ditampilkan dalam output.


packagesToPack - Jalur ke file csproj atau nuspec untuk dikemas
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.


configuration - Konfigurasi ke paket
Alias input: configurationToPack. string. Pilihan. Gunakan saat command = pack. Nilai default: $(BuildConfiguration).

Menentukan konfigurasi ke paket saat menggunakan file csproj.


packDestination - Folder paket
Alias input: outputDir. string. Pilihan. Gunakan saat command = pack. Nilai default: $(Build.ArtifactStagingDirectory).

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


versioningScheme - 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 diperbolehkan adalah:

  • byPrereleaseNumber - Gunakan tanggal dan waktu: Tugas akan menghasilkan versi yang mematuhi SemVer yang 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.

Catatan

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


includeReferencedProjects - Sertakan proyek yang dirujuk
boolean. Pilihan. 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 terkait nuspec 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.


versionEnvVar - Variabel lingkungan
string. Diperlukan saat versioningScheme = byEnvVar && command = pack.

Menentukan nama variabel tanpa $, , $envatau %.


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

versi X dalam X.Y.Z.


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

versi Y dalam X.Y.Z.


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

versi Z dalam X.Y.Z.


packTimezone - Zona waktu
string. Pilihan. 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 disarankan jika Anda menggunakan agen build yang dihosting utc , karena tanggal dan waktunya mungkin berbeda.


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

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


toolPackage - Paket Alat
boolean. Pilihan. Gunakan saat command = pack. Nilai default: false.

Menentukan apakah file output proyek harus berada di folder alat.


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

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


basePath - Jalur dasar
string. Pilihan. Gunakan saat command = pack.

Menentukan jalur dasar file yang ditentukan dalam nuspec file.


verbosityPack - Verbositas
string. Pilihan. Gunakan saat command = pack. Nilai yang diizinkan: Quiet, Normal, dan Detailed. Nilai default: Detailed.

Menentukan jumlah detail yang ditampilkan dalam output.


arguments - 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 tugas mereka. Untuk informasi selengkapnya, lihat Opsi kontrol dan properti tugas umum.

Variabel output

Tidak ada.

Keterangan

Penting

Tugas NuGet Authenticate adalah cara baru yang direkomendasikan untuk mengautentikasi dengan Artefak Azure 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.

Tip

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

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 byEnvVar, versi akan diatur ke nilai variabel lingkungan yang memiliki nama yang ditentukan oleh parameter versionEnvVar , misalnya MyVersion (tidak, $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 alur name , yang disimpan ke BUILD_BUILDNUMBER variabel lingkungan). 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.4dari string nomor build, dan hanya menggunakan bagian tersebut. Sisa string akan dihilangkan. Jika Anda ingin menggunakan nomor build apa adanya, Anda dapat menggunakan olehEnvVar seperti yang dijelaskan di atas, dan mengatur versionEnvVar ke BUILD_BUILDNUMBER.

Migrasi 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 yang setara nuget install ninject -OutputDirectory c:\proj dengan dalam alur Anda, maka parameternya arguments adalah install ninject -OutputDirectory c:\proj. Jika Anda menggunakan NuGetInstaller@0nuGetRestoreArgs parameter, ini juga sekarang masuk ke 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 NuGetInstaller@0restore opsi , NuGetCommand@2 memiliki input untuk mengatur umpan, memutuskan antara select atau config, menentukan jalur ke NuGet.config file, dan menggunakan paket dari nuget.org.

Untuk informasi selengkapnya, lihat contoh berikut ini.

Contoh

Pulihkan

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)'

Pendorongan

Catatan

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

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

    # 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 lingkup 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'
    

Kustom

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

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

Persyaratan

Persyaratan Deskripsi
Jenis alur YAML, Build klasik, Rilis klasik
Berjalan pada Agen, DeploymentGroup
Permintaan Tidak ada
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
Persyaratan Deskripsi
Jenis alur YAML, Build klasik, Rilis klasik
Berjalan pada Agen, DeploymentGroup
Permintaan Tidak ada
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