DotNetCoreInstaller@1 - tugas .NET Core SDK/runtime installer v1

Gunakan tugas ini untuk memperoleh versi tertentu dari .NET Core SDK dari internet atau cache lokal dan menambahkannya ke PATH.

Penting

Tugas ini tidak digunakan lagi dan akan dihentikan 31 Januari 2024. Gunakan UseDotNet@2.

Sintaksis

# .NET Core SDK/runtime installer v1
# Acquire a specific version of the .NET Core SDK from the internet or local cache and add it to the PATH.
- task: DotNetCoreInstaller@1
  inputs:
    packageType: 'sdk' # 'runtime' | 'sdk'. Required. Package to install. Default: sdk.
    version: '2.2.x' # string. Required. Version. Default: 2.2.x.
    #includePreviewVersions: false # boolean. Include Preview Versions. Default: false.
  # Advanced
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.

Masukan

Paket packageType - untuk menginstal
string. Dibutuhkan. Nilai yang diizinkan: runtime (Hanya Runtime), sdk (SDK (berisi runtime)). Nilai default: sdk.

Menentukan apakah hanya menginstal Runtime atau SDK lengkap.

version - Versi
string. Dibutuhkan. Nilai default: 2.2.x.

Menentukan versi .NET Core SDK atau Runtime untuk diinstal.

Gunakan format berikut untuk menentukan versi:

• 2.x: Menginstal versi utama terbaru.
• 2.2.x: Menginstal versi utama dan minor terbaru.
• 2.2.104: Menginstal versi yang tepat.

Temukan nilai version untuk menginstal SDK/Runtime dalam file indeks rilis .

includePreviewVersions - Sertakan Versi Pratinjau
boolean. Nilai default: false.

Menentukan apakah Anda ingin versi pratinjau disertakan saat mencari versi terbaru. 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): Ini menentukan versi yang akan di-cache pada agen karena direktori ini tidak dibersihkan di seluruh alur. Semua alur yang berjalan pada agen, akan memiliki akses ke versi yang diinstal sebelumnya menggunakan agen.
• $(Agent.TempDirectory): Ini dapat memastikan bahwa alur tidak menggunakan versi inti .NET yang di-cache karena folder ini dibersihkan setelah setiap alur.
• Jalur lain: Anda dapat mengonfigurasi jalur lain, mengingat proses agen memiliki akses ke jalur tersebut. Ini akan mengubah status komputer dan berdampak pada semua proses yang berjalan di atasnya.

Anda juga dapat mengonfigurasi pengaturan Pencarian Multi-Tingkat. Pengaturan ini dapat mengonfigurasi host .NET untuk memeriksa versi yang sesuai.

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

Input ini hanya berlaku untuk agen berbasis Windows. Input ini mengonfigurasi perilaku proses host .NET untuk mencari kerangka kerja bersama yang sesuai. False berarti bahwa hanya versi yang ada di folder yang ditentukan dalam tugas ini yang akan dilihat oleh proses host. True berarti bahwa host akan mencoba untuk melihat di lokasi global yang telah ditentukan sebelumnya menggunakan Pencarian Multi-tingkat.

Untuk Windows, lokasi global default adalah:

• C:\Program Files\dotnet (proses 64-bit)
• C:\Program Files (x86)\dotnet (proses 32-bit)

Untuk informasi selengkapnya, lihat Pencarian SharedFX Multi-level.

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.

Komentar

Tugas ini tidak digunakan lagi. Gunakan @UseDotNet2.

Apa yang baru dalam versi tugas ini.

• Dukungan untuk menginstal beberapa versi secara berdampingan.
• Dukungan untuk pola dalam versi untuk mengambil versi minor/utama terbaru.
• Batasi pencarian Multi-tingkat.

Persyaratan

Persyaratan	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	Apapun
variabel yang Dapat Diatur	Apapun
Versi agen	Semua versi agen yang didukung.
Kategori tugas	Alat