NuGetCommand@2 - NuGet v2 görevi

Important

Paketleri Azure Artifacts veya kamu kayıtlarına doğrulamak ve yayımlamak için, NuGetAuthenticate@1 görevini .NET CLI görevi ile birleştirin. Görev NuGetCommand@2 artık yeni özelliklerle güncellenmiyor; yalnızca kritik hatalar ele alınıyor.

Bu görevi NuGet paketlerini paketlemek veya geri yüklemek için kullanın, ya da bir NuGet komutu çalıştırın. Bu görev NuGet.exe kullanır ve .NET Framework uygulamalarıyla çalışır. .NET Core ve .NET Standard uygulamaları için .NET Core görevini kullanın.

Syntax

# NuGet v2
# Use this task to restore or pack 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. 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
# Use this task to restore or pack 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. 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.

Inputs

command - Komut
string. Required. İzin verilen değerler: restore, pack, push, custom. Varsayılan değer: restore.

Çalıştırılacak NuGet komutunu belirtir. Bağımsız değişken eklemek veya farklı bir komut kullanmak için custom değerini kullanın.


Çözüm yolu, packages.configveya project.json
Giriş diğer adı: solution. string. command = restoregerekir. Varsayılan değer: **/*.sln.

Geri yüklenecek paketlere başvuran çözüm, packages.configveya project.json dosyasının yolunu belirtir.


kullanmak için Akışları
Giriş diğer adı: selectOrConfig. string. command = restoregerekir. İzin verilen değerler: select (Burada seçtiğim akışlar), config (NuGet.configakışlarım). Varsayılan değer: select.

Görevin select değeriyle kullanılması için Azure Artifacts'ten ve/veya NuGet.org bir akışı belirtir. Alternatif olarak, kaynak kod deponuza bir NuGet.config dosyası işleyebilir ve config değerini kullanarak yolunu değer olarak ayarlayabilirsiniz.


vstsFeed - Bu Azure Artifacts/TFS akışındaki paketleri kullanın. Açılan listeden seçin veya [proje adı/]akış adı girin.
Giriş diğer adı: feedRestore. string. Optional. selectOrConfig = select && command = restoreolduğunda kullanın.

Oluşturulan NuGet.configseçili akışı belirtir. Burada bir akış belirtmek için Paket Yönetimi'nin yüklü ve lisanslı olması gerekir.


vstsFeed - Bu Azure Artifacts/TFS akışındaki paketleri kullan
Giriş diğer adı: feedRestore. string. Optional. selectOrConfig = select && command = restoreolduğunda kullanın.

Oluşturulan NuGet.configseçili akışı belirtir. Burada bir akış belirtmek için Paket Yönetimi'nin yüklü ve lisanslı olması gerekir.


includeNuGetOrg - NuGet.org paketlerini kullanma
boolean. Optional. selectOrConfig = select && command = restoreolduğunda kullanın. Varsayılan değer: true.

Oluşturulan NuGet.configNuGet.org içerir.


NuGet.config yolunu
string. Optional. selectOrConfig = config && command = restoreolduğunda kullanın.

Deponuzda paketlerin geri yükleneceği akışları belirleyen NuGet.config yolunu belirtir.


Bu kuruluş/koleksiyon dışındaki akışlar için kimlik bilgilerini
Giriş diğer adı: externalEndpoints. string. Optional. selectOrConfig = config && command = restoreolduğunda kullanın.

Seçili NuGet.configbulunan dış kayıt defterleri için kullanılacak kimlik bilgilerini belirtir. Bu, NuGet hizmet bağlantınızın adıdır. Bu kuruluş veya koleksiyondaki akışlar için bunu boş bırakın; derlemenin kimlik bilgileri otomatik olarak kullanılır.


noCache - Yerel önbellek devre dışı bırak
boolean. Optional. command = restoreolduğunda kullanın. Varsayılan değer: false.

trueolarak ayarlandığında NuGet'in yerel makine önbelleklerinden gelen paketleri kullanmasını engeller.


disableParallelProcessing - Paralel işlemeyi devre dışı bırakma
boolean. Optional. command = restoreolduğunda kullanın. Varsayılan değer: false.

trueolarak ayarlandığında NuGet'in paralel işlemlerde birden çok paket yüklemesini engeller.


restoreDirectory - Hedef dizin
Giriş diğer adı: packagesDirectory. string. Optional. command = restoreolduğunda kullanın.

Paketlerin yüklendiği klasörü belirtir. Hiçbir klasör belirtilmezse paketler seçili çözümle birlikte packages/ klasörüne geri yüklenir, packages.configveya project.json.


verbosityRestore - Ayrıntı
string. Optional. command = restoreolduğunda kullanın. İzin verilen değerler: Quiet, Normal, Detailed. Varsayılan değer: Detailed.

Çıktıda görüntülenen ayrıntı miktarını belirtir.


yayımlamak için NuGet paketlerinin yolunu
Giriş diğer adı: searchPatternPush. string. command = pushgerekir. Varsayılan değer: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.

Eşleştirilecek deseni veya karşıya yüklenecek nupkg dosyalarının yolunu belirtir. Birden çok desen noktalı virgülle ayrılabilir.


nuGetFeedType - Hedef akış konumu
string. command = pushgerekir. İzin verilen değerler: internal (Bu kuruluş/koleksiyon), external (Dış NuGet sunucusu (diğer hesaplar/koleksiyonlar dahil)). Varsayılan değer: internal.

Hedef akışın bir iç akış/koleksiyon mu yoksa bir dış NuGet sunucusu mu olduğunu belirtir.


publishVstsFeed - Hedef besleme
Giriş diğer adı: feedPublish. string. command = push && nuGetFeedType = internalgerekir.

Bu hesapta barındırılan bir akışı belirtir. Burada bir akış seçmek için Azure Artifacts'in yüklü ve lisanslı olması gerekir.


publishPackageMetadata - İşlem hattı meta verilerini yayımlama
boolean. Optional. command = push && nuGetFeedType = internalolduğunda kullanın. Varsayılan değer: true.

Sürekli yayımlanan paketler kümesi içinde değiştirilen paketlerin alt kümesinin sürüm numarasını değiştirir.


allowPackageConflicts - Yinelemelerin atlanmasına izin ver
boolean. Optional. command = push && nuGetFeedType = internalolduğunda kullanın. Varsayılan değer: false.

Bazı paketleriniz 409 Çakışma hataları ile reddedilmiş olsa bile görevin başarılı olduğunu bildirir.

Bu seçenek şu anda yalnızca Azure Pipelines ve Windows aracılarında kullanılabilir. NuGet.exe çakışmayla karşılaşırsa görev başarısız olur. Bu seçenek çalışmaz ve bir ara sunucu ortamındaysanız yayımlama başarısız olur.


publishFeedCredentials - NuGet sunucusu
Giriş diğer adı: externalEndpoint. string. command = push && nuGetFeedType = externalgerekir.

Dış NuGet sunucusunun kimlik bilgilerini içeren NuGet hizmet bağlantısını belirtir.


verbosityPush - Ayrıntı
string. Optional. command = pusholduğunda kullanın. İzin verilen değerler: Quiet, Normal, Detailed. Varsayılan değer: Detailed.

Çıktıda görüntülenen ayrıntı miktarını belirtir.


paketlemek için csproj veya nuspec dosyalarının yolunu
Giriş diğer adı: searchPatternPack. string. command = packgerekir. Varsayılan değer: **/*.csproj.

Görevin paketlenmesi gereken csproj dizinlerini aramak için kullandığı deseni belirtir.

Birden çok deseni noktalı virgülle ayırabilir ve !önekini ekleyerek negatif bir desen oluşturabilirsiniz. Örnek: **\*.csproj;!**\*.Tests.csproj.


paketlemek için yapılandırmayı
Giriş diğer adı: configurationToPack. string. Optional. command = packolduğunda kullanın. Varsayılan değer: $(BuildConfiguration).

Csproj dosyası kullanılırken paketlenecek yapılandırmayı belirtir.


packDestination - Paket klasörü
Giriş diğer adı: outputDir. string. Optional. command = packolduğunda kullanın. Varsayılan değer: $(Build.ArtifactStagingDirectory).

Görevin paketleri oluşturduğu klasörü belirtir. Değer boşsa, görev kaynak kökte paketler oluşturur.


versioningScheme - Otomatik paket sürüm oluşturma
string. command = packgerekir. İzin verilen değerler: off, byPrereleaseNumber (Tarih ve saati kullanın), byEnvVar (Ortam değişkeni kullanın), byBuildNumber (Derleme numarasını kullanın). Varsayılan değer: off.

Belirtilen değere bağlı olarak otomatik paket sürümü oluşturma uygular. Bu dize includeReferencedProjectsile kullanılamaz. İzin verilen değerler şunlardır:

  • byPrereleaseNumber - Tarih ve saatkullanın: Görev, X, Y ve Z değerlerini belirttiğiniz olarak biçimlendirilmiş X.Y.Z-ci-datetimeuyumlu bir sürüm oluşturur.
  • byEnvVar - ortam değişkeni kullan: Görev, belirttiğiniz bir ortam değişkeni kullanır ve kullanmak istediğiniz sürüm numarasını içerir.
  • byBuildNumber - Derleme numarasınıkullanın: Görev, paketi sürüme eklemek için derleme numarasını kullanır.

Note

Genel'in altında derleme biçimini $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r)olarak ayarlayın.


includeReferencedProjects - Başvuruda bulunılan projeleri dahil
boolean. Optional. versioningScheme = off && command = packolduğunda kullanın. Varsayılan değer: false.

Başvuruda bulunan projeleri bağımlılık olarak veya paketin bir parçası olarak içerir. Otomatik paket sürümü oluşturma ile kullanılamaz. Başvuruda bulunılan bir projenin, projeyle aynı ada sahip karşılık gelen bir nuspec dosyası varsa, bu başvuruda bulunılan proje bağımlılık olarak eklenir. Aksi takdirde, başvuruda bulunan proje paketin bir parçası olarak eklenir. NuGet paketleri oluşturmak için NuGet CLI için paket komutunu kullanarak hakkında daha fazla bilgi edinin.


versionEnvVar - Ortam değişkeni
string. versioningScheme = byEnvVar && command = packgerekir.

$, $envveya %olmadan değişken adını belirtir.


majorVersion - Binbaşı
Giriş diğer adı: requestedMajorVersion. string. versioningScheme = byPrereleaseNumber && command = packgerekir. Varsayılan değer: 1.

X sürümünde.


minorVersion - Küçük
Giriş diğer adı: requestedMinorVersion. string. versioningScheme = byPrereleaseNumber && command = packgerekir. Varsayılan değer: 0.

Y sürümünde.


patchVersion - Yama
Giriş diğer adı: requestedPatchVersion. string. versioningScheme = byPrereleaseNumber && command = packgerekir. Varsayılan değer: 0.

Z sürümünde.


packTimezone - Zaman dilimi
string. Optional. versioningScheme = byPrereleaseNumber && command = packolduğunda kullanın. İzin verilen değerler: utc, local (Aracı yerel saati). Varsayılan değer: utc.

Paketin sürümünü oluşturmak için kullanılan istenen saat dilimini belirtir. Barındırılan derleme aracıları kullanıyorsanız tarih ve saat farklı olabileceği için utc seçmeniz önerilir.


includeSymbols - Simge oluşturma paketi
boolean. Optional. command = packolduğunda kullanın. Varsayılan değer: false.

Paketin kaynaklar ve simgeler içerdiğini belirtir. bir .nuspec dosyasıyla kullanıldığında, bu normal bir NuGet paket dosyası ve karşılık gelen semboller paketini oluşturur.


toolPackage - Araç Paketi
boolean. Optional. command = packolduğunda kullanın. Varsayılan değer: false.

Projenin çıkış dosyalarının araç klasöründe olup olmadığını belirler.


buildProperties - Ek derleme özellikleri
string. Optional. command = packolduğunda kullanın.

$token$ dosyasındaki her .nuspec oluşumunun verilen değerle değiştirileceği noktalı virgülle ayrılmış token=value çiftlerinin listesini belirtir. Değerler, tırnak işaretleri içindeki dizeler olabilir.


basePath - Temel yol
string. Optional. command = packolduğunda kullanın.

nuspec dosyasında tanımlanan dosyaların temel yolunu belirtir.


verbosityPack - Ayrıntı
string. Optional. command = packolduğunda kullanın. İzin verilen değerler: Quiet, Normal, Detailed. Varsayılan değer: Detailed.

Çıktıda görüntülenen ayrıntı miktarını belirtir.


arguments - Komutu ve bağımsız değişkenleri
string. command = customgerekir.

Yürütme için NuGet.exe geçirilecek komutu ve bağımsız değişkenleri belirtir. NuGet 3.5 veya üzeri kullanılırsa, list, restoreve Bu kuruluştaki veya koleksiyondaki Proje Koleksiyonu Derleme Hizmeti'nin erişimi olan herhangi bir akışa karşı publish gibi kimliği doğrulanmış komutların kimliği otomatik olarak doğrulanır.


Görev denetimi seçenekleri

Tüm görevlerin, görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz. Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

None.

Remarks

Bu görevi kullanarak NuGet paketlerini geri yüklemek veya paketlemek ya da bir NuGet komutu çalıştırmak için kullanın. Bu görev NuGet.exe kullanır ve .NET Framework uygulamalarıyla çalışır. .NET Core veya .NET Standard ile çalışıyorsanız, tüm paket senaryoları için tam desteğe sahip olan ve şu anda dotnet tarafından desteklenen .NET Core görevini kullanın.

Important

Paketleri Azure Artifacts veya diğer paket kayıtlarına doğrulamak ve yayımlamak için, NuGetAuthenticate@1 görevini .NET CLI görevi ile birleştirin.

Kodunuz NuGet paketlerine bağlıysa ve Visual Studio Derleme görev göreviyle projenizi oluşturmadan önce bu bağımlılıkları geri yüklemeniz gerekiyorsa, paketlerinizi geri yüklemek için nugetAuthenticate ve komut satırı görevlerini kullanabilirsiniz. Derleme başlamadan önce tüm bağımlılıkların kullanılabilir olduğundan emin olmak için her iki görevi de derleme adımından önce yerleştirin. Daha fazla ayrıntı için NuGet paketlerini geri yükleme bölümüne bakın.

Visual Studio Derleme görev görevini kullanırken, VSBuild@1 görevde "NuGet Paketlerini Geri Yükle" seçeneği kullanım dışı bırakıldığından restoreNugetPackages bağımsız değişkenini boş bıraktığınızdan emin olun.

Tip

NuGet görevinin bu sürümü varsayılan olarak NuGet 4.1.0'ı kullanır. NuGet'in farklı bir sürümünü seçmek için Araç Yükleyicisi'ni kullanın.

Sürüm oluşturma düzenleri

byPrereleaseNumber için sürüm, ana sürüm, ikincil sürüm ve yama için seçtiğiniz değerlerin yanı sıra biçimindeki yyyymmdd-hhmmsstarih ve saate ayarlanır.

byEnvVar için sürüm, versionEnvVar parametresi tarafından belirtilen ada sahip ortam değişkeninin değerine ayarlanır, MyVersion örneğin (hayır$, yalnızca ortam değişkeni adı). Ortam değişkeninin 1.2.3 veya 1.2.3-beta1gibi uygun bir SemVer olarak ayarlandığından emin olun.

byBuildNumber için sürüm, işlem hattı çalıştırmasının derleme numarası kullanılarak ayarlanır. Bu, işlem hattının name ortam değişkenine kaydedilen BUILD_BUILDNUMBER özelliği için belirtilen değerdir). Kullanılan derleme numarasının 1.0.$(Rev:r)gibi düzgün bir SemVer içerdiğinden emin olun. byBuildNumber kullanılırken, görev yapı numarası dizesinden noktalı sürümü 1.2.3.4() ayıklar ve yalnızca bu kısmı kullanır. Dizenin geri kalanı bırakılır. Yapı numarasını olduğu gibi kullanmak istiyorsanız, yukarıda açıklandığı gibi byEnvVar'ı kullanabilir ve versionEnvVar'ıBUILD_BUILDNUMBERolarak ayarlayabilirsiniz.

NuGetInstaller@0 veya NuGetRestore@1'dan geçiş

NuGetInstaller@0 ve NuGetRestore@1 kullanım dışıdır ve bunları işlem hattınızda NuGetCommand@2ile değiştirmeniz gerekir.

NuGetInstaller@0ile restoreMode: restore kullanıyorsanız, NuGetCommand@2kullanırken aşağıdaki girişleri yapılandırın.

Görev girişini NuGetCommand@2 Value
command restore
restoreSolution .sln dosyasının yolunu belirleme

NuGetInstaller@0ile restoreMode: install kullanıyorsanız, NuGetCommand@2kullanırken aşağıdaki girişleri yapılandırın.

Görev girişini NuGetCommand@2 Value
command custom
arguments NuGet CLI'da tam yükleme komutunun nasıl görüneceği. Örneğin, işlem hattınızda nuget install ninject -OutputDirectory c:\proj eşdeğerini çalıştırmak istiyorsanız, arguments parametresi install ninject -OutputDirectory c:\projolacaktır. NuGetInstaller@0 nuGetRestoreArgs parametresini kullandıysanız, bu parametreler artık argumentsbölümüne de gider.

NuGetRestore@1kullanıyorsanız, NuGetCommand@2kullanırken aşağıdaki girişleri yapılandırın.

Görev girişini NuGetCommand@2 Value
command restore
restoreSolution .sln dosyasının yolunu belirleme

NuGetRestore@1 veya NuGetInstaller@0restore seçeneğini kullanmaya benzer şekilde, NuGetCommand@2 akışı ayarlamak, select veya configarasında karar vermek, NuGet.config dosyasının yolunu belirtmek ve nuget.org paketlerini kullanmak için girişleri vardır.

Daha fazla bilgi için aşağıdaki örneklere bakın.

Daha Yeni Ubuntu Barındırılan Görüntüler için Destek

Ubuntu 24.04'den başlayarak, Microsft tarafından barındırılan aracılar ile birlikte göndermez. Ubuntu'da bu görevin kullanıcıları .NET CLI ile NuGetAuthenticate@1 uzun süreli desteklenen platformlar arası göreve geçmelidir.

Ubuntu'da .NET CLI'ya geçiş

NuGet Kimlik Doğrulama görevi, istemci araçlarının işlem hattı kimliğiniz olarak kimlik doğrulaması yapması için gereken yerlere kimlik bilgileri ekleme işlemini gerçekleştirir. dotnet ile kullanma hakkında daha fazla bilgi edinmek için lütfen Örnekler ve NuGet Authenticate bölümlerine bakın.

dotnet CLI komutları senaryonuzu desteklemiyorsa, bunubir sorun olarak .NET CLI ekibine bildirin. Aracı görüntünüzü Ubuntu 22.04 veya öncekisabitlemeye devam edebilirsiniz. Ubuntu 22.04 desteği, 2026'dan önce değil, Ubuntu 26.04 genel kullanıma sunulana kadar devam edecektir.

Derleme işlem hattım neden başarısız oluyor ve Tek Sign-On (SSO) kimlik doğrulaması istiyor?

Kimlik bilgilerinin süresi dolduysa derlemeler başarısız olabilir. Bu hatalardan kaçınmak için, kimlik bilgisi sağlayıcısını yeniden yüklemek ve kimlik bilgilerini otomatik olarak yenilemek için NuGet Authenticate görevini kullanmanızı öneririz. Bu, boru hattı yürütmesi sırasında kesintisiz erişim sağlar.

steps:
# Authenticate with NuGet to ensure credentials are refreshed
- task: NuGetAuthenticate@1
# Restore NuGet packages
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    restoreSolution: '**/*.sln'
    feedsToUse: 'select'

Examples

Restore

Seçili bir akıştan gelen paketlerle tüm çözümlerinizi geri yükleyin.

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

Package

Hedef klasörde bir NuGet paketi oluşturun.

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

Custom

Varsayılan komutlar dışında başka herhangi bir NuGet komutunu çalıştırın:

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

Requirements

Requirement Description
Boru hattı türleri YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır Aracı, DeploymentGroup
Demands None
Capabilities Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları Any
Ayarlanabilir değişkenler Any
Aracı sürümü 2.144.0 veya üzeri
Görev kategorisi Package
Requirement Description
Boru hattı türleri YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır Aracı, DeploymentGroup
Demands None
Capabilities Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları Any
Ayarlanabilir değişkenler Any
Aracı sürümü 2.115.0 veya üzeri
Görev kategorisi Package