UseDotNet@2 - Gunakan tugas dotnet v2

Gunakan tugas ini untuk memperoleh versi tertentu dari .NET Core SDK dari internet atau cache lokal dan menambahkannya ke PATH. Gunakan tugas ini untuk mengubah versi .NET Core yang digunakan dalam tugas berikutnya. Tugas ini juga menyediakan dukungan proksi.

Sintaks

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

Input

packageType - Paket yang akan diinstal
string. Nilai yang diizinkan: runtime, sdk (SDK (berisi runtime)). Nilai default: sdk.

Menentukan apakah hanya menginstal runtime .NET atau SDK.

useGlobalJson - Menggunakan json global
boolean. Pilihan. Gunakan saat packageType = sdk. Nilai default: false.

Menginstal semua SDK dari global.json file. File-file ini dicari dari system.DefaultWorkingDirectory. Anda dapat mengubah jalur akar pencarian dengan mengatur input direktori kerja.

Format 6.x dan 6.1.x (menggunakan .x sebagai kartubebas) yang dijelaskan dalam UseDotNet@2.version input adalah untuk digunakan dalam version input dalam tugas, bukan sdk.version parameter di global.json.

Jika Anda menerima pesan kesalahan seperti ##[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. dan Anda menggunakan global.json, periksa sdk.version di Anda global.json.

Untuk informasi selengkapnya tentang global.json, lihat Memilih versi .NET yang akan digunakan.

workingDirectory - Direktori Kerja
string. Pilihan. Gunakan saat useGlobalJson = true.

Menentukan jalur dari mana global.json file harus dicari saat menggunakan useGlobalJson. Jika nilai kosong, system.DefaultWorkingDirectory akan dianggap sebagai jalur akar.

version - Versi
string. Opsional. Gunakan saat useGlobalJson = false || packageType = runtime.

Menentukan versi .NET Core SDK atau runtime yang akan diinstal. Format nilai versi ditampilkan dengan contoh:

• 2.x: Menginstal SDK atau runtime terbaru dengan versi utama yang ditentukan, 2.
• 3.1.x: Menginstal SDK atau runtime terbaru dengan versi utama dan minor yang ditentukan, 3 dan 1.
• 3.1.402: Menginstal SDK atau versi runtime yang ditentukan, 3.1.402.

Nilai versi untuk SDK atau penginstalan runtime berada dalam releases.json file . Tautan ke releases.json versi utama/minor ada dalam file releases-index . Misalnya, tautan ke file releases.json untuk versi 3.1.

vsVersion - Versi Visual Studio yang kompatibel
string.

Menentukan versi Visual Studio yang kompatibel untuk penginstalan .NET Core SDK yang sesuai. Nilai harus berupa nomor versi lengkap, seperti 16.6.4, yang berisi versi utama, versi minor, dan nomor patch.

Nilai versi untuk SDK atau penginstalan runtime, yang digunakan untuk version string, ada dalam releases.json file . Tautan ke releases.json versi utama/minor ada dalam file releases-index . Misalnya, tautan ke file releases.json untuk versi 3.1.

includePreviewVersions - Sertakan Versi Pratinjau
boolean. Pilihan. Gunakan saat useGlobalJson = false || packageType = runtime. Nilai default: false.

Jika diatur ke true, menyertakan versi pratinjau saat tugas mencari versi runtime/SDK terbaru, seperti mencari 2.2.x atau 3.1.x. Pengaturan ini diabaikan jika Anda menentukan versi yang tepat, seperti 3.0.100-preview3-010431.

installationPath - Jalur untuk menginstal .Net Core
string. Nilai default: $(Agent.ToolsDirectory)/dotnet.

Menentukan di mana .NET Core SDK/Runtime harus diinstal. Jalur yang berbeda dapat berdampak berikut pada . Perilaku NET.

• $(Agent.ToolsDirectory): Menggunakan jalur ini menyimpan penginstalan pada agen, karena direktori ini tidak dibersihkan di seluruh alur. Semua alur yang berjalan pada agen memiliki akses ke versi yang diinstal sebelumnya.
• $(Agent.TempDirectory): Menggunakan jalur ini memastikan bahwa alur tidak menggunakan versi cache .NET Core, karena folder ini dibersihkan setelah setiap alur.
• Jalur lain: Anda dapat menggunakan jalur apa pun jika proses agen memiliki akses ke jalur. Ini akan mengubah status komputer dan berdampak pada semua proses yang berjalan di atasnya.

Catatan

Anda dapat menggunakan pengaturan Pencarian Multi-Tingkat , performMultiLevelLookup, untuk mengonfigurasi cara host .NET mencari versi.

performMultiLevelLookup - Melakukan Pencarian Multi-Tingkat
boolean. Nilai default: false.

Mengonfigurasi perilaku proses host .NET saat mencari kerangka kerja bersama yang sesuai. Nilainya adalah:

• false: Proses host hanya mencari versi yang ada di folder yang ditentukan oleh tugas.
• true: Proses host akan mencari di lokasi global yang telah ditentukan sebelumnya menggunakan pencarian multi-tingkat. Lokasi global default adalah:
  • C:\Program Files\dotnet (Proses 64-bit)
  • C:\Program Files (x86)\dotnet (proses 32-bit)

Pelajari selengkapnya tentang pencarian SharedFX multi-level.

Catatan

performMultiLevelLookup hanya berlaku untuk agen berbasis Windows.

Opsi kontrol tugas

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

Variabel output

Tidak ada.

Keterangan

Tugas Gunakan .NET Core memperoleh versi .NET Core tertentu dari internet atau cache alat dan menambahkannya ke JALUR Agen Azure Pipelines (dihosting atau privat). Gunakan tugas ini untuk mengubah versi .NET Core yang digunakan dalam tugas berikutnya seperti DotNetCoreCLI@2. Menambahkan tugas ini sebelum DotNetCoreCLI@2 dalam definisi build memastikan bahwa versi akan tersedia pada saat membangun, menguji, dan menerbitkan aplikasi Anda.

Pendekatan alat penginstal juga memungkinkan Anda untuk memisahkan dari siklus pembaruan agen. Jika versi .NET Core yang Anda cari hilang dari agen Azure Pipelines (Dihosting atau Privat), maka Anda dapat menggunakan tugas ini untuk menginstal versi yang tepat pada agen.

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik, Rilis klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Tidak ada
Kemampuan	Menjalankan tugas ini memenuhi tuntutan berikut untuk setiap tugas berikutnya dalam pekerjaan yang sama: DotNetCore
Pembatasan perintah	Any
Variabel yang dapat diatur	Any
Versi agen	2.144.0 atau lebih tinggi
Kategori tugas	Alat