UseDotNet@2 - dotnet v2 görevini kullanma

İnternet'ten veya yerel önbellekten .NET Core SDK'sının belirli bir sürümünü almak ve PATH'e eklemek için bu görevi kullanın. Sonraki görevlerde kullanılan .NET Core sürümünü değiştirmek için bu görevi kullanın. Bu görev ayrıca ara sunucu desteği de sağlar.

Syntax

# Use .NET Core v2
# Acquires a specific version of the .NET Core SDK from the internet or the local cache and adds it to the PATH. Use this task to change the version of .NET Core used in subsequent tasks. Additionally provides proxy support.
- task: UseDotNet@2
  inputs:
    #packageType: 'sdk' # 'runtime' | 'sdk'. Package to install. Default: sdk.
    #useGlobalJson: false # boolean. Optional. Use when packageType = sdk. Use global json. Default: false.
    #workingDirectory: # string. Optional. Use when useGlobalJson = true. Working Directory. 
    #version: # string. Optional. Use when useGlobalJson = false || packageType = runtime. Version. 
    #includePreviewVersions: false # boolean. Optional. Use when useGlobalJson = false  || packageType = runtime. Include Preview Versions. Default: false.
  # Advanced
    #vsVersion: # string. Compatible Visual Studio version. 
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.

Girişler

packageType - Yüklenecek paket
string. İzin verilen değerler: runtime, sdk (SDK (çalışma zamanı içerir)). Varsayılan değer: sdk.

Yalnızca .NET çalışma zamanının mı yoksa SDK'nın mı yükleneceğini belirtir.

useGlobalJson - Genel json kullanma
boolean. İsteğe bağlı. when packageType = sdkkullanın. Varsayılan değer: false.

Dosyalardan global.json tüm SDK'ları yükler. Bu dosyalar üzerinden system.DefaultWorkingDirectoryaranıyor. Çalışma dizini girişini ayarlayarak arama kök yolunu değiştirebilirsiniz.

Girişte 6.xUseDotNet@2.version açıklanan ve 6.1.x biçimi (joker karakter olarak kullanılır.x) içindeki parametrede değilsdk.version, görevdeki girişte global.jsonkullanılırversion.

gibi ##[error]Version 6.0.x is not allowed. Allowed version types are: majorVersion.x, majorVersion.minorVersion.x, majorVersion.minorVersion.patchVersion. More details: Only explicit versions and accepted, such as: 2.2.301. Version: 6.0.x is not valid. bir hata iletisi alırsanız ve kullanıyorsanızglobal.json, içindeki global.jsonöğesini sdk.version denetleyin.

hakkında global.jsondaha fazla bilgi için bkz. Kullanılacak .NET sürümünü seçme.

workingDirectory - Çalışma Dizini
string. İsteğe bağlı. when useGlobalJson = truekullanın.

kullanırken useGlobalJsondosyaların aranacağı yolu global.json belirtir. Değer boşsa, system.DefaultWorkingDirectory kök yol olarak kabul edilir.

version - Sürüm
string. İsteğe bağlı. when useGlobalJson = false || packageType = runtimekullanın.

Yüklenecek .NET Core SDK veya çalışma zamanının sürümünü belirtir. Sürüm değeri biçimleri örneklerle gösterilir:

• 2.x: Belirtilen ana sürüm 2olan en son SDK'yı veya çalışma zamanını yükler.
• 3.1.x: Belirtilen ana ve ikincil sürümleri 31ve ile en son SDK'yı veya çalışma zamanını yükler.
• 3.1.402: Belirtilen SDK veya çalışma zamanı sürümünü yükler. 3.1.402

SDK veya çalışma zamanı yüklemelerinin sürüm değerleri dosyasındadır releases.json . Birincil/ikincil sürümün bağlantısı releases.jsonreleases-index dosyasındadır. Örneğin, sürüm 3.1 için releases.json dosyasının bağlantısı.

vsVersion - Uyumlu Visual Studio sürümü
string.

İlgili .NET Core SDK yüklemesi için uyumlu bir Visual Studio sürümü belirtir. Değerin, ana sürüm, 16.6.4ikincil sürüm ve düzeltme eki numarası içeren gibi tam bir sürüm numarası olması gerekir.

Dize için kullanılan version SDK veya çalışma zamanı yüklemelerinin sürüm değerleri dosyasındadır releases.json . Birincil/ikincil sürümün bağlantısı releases.jsonreleases-index dosyasındadır. Örneğin, sürüm 3.1 için releases.json dosyasının bağlantısı.

includePreviewVersions - Önizleme Sürümlerini Dahil Et
boolean. İsteğe bağlı. when useGlobalJson = false || packageType = runtimekullanın. Varsayılan değer: false.

olarak ayarlanırsa true, görev veya araması gibi 2.2.x3.1.xen son çalışma zamanı/SDK sürümlerini ararken önizleme sürümlerini içerir. Gibi 3.0.100-preview3-010431tam bir sürüm belirtirseniz bu ayar yoksayılır.

installationPath - .Net Core Yükleme Yolu
string. Varsayılan değer: $(Agent.ToolsDirectory)/dotnet.

.NET Core SDK'sının/Çalışma Zamanının nereye yüklenmesi gerektiğini belirtir. Farklı yolların üzerinde aşağıdaki etkisi olabilir. NET'in davranışı.

• $(Agent.ToolsDirectory): Bu dizin işlem hatları arasında temizlenmediği için bu yol kullanıldığında yükleme aracıda önbelleğe alınır. Aracıda çalışan tüm işlem hatlarının önceden yüklenmiş sürümlere erişimi vardır.
• $(Agent.TempDirectory): Bu yolun kullanılması, her işlem hattından sonra bu klasör temizlendiğinden işlem hattının önbelleğe alınmış bir .NET Core sürümünü kullanmamasını sağlar.
• Başka bir yol: Aracı işleminin yola erişimi varsa herhangi bir yolu kullanabilirsiniz. Bu, makinenin durumunu değiştirir ve üzerinde çalışan tüm işlemleri etkiler.

Not

.NET ana bilgisayarının sürümleri nasıl arayabileceğini yapılandırmak için Çok Düzeyli Arama ayarını performMultiLevelLookupkullanabilirsiniz.

performMultiLevelLookup - Çok Düzeyli Arama Gerçekleştirme
boolean. Varsayılan değer: false.

Uygun bir paylaşılan çerçeveyi ararken .NET ana bilgisayar işleminin davranışını yapılandırılır. Değerler şunlardır:

• false: Konak işlemi yalnızca görev tarafından belirtilen klasörde bulunan sürümleri arar.
• true: Konak işlemi, çok düzeyli aramayı kullanarak önceden tanımlanmış genel konumlarda arama yapacaktır. Varsayılan genel konumlar şunlardır:
  • C:\Program Files\dotnet (64 bit işlemler)
  • C:\Program Files (x86)\dotnet (32 bit işlemler)

Çok düzeyli SharedFX araması hakkında daha fazla bilgi edinin.

Not

performMultiLevelLookup yalnızca Windows tabanlı aracılar için geçerlidir.

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

Yok.

Açıklamalar

.NET Core Kullan görevi İnternet'ten veya araçlar önbelleğinden belirli bir .NET Core sürümünü alır ve Azure Pipelines Aracısı'nın (barındırılan veya özel) PATH'sine ekler. bu görevi, DotNetCoreCLI@2 gibi sonraki görevlerde kullanılan .NET Core sürümünü değiştirmek için kullanın. Bu görevi derleme tanımında DotNetCoreCLI@2 önce eklemek, uygulamanızı oluşturma, test etme ve yayımlama sırasında sürümün kullanılabilir olmasını sağlar.

Araç yükleyicisi yaklaşımı, aracı güncelleştirme döngülerinden ayrıştırmanıza da olanak tanır. Aradığınız .NET Core sürümü Azure Pipelines aracısında (Barındırılan veya Özel) eksikse, aracıya doğru sürümü yüklemek için bu görevi kullanabilirsiniz.

Gereksinimler

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme, Klasik sürüm
Üzerinde çalıştırılır	Agent, DeploymentGroup
Talep	Hiçbiri
Özellikler	Bu görevi çalıştırmak, aynı işteki sonraki görevler için aşağıdaki talepleri karşılar: DotNetCore
Komut kısıtlamaları	Herhangi biri
Ayarlanabilir değişkenler	Herhangi biri
Aracı sürümü	2.144.0 veya üzeri
Görev kategorisi	Araç