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.

Sintaks

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

Input

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

Menentukan apakah hanya menginstal Runtime atau SDK lengkap.

version - Versi
string. Wajib diisi. Nilai default: 2.2.x.

Menentukan versi .NET Core SDK atau Runtime yang akan diinstal.

Gunakan format berikut untuk menentukan versi:

• 2.x: Menginstal yang terbaru dalam versi utama.
• 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 releases-index.

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.

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 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 .NET core yang di-cache karena folder ini dibersihkan setelah setiap alur.
• Jalur lain: Anda dapat mengonfigurasi jalur lain, mengingat proses agen memiliki akses ke jalur. 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 defaultnya adalah:

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

Untuk informasi selengkapnya, lihat Pencarian SharedFX multi-tingkat.

Opsi kontrol tugas

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

Variabel output

Tidak ada.

Keterangan

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 yang terbaru dalam versi minor/utama.
• Batasi pencarian Multi-tingkat.

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	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	Semua versi agen yang didukung.
Kategori tugas	Alat