UseDotNet@2 - Menggunakan 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.

Sintaksis

# 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.
    #requestTimeout: '300000' # string. Set timeout for package download request. Default: 300000.
  # 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

Paket packageType - untuk menginstal
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. Fakultatif. Gunakan saat packageType = sdk. Nilai default: false.

Menginstal semua SDK dari file global.json. 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 input UseDotNet@2.version adalah untuk digunakan dalam input version dalam tugas, bukan parameter sdk.version 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 global.jsonAnda.

Untuk informasi selengkapnya tentang global.json, lihat Pilih versi .NET untuk menggunakan.

Direktori Kerja
string. Fakultatif. Gunakan saat useGlobalJson = true.

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

version - Versi
string. Fakultatif. 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 file releases.json. Tautan ke versi utama/minor ada dalam file indeks rilis . Misalnya, tautan ke file releases.json untuk versi 3.1.

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 string version, ada dalam file releases.json. Tautan ke versi utama/minor ada dalam file indeks rilis . Misalnya, tautan ke file releases.json untuk versi 3.1.

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

Jika diatur ke true, sertakan 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.

jalur installationPath - 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.

Nota

Anda dapat menggunakan pengaturan Pencarian Multi-Tingkat , , 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-tingkat.

Nota

performMultiLevelLookup hanya berlaku untuk agen berbasis Windows.

requestTimeout - Mengatur batas waktu untuk permintaan unduhan paket
string. Nilai default: 300000.

Berikan nilai batas waktu untuk permintaan HTTP yang dilakukan tugas untuk mendapatkan paket .NET. Nilainya dalam milidetik. Defaultnya adalah 300000 milidetik (5 menit). Tidak boleh lebih dari 600000 milidetik (10 menit).

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

Tugas Gunakan .NET Core memperoleh versi tertentu dari .NET Core 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 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

Syarat	Deskripsi
Jenis alur	YAML, Build klasik, Rilis klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Tidak
Kemampuan	Menjalankan tugas ini memenuhi tuntutan berikut untuk tugas berikutnya dalam pekerjaan yang sama: DotNetCore
pembatasan Perintah	Apa pun
variabel yang Dapat Diatur	Apa pun
Versi agen	2.144.0 atau lebih tinggi
Kategori tugas	Alat