Instal .NET di Windows

  • Artikel

Dalam artikel ini, Anda mempelajari cara menginstal .NET di Windows. .NET terdiri dari runtime dan SDK. Runtime digunakan untuk menjalankan aplikasi .NET dan mungkin disertakan dengan aplikasi. SDK digunakan untuk membuat aplikasi dan pustaka .NET. Runtime .NET selalu diinstal dengan SDK.

Versi terbaru .NET adalah 8.0.

Unduh .NET

Ada dua jenis rilis yang didukung: Rilis Dukungan Jangka Panjang (LTS) dan rilis Standard Term Support (STS). Kualitas semua rilis sama. Satu-satunya perbedaan adalah panjang dukungan. Rilis LTS mendapatkan dukungan dan patch gratis selama tiga tahun. Rilis STS mendapatkan dukungan dan patch gratis selama 18 bulan. Untuk informasi selengkapnya, lihat Kebijakan Dukungan .NET.

Tabel berikut mencantumkan status dukungan dari setiap versi .NET (dan .NET Core):

✔️ Didukung ❌Tidak didukung
8 (LTS) 5
7 (STS) 3.1
6 (LTS) 3.0
2.1
2.0
1.1
1.0

Instal dengan Pengelola Paket Windows (winget)

Anda dapat menginstal dan mengelola .NET melalui layanan Pengelola Paket Windows, menggunakan alat winget. Untuk informasi selengkapnya tentang cara menginstal dan menggunakan winget, lihat Menggunakan alat winget.

Jika Anda menginstal .NET system-wide, instal dengan hak istimewa administratif.

Pasang SDK

.NET SDK memungkinkan Anda mengembangkan aplikasi dengan .NET. Jika Anda menginstal .NET SDK, Anda tidak perlu menginstal runtime yang sesuai. Untuk menginstal .NET SDK, jalankan perintah berikut:

winget install Microsoft.DotNet.SDK.8

Menginstal runtime

Ada tiga runtime .NET berbeda yang dapat Anda instal, namun, Anda harus menginstal .NET Desktop Runtime dan ASP.NET Core Runtime untuk kompatibilitas maksimum dengan semua jenis aplikasi .NET. Tabel berikut ini menjelaskan apa yang disertakan dengan setiap runtime:

Menyertakan Runtime .NET Menyertakan Runtime Desktop .NET Termasuk ASP.NET Core Runtime
.NET Runtime Ya No Tidak
Runtime Desktop .NET Ya Ya Tidak
ASP.NET Core Runtime Tidak No Ya

Daftar berikut ini menyediakan detail tentang setiap runtime bersama dengan perintah winget untuk menginstalnya:

  • Runtime bahasa umum Desktop .NET

    Runtime ini mendukung Windows Presentation Foundation (WPF) dan aplikasi Formulir Windows yang dibangun dengan .NET. Ini tidak sama dengan .NET Framework, yang dilengkapi dengan Windows. Runtime ini mencakup .NET Runtime, tetapi tidak menyertakan ASP.NET Core Runtime, yang harus diinstal secara terpisah.

    winget install Microsoft.DotNet.DesktopRuntime.8

  • .NET Runtime

    Ini adalah runtime dasar, dan hanya berisi komponen yang diperlukan untuk menjalankan aplikasi konsol. Biasanya, Anda akan menginstal .NET Desktop Runtime dan ASP.NET Core Runtime alih-alih yang satu ini.

    winget install Microsoft.DotNet.Runtime.8

  • Runtime ASP.NET Core

    Runtime ini menjalankan aplikasi server web dan menyediakan banyak API terkait web. ASP.NET Core Runtime memungkinkan Anda menjalankan aplikasi yang dibuat dengan .NET yang tidak menyediakan runtime. Anda harus menginstal .NET Runtime selain runtime ini. Perintah berikut menginstal ASP.NET Core Runtime, Di terminal Anda, jalankan perintah berikut:

    winget install Microsoft.DotNet.AspNetCore.8

Anda dapat menginstal versi pratinjau runtime dengan mengganti nomor versi, seperti 6, dengan kata Preview. Contoh berikut menginstal rilis pratinjau .NET Desktop Runtime:

winget install Microsoft.DotNet.DesktopRuntime.Preview

Instal bersama Visual Studio Code

Visual Studio Code adalah editor kode sumber yang kuat dan ringan yang berjalan di desktop Anda. Visual Studio Code tersedia untuk Windows, macOS, dan Linux.

Meskipun Visual Studio Code tidak dilengkapi dengan alat penginstal .NET Core otomatis seperti yang dilakukan Visual Studio, menambahkan dukungan .NET Core sederhana.

  1. Unduh dan instal Visual Studio Code.
  2. Unduh dan instal .NET SDK.
  3. Instal ekstensi C# dari marketplace Visual Studio Code.

Ekstensi C# Untuk Visual Studio Code menyertakan .NET SDK terbaru, dan Anda tidak perlu menginstal runtime .NET apa pun secara terpisah.

Menginstal dengan Penginstal Windows

Ada tiga runtime .NET berbeda yang dapat Anda instal, namun, Anda harus menginstal .NET Desktop Runtime dan ASP.NET Core Runtime untuk kompatibilitas maksimum dengan semua jenis aplikasi .NET. Tabel berikut ini menjelaskan apa yang disertakan dengan setiap runtime:

Menyertakan Runtime .NET Menyertakan Runtime Desktop .NET Termasuk ASP.NET Core Runtime
.NET Runtime Ya No Tidak
Runtime Desktop .NET Ya Ya Tidak
ASP.NET Core Runtime Tidak No Ya

.NET SDK memungkinkan Anda membuat aplikasi .NET, dan menyertakan semua runtime.

Halaman unduhan untuk .NET menyediakan executable Penginstal Windows.

Jika Anda ingin menginstal .NET secara diam-diam, seperti di lingkungan produksi atau untuk mendukung integrasi berkelanjutan, gunakan sakelar berikut:

  • /install
    Menginstal .NET.

  • /quiet
    Mencegah UI dan perintah ditampilkan.

  • /norestart
    Menekan setiap upaya untuk memulai ulang.

dotnet-sdk-8.0.100-win-x64.exe /install /quiet /norestart

Untuk informasi selengkapnya, lihat Opsi Baris Perintah Penginstal Standar.

Tip

Alat penginstal mengembalikan kode keluar 0 untuk keberhasilan dan kode keluar 3010 untuk menunjukkan bahwa hidupkan ulang diperlukan. Nilai lain umumnya adalah kode kesalahan.

Menginstal dengan otomatisasi PowerShell

Skrip dotnet-install digunakan untuk otomatisasi CI dan penginstalan non-admin runtime. Anda dapat mengunduh skrip dari halaman referensi skrip dotnet-install.

Skrip default untuk menginstal versi dukungan jangka panjang (LTS) terbaru, yaitu .NET 8. Anda dapat memilih rilis tertentu dengan menentukan sakelar Channel . Sertakan sakelar Runtime untuk menginstal runtime. Jika tidak, skrip menginstal SDK.

Perintah berikut menginstal runtime Desktop dan ASP.NET Core untuk kompatibilitas maksimum.

dotnet-install.ps1 -Channel 8.0 -Runtime windowsdesktop
dotnet-install.ps1 -Channel 8.0 -Runtime aspnetcore

Instal SDK dengan menghilangkan sakelar -Runtime . Sakelar -Channel diatur dalam contoh ini ke STS, yang menginstal versi Dukungan Istilah Standar terbaru, yaitu .NET 7.

dotnet-install.ps1 -Channel STS

Menginstal dengan Visual Studio

Jika Anda menggunakan Visual Studio untuk mengembangkan aplikasi .NET, tabel berikut ini menjelaskan versi minimum Visual Studio yang diperlukan berdasarkan versi .NET SDK target.

Versi .NET SDK Versi Visual Studio
8 Visual Studio 2022 versi 17.8 atau yang lebih tinggi.
7 Visual Studio 2022 versi 17.4 atau yang lebih tinggi.
6 Visual Studio 2022 versi 17.0 atau yang lebih tinggi.
5 Visual Studio 2019 versi 16.8 atau yang lebih tinggi.
3.1 Visual Studio 2019 versi 16.4 atau yang lebih tinggi.
3.0 Visual Studio 2019 versi 16.3 atau yang lebih tinggi.
2.2 Visual Studio 2017 versi 15.9 atau yang lebih tinggi.
2.1 Visual Studio 2017 versi 15.7 atau yang lebih tinggi.

Jika Sudah menginstal Visual Studio, Anda dapat memeriksa versi Anda dengan langkah-langkah berikut.

  1. Buka Visual Studio.
  2. Pilih Bantuan>Tentang Microsoft Visual Studio.
  3. Baca nomor versi dari dialog Tentang .

Visual Studio dapat menginstal .NET SDK dan runtime terbaru.

Unduh Visual Studio.

Untuk informasi selengkapnya, lihat penerapan versi .NET SDK, MSBuild, dan Visual Studio.

Pilih beban kerja

Saat menginstal atau memodifikasi Visual Studio, pilih satu atau beberapa beban kerja berikut, tergantung pada jenis aplikasi yang Anda buat:

  • Beban kerja pengembangan lintas platform .NET Core di bagian Toolsets Lainnya.
  • Beban kerja ASP.NET dan pengembangan web di bagian Web & Cloud .
  • Beban kerja pengembangan Azure di bagian Web & Cloud.
  • Beban kerja pengembangan desktop .NET di bagian Desktop &Mobile.

Windows Visual Studio 2019 with .NET Core workload

Rilis yang didukung

Tabel berikut adalah daftar rilis .NET yang saat ini didukung dan versi Windows yang didukungnya. Versi ini tetap didukung sampai versi .NET mencapai akhir dukungan atau versi Windows mencapai akhir masa pakai.

Tanggal akhir layanan versi Windows 10 disegmentasi berdasarkan edisi. Hanya edisi Home, Pro, Pro Education, dan Pro for Workstations yang dipertimbangkan dalam tabel berikut. Periksa lembar fakta siklus hidup Windows untuk detail tertentu.

Tip

Simbol + mewakili versi minimum.

Sistem Operasi .NET 8 .NET 7 .NET 6
Windows 11 ✔️ ✔️ ✔️
Windows Server 2022 ✔️ ✔️ ✔️
Windows Server, Versi 1903 atau yang lebih baru ✔️ ✔️ ✔️
Windows 10, Versi 1607 atau yang lebih baru ✔️ ✔️ ✔️
Windows 8.1 ❌ ❌ ✔️
Windows 7 SP1 ESU ❌ ❌ ✔️
Server Windows 2019
Server Windows 2016
Windows Server 2012 R2
Windows Server 2012		 ✔️ ✔️ ✔️
Windows Server Core 2012 R2 ✔️ ✔️ ✔️
Windows Server Core 2012 ✔️ ✔️ ✔️
Nano Server, Versi 1809+ ✔️ ✔️ ✔️
Nano Server, Versi 1803 ❌ ❌ ❌

Untuk informasi selengkapnya tentang sistem operasi, distribusi, dan kebijakan siklus hidup yang didukung .NET 8, lihat Versi OS yang didukung .NET 8.

Rilis yang tidak didukung

Versi .NET ❌ berikut tidak lagi didukung:

  • .NET 5
  • .NET Core 3.1
  • .NET Core 3.0
  • .NET Core 2.2
  • .NET Core 2.1
  • .NET Core 2.0

Memverifikasi biner yang diunduh

Setelah mengunduh alat penginstal, verifikasi untuk memastikan bahwa file belum diubah atau rusak. Anda dapat memverifikasi checksum di komputer Anda lalu membandingkannya dengan apa yang dilaporkan di situs web unduhan.

Saat Anda mengunduh penginstal atau biner dari halaman unduhan resmi, checksum untuk file ditampilkan. Pilih tombol Salin untuk menyalin nilai checksum ke clipboard Anda.

The .NET download page with checksum

Anda dapat menggunakan PowerShell atau Command Prompt untuk memvalidasi checksum file yang telah Anda unduh. Misalnya, perintah berikut melaporkan checksum file dotnet-sdk-8.0.100-win-x64.exe :

> certutil -hashfile dotnet-sdk-8.0.100-win-x64.exe SHA512
SHA512 hash of dotnet-sdk-8.0.100-win-x64.exe:
248acec95b381e5302255310fb9396267fd74a4a2dc2c3a5989031969cb31f8270cbd14bda1bc0352ac90f8138bddad1a58e4af1e56cc4a1613b1cf2854b518e
CertUtil: -hashfile command completed successfully.

> (Get-FileHash .\dotnet-sdk-8.0.100-win-x64.exe -Algorithm SHA512).Hash
248acec95b381e5302255310fb9396267fd74a4a2dc2c3a5989031969cb31f8270cbd14bda1bc0352ac90f8138bddad1a58e4af1e56cc4a1613b1cf2854b518e

Bandingkan checksum dengan nilai yang disediakan oleh situs unduhan.

Menggunakan PowerShell dan file checksum untuk memvalidasi

Catatan rilis .NET berisi tautan ke file checksum yang dapat Anda gunakan untuk memvalidasi file yang diunduh. Langkah-langkah berikut menjelaskan cara mengunduh file checksum dan memvalidasi biner penginstalan .NET:

  1. Halaman catatan rilis untuk .NET 8 di GitHub di https://github.com/dotnet/core/tree/main/release-notes/8.0 berisi bagian bernama Rilis. Tabel di bagian tersebut menautkan ke file unduhan dan checksum untuk setiap rilis .NET 8:

    The github release notes version table for .NET

  2. Pilih tautan untuk versi .NET yang Anda unduh. Bagian sebelumnya menggunakan .NET SDK 8.0.100, yang ada dalam rilis .NET 8.0.0.

    Tip

    Jika Anda tidak yakin rilis .NET mana yang berisi file checksum Anda, jelajahi tautan hingga Anda menemukannya.

  3. Di halaman rilis, Anda dapat melihat versi .NET Runtime dan .NET SDK, dan tautan ke file checksum:

    The download table with checksums for .NET

  4. Salin tautan ke file checksum.

  5. Gunakan skrip berikut, tetapi ganti tautan untuk mengunduh file checksum yang sesuai:

    Invoke-WebRequest https://dotnetcli.blob.core.windows.net/dotnet/checksums/8.0.0-sha.txt -OutFile 8.0.0-sha.txt

  6. Dengan file checksum dan file rilis .NET yang diunduh ke direktori yang sama, cari file checksum untuk checksum unduhan .NET:

    Saat validasi lolos, Anda akan melihat True printed:

    > (Get-Content .\8.0.0-sha.txt | Select-String "dotnet-sdk-8.0.100-win-x64.exe").Line -like (Get-FileHash .\dotnet-sdk-8.0.100-win-x64.exe -Algorithm SHA512).Hash + "*"
True

    Jika Anda melihat Salah dicetak, file yang Anda unduh tidak valid dan tidak boleh digunakan.

Informasi runtime

Runtime digunakan untuk menjalankan aplikasi yang dibuat dengan .NET. Saat penulis aplikasi menerbitkan aplikasi, mereka dapat menyertakan runtime dengan aplikasi mereka. Jika mereka tidak menyertakan runtime, terserah pengguna untuk menginstal runtime.

Ada tiga runtime .NET berbeda yang dapat Anda instal, namun, Anda harus menginstal .NET Desktop Runtime dan ASP.NET Core Runtime untuk kompatibilitas maksimum dengan semua jenis aplikasi .NET. Tabel berikut ini menjelaskan apa yang disertakan dengan setiap runtime:

Menyertakan Runtime .NET Menyertakan Runtime Desktop .NET Termasuk ASP.NET Core Runtime
.NET Runtime Ya No Tidak
Runtime Desktop .NET Ya Ya Tidak
ASP.NET Core Runtime Tidak No Ya

Daftar berikut ini menyediakan detail tentang setiap runtime:

  • Desktop Runtime
    Menjalankan aplikasi desktop .NET WPF dan Formulir Windows untuk Windows. Termasuk runtime .NET.

  • ASP.NET Core Runtime
    Menjalankan aplikasi ASP.NET Core.

  • .NET Runtime
    Runtime ini adalah runtime paling sederhana dan tidak menyertakan runtime lainnya. Instal ASP.NET Core Runtime dan Desktop Runtime untuk kompatibilitas terbaik dengan aplikasi .NET.

Unduh .NET Runtime

Informasi SDK

SDK digunakan untuk membangun dan menerbitkan aplikasi dan pustaka .NET. Menginstal SDK mencakup ketiga runtime: ASP.NET Core, Desktop, dan .NET.

Unduh .NET SDK

PC Windows berbasis arm

Bagian berikut menjelaskan hal-hal yang harus Anda pertimbangkan saat menginstal .NET pada PC Windows berbasis Arm.

Apa yang didukung

Tabel berikut ini menjelaskan versi .NET mana yang didukung pada PC Windows berbasis Arm:

Versi .NET Arsitektur SDK Runtime Konflik jalur
8 Arm64 Ya Ya Tidak
8 x64 Ya Ya Tidak
7 Arm64 Ya Ya Tidak
7 x64 Ya Ya Tidak
6 Arm64 Ya Ya Tidak
6 x64 Ya Ya Tidak
5 Arm64 Ya Ya Ya
5 x64 Tidak Ya Ya

Versi x64 dan Arm64 dari .NET SDK ada secara independen satu sama lain. Jika versi baru dirilis, setiap penginstalan arsitektur perlu ditingkatkan.

Perbedaan jalur

Pada PC Windows berbasis Arm, semua versi Arm64 .NET diinstal ke folder C:\Program Files\dotnet\ normal. Namun, versi x64 dari .NET SDK diinstal ke folder C:\Program Files\dotnet\x64\ .

Konflik jalur

X64 .NET SDK diinstal ke direktorinya sendiri, seperti yang dijelaskan di bagian sebelumnya. Ini memungkinkan versi Arm64 dan x64 dari .NET SDK ada pada komputer yang sama. Namun, x64 SDK apa pun sebelum 6 tidak didukung dan diinstal ke lokasi yang sama dengan versi Arm64, folder C:\Program Files\dotnet\. Jika Anda ingin menginstal x64 SDK yang tidak didukung, Anda harus menghapus instalan versi Arm64 terlebih dahulu. Sebaliknya juga benar, Anda harus menghapus instalan X64 SDK yang tidak didukung untuk menginstal versi Arm64.

Variabel jalur

Variabel lingkungan yang menambahkan .NET ke jalur sistem, seperti PATH variabel, mungkin perlu diubah jika Anda menginstal versi x64 dan Arm64 dari .NET SDK. Selain itu, beberapa alat mengandalkan DOTNET_ROOT variabel lingkungan, yang juga perlu diperbarui untuk menunjuk ke folder penginstalan .NET SDK yang sesuai.

Dependensi

Versi Windows berikut didukung dengan .NET 8:

Catatan

Simbol + mewakili versi minimum.

OS Versi Arsitektur
Windows 11 22000+ x64, x86, Arm64
Klien Windows 10 1607+ x64, x86, Arm64
Windows Server 2012+ x64, x86
Windows Server Core 2012+ x64, x86
Nano Server 1809+ x64

Untuk informasi selengkapnya tentang sistem operasi, distribusi, dan kebijakan siklus hidup yang didukung .NET 8, lihat Versi OS yang didukung .NET 8.

Windows 7 / 8.1 / Server 2012

Dependensi lainnya diperlukan jika Anda menginstal .NET SDK atau runtime pada versi Windows berikut:

Sistem Operasi Prasyarat
Windows 7 SP1 ESU - Microsoft Visual C++ 2015-2019 Redistributable 64-bit / 32-bit
- KB3063858 64-bit / 32-bit
- Microsoft Root Certificate Authority 2011 (hanya penginstal offline.NET Core 2.1)
Windows 8.1 Microsoft Visual C++ 2015-2019 Redistributable 64-bit / 32-bit
Windows Server 2012 Microsoft Visual C++ 2015-2019 Redistributable 64-bit / 32-bit
Windows Server 2012 R2 Microsoft Visual C++ 2015-2019 Redistributable 64-bit / 32-bit

Persyaratan sebelumnya juga diperlukan jika Anda menerima kesalahan yang terkait dengan salah satu dll berikut:

  • api-ms-win-crt-runtime-l1-1-0.dll
  • api-ms-win-cor-timezone-l1-1-0.dll
  • hostfxr.dll

Docker

Kontainer menyediakan cara ringan untuk mengisolasi aplikasi Anda dari sistem host lainnya. Kontainer pada komputer yang sama hanya berbagi kernel dan menggunakan sumber daya yang diberikan kepada aplikasi Anda.

.NET dapat berjalan dalam kontainer Docker. Gambar .NET Docker resmi diterbitkan ke Microsoft Container Registry (MCR) dan dapat ditemukan di repositori Microsoft .NET Docker Hub. Setiap repositori berisi gambar untuk kombinasi yang berbeda dari .NET (SDK atau Runtime) dan OS yang dapat Anda gunakan.

Microsoft menyediakan gambar yang disesuaikan untuk skenario tertentu. Misalnya, repositori ASP.NET Core menyediakan gambar yang dibuat untuk menjalankan aplikasi ASP.NET Core dalam produksi.

Untuk informasi selengkapnya tentang menggunakan .NET dalam kontainer Docker, lihat Pengenalan .NET dan Docker dan Sampel.

Pemecahan Masalah

Setelah menginstal .NET SDK, Anda mungkin mengalami masalah saat mencoba menjalankan perintah .NET CLI. Bagian ini mengumpulkan masalah umum tersebut dan memberikan solusi.

Tidak ada .NET SDK yang ditemukan

Kemungkinan besar Anda menginstal versi x86 (32-bit) dan x64 (64-bit) dari .NET SDK. Ini menyebabkan konflik karena saat Anda menjalankan dotnet perintah, perintah akan diselesaikan ke versi x86 ketika harus diselesaikan ke versi x64. Ini biasanya diperbaiki dengan menyesuaikan %PATH% variabel untuk menyelesaikan versi x64 terlebih dahulu.

  1. Verifikasi bahwa Anda memiliki kedua versi yang diinstal dengan menjalankan where.exe dotnet perintah . Jika demikian, Anda akan melihat entri untuk folder Program Files\ dan Program Files (x86)\ . Jika folder Program Files (x86)\ adalah yang pertama, seperti yang ditunjukkan oleh contoh berikut, itu salah dan Anda harus melanjutkan ke langkah berikutnya.

    > where.exe dotnet
C:\Program Files (x86)\dotnet\dotnet.exe
C:\Program Files\dotnet\dotnet.exe

    Jika sudah benar dan Program Files\ adalah yang pertama, Anda tidak memiliki masalah yang dibahas bagian ini dan Anda harus membuat masalah permintaan bantuan .NET di GitHub

  2. Tekan tombol Windows dan ketik "Edit variabel lingkungan sistem" ke dalam pencarian. Pilih Edit variabel lingkungan sistem.

    Windows start menu with edit environment variable

  3. Jendela Properti Sistem terbuka hingga Tab Tingkat Lanjut. Pilih Variabel Lingkungan.

    The Windows system properties panel open.

  4. Pada jendela Variabel Lingkungan, di bawah grup Variabel sistem, pilih baris Jalur* lalu pilih tombol Edit .

    The environment variables window with user and system variables.

  5. Gunakan tombol Pindah ke Atas dan Pindah ke Bawah untuk memindahkan entri C:\Program Files\dotnet\ di atas C:\Program Files (x86)\dotnet\.

    The environment variables list for the system.

Membangun aplikasi lebih lambat dari yang diharapkan

Pastikan Smart App Control, fitur Windows, nonaktif. Kontrol Aplikasi Pintar tidak disarankan untuk diaktifkan pada komputer yang digunakan untuk pengembangan. Pengaturan apa pun selain "nonaktif" mungkin berdampak negatif pada performa SDK.

Langkah berikutnya