Tabel berikut mencantumkan rilis .NET yang didukung, dan macOS mana yang didukung. Versi ini tetap didukung hingga versi .NET mencapai akhir dukungan atau versi macOS tidak lagi didukung.
Versi macOS
.NET
macOS 15 "Sequoia"
9.0, 8.0
macOS 14 "Sonoma"
9.0, 8.0
macOS 13 "Ventura"
9.0, 8.0
Versi .NET ❌ berikut tidak lagi didukung:
.NET 7
.NET 6
.NET 5
.NET Core 3.1
.NET Core 3.0
.NET Core 2.2
.NET Core 2.1
.NET Core 2.0
Runtime atau SDK
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 yang benar.
Ada dua runtime yang dapat Anda instal di macOS, dan keduanya disertakan dengan SDK.
ASP.NET Core Runtime
Menjalankan aplikasi ASP.NET Core. Termasuk runtime .NET. Tidak tersedia sebagai alat penginstal.
.NET Runtime
Ini menjalankan aplikasi .NET normal, tetapi bukan aplikasi khusus, seperti aplikasi yang dibangun di ASP.NET Core.
SDK digunakan untuk membangun dan menerbitkan aplikasi dan pustaka .NET. SDK terbaru mendukung pembuatan aplikasi untuk versi .NET sebelumnya. Dalam keadaan normal, Anda hanya perlu menginstal SDK terbaru.
Menginstal SDK mencakup .NET Runtime standar dan ASP.NET Core Runtime. Misalnya, jika Anda telah menginstal .NET SDK 9.0, maka .NET Runtime 9.0 dan ASP.NET Core 9.0 Runtime keduanya diinstal. Namun, versi runtime lainnya tidak akan diinstal dengan SDK dan akan mengharuskan Anda menginstalnya secara terpisah.
Pilih cara menginstal .NET
Ada berbagai cara untuk menginstal .NET, dan beberapa produk mungkin mengelola versi .NET mereka sendiri. Jika Anda menginstal .NET melalui perangkat lunak yang mengelola versi .NET-nya sendiri, mungkin tidak diaktifkan di seluruh sistem. Pastikan Anda memahami implikasi penginstalan .NET melalui perangkat lunak lain.
Jika Anda tidak yakin metode mana yang harus Anda pilih setelah meninjau daftar di bagian berikut, Anda mungkin ingin menggunakan paket Penginstal .NET.
Instal ekstensi C# Dev Kit untuk Visual Studio Code untuk mengembangkan aplikasi .NET. Ekstensi dapat menggunakan SDK yang sudah diinstal atau menginstalnya untuk Anda.
Pilih tautan ke versi .NET yang ingin Anda instal, seperti .NET 8.0.
Tautan ini membawa Anda ke halaman dengan tautan untuk mengunduh versi .NET tersebut
Jika Anda akan menginstal SDK, pilih versi .NET terbaru. SDK mendukung pembuatan aplikasi untuk versi .NET sebelumnya.
Tip
Jika Anda tidak yakin versi mana yang akan diunduh, pilih versi yang ditandai terbaru.
Halaman ini menyajikan tautan unduhan untuk SDK dan Runtime. Di sini Anda mengunduh .NET SDK atau .NET Runtime.
Ada dua bagian yang disorot pada gambar sebelumnya. Jika Anda mengunduh SDK, lihat bagian 1. Untuk .NET Runtime, lihat bagian 2.
Bagian 1 (SDK)
Bagian ini adalah area unduhan SDK. Di bawah kolom Penginstal untuk baris macOS , dua arsitektur dicantumkan: Arm64 dan x64.
Jika Anda menjalankan prosesor Apple, seperti M1 atau M3 Pro, pilih Arm64.
Jika Anda menjalankan prosesor Intel, pilih x64.
Bagian 2 (Runtime)
Bagian ini berisi unduhan runtime. Perhatikan bahwa tautan untuk kolom Penginstal di baris macOS kosong! Bagian ini kosong karena ASP.NET Core Runtime, hanya disediakan di SDK, atau melalui penginstalan biner.
Gulir lebih jauh ke bawah untuk menemukan .NET Runtime standar untuk diunduh.
Jika Anda menjalankan prosesor Apple, seperti M1 atau M3 Pro, pilih Arm64.
Jika Anda menjalankan prosesor Intel, pilih x64.
Setelah unduhan selesai, buka.
Ikuti langkah-langkah di Alat Penginstal.
Instal .NET secara manual
Sebagai alternatif untuk penginstal macOS, Anda dapat mengunduh dan menginstal SDK dan runtime secara manual. Penginstalan manual biasanya dilakukan sebagai otomatisasi bagian dalam skenario integrasi berkelanjutan. Pengembang dan pengguna biasanya ingin menggunakan alat penginstal.
Tip
Gunakan skrip install-dotnet.sh untuk melakukan langkah-langkah ini secara otomatis.
Pilih tautan ke versi .NET yang ingin Anda instal, seperti .NET 8.0.
Tautan ini membawa Anda ke halaman dengan tautan untuk mengunduh versi .NET tersebut
Jika Anda akan menginstal SDK, pilih versi .NET terbaru. SDK mendukung pembuatan aplikasi untuk versi .NET sebelumnya.
Tip
Jika Anda tidak yakin versi mana yang akan diunduh, pilih versi yang ditandai terbaru.
Pilih tautan ke SDK atau Runtime yang ingin Anda instal. Cari kolom Biner di baris macOS .
Jika Anda menjalankan prosesor Apple, seperti M1 atau M3 Pro, pilih Arm64.
Jika Anda menjalankan prosesor Intel, pilih x64.
Buka terminal dan navigasikan ke tempat biner .NET diunduh.
Ekstrak tarball ke tempat Anda ingin .NET pada sistem Anda. Contoh berikut menggunakan direktori ~/Applications/.dotnetHOME .
Bash
mkdir -p ~/Applications/.dotnet
tar -xf "dotnet-sdk-9.0.100-rc.2.24474.11-osx-arm64.tar" -C ~/Applications/.dotnet/
Uji bahwa .NET bekerja dengan mengubah direktori ke tempat .NET diinstal, dan jalankan dotnet --info perintah:
Bash
chdir ~/Applications/.dotnet/
./dotnet --info
Menginstal .NET dengan skrip
Skrip dotnet-install digunakan untuk otomatisasi dan penginstalan runtime yang tidak ditingkatkan. Anda dapat mengunduh versi terbaru skrip dari https://dot.net/v1/dotnet-install.sh.
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.
Tip
Perintah ini disediakan cuplikan skrip di akhir prosedur ini.
Buka terminal.
Navigasi ke folder tempat Anda ingin mengunduh skrip, seperti ~/Unduhan.
Jika Anda tidak memiliki wget perintah, instal dengan Brew
Bash
brew install wget
Jalankan perintah berikut untuk mengunduh skrip:
Bash
wget https://dot.net/v1/dotnet-install.sh
Memberikan izin eksekusi skrip
Bash
chmod +x dotnet-install.sh
Jalankan skrip untuk menginstal .NET.
Skrip default untuk menginstal SDK terbaru ke ~/.dotnet direktori.
Bash
./dotnet-install.sh
Berikut adalah semua perintah sebagai skrip bash tunggal:
Uji .NET dengan menavigasi ke ~/.dotnet folder dan menjalankan dotnet --info perintah:
Bash
chdir ~/.dotnet
./dotnet --info
Penting
Beberapa program mungkin menggunakan variabel lingkungan untuk menemukan .NET pada sistem Anda, dan menggunakan dotnet perintah mungkin tidak berfungsi saat membuka terminal baru. Untuk bantuan mengatasi masalah ini, lihat Bagian membuat .NET tersedia di seluruh sistem.
Menginstal .NET untuk Visual Studio Code
Visual Studio Code adalah editor kode sumber yang kuat dan ringan yang berjalan di desktop Anda. Visual Studio Code dapat menggunakan SDK yang sudah diinstal pada sistem Anda. Selain itu, ekstensi C# Dev Kit akan menginstal .NET untuk Anda jika belum diinstal.
Setelah mengunduh penginstal atau rilis biner, 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 file dari halaman unduhan resmi, checksum untuk file ditampilkan dalam kotak teks. Pilih tombol Salin untuk menyalin nilai checksum ke clipboard Anda.
sha512sum Gunakan perintah untuk mencetak checksum file yang telah Anda unduh. Misalnya, perintah berikut melaporkan checksum file dotnet-sdk-8.0.100-linux-x64.tar.gz :
Bandingkan checksum dengan nilai yang disediakan oleh situs unduhan.
Penting
Meskipun file Linux ditampilkan dalam contoh ini, informasi ini sama-sama berlaku untuk macOS.
Menggunakan 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:
Dengan file checksum dan file rilis .NET yang diunduh ke direktori yang sama, gunakan sha512sum -c {file} --ignore-missing perintah untuk memvalidasi file yang diunduh.
Saat validasi lolos, Anda akan melihat file yang dicetak dengan status OK :
Bash
$ sha512sum -c 8.0.0-sha.txt --ignore-missing
dotnet-sdk-8.0.100-linux-x64.tar.gz: OK
Jika Anda melihat file ditandai sebagai GAGAL, file yang Anda unduh tidak valid dan tidak boleh digunakan.
Bash
$ sha512sum -c 8.0.0-sha.txt --ignore-missing
dotnet-sdk-8.0.100-linux-x64.tar.gz: FAILED
sha512sum: WARNING: 1 computed checksum did NOT match
sha512sum: 8.0.0-sha.txt: no file was verified
Mac berbasis arm
Bagian berikut menjelaskan hal-hal yang harus Anda pertimbangkan saat menginstal .NET pada Mac berbasis Arm.
Perbedaan jalur
Pada Mac berbasis Arm, semua versi Arm64 .NET diinstal ke folder /usr/local/share/dotnet/ normal. Namun, ketika Anda menginstal .NET SDK versi x64 , itu diinstal ke folder /usr/local/share/dotnet/x64/dotnet/ .
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.
Pemecahan Masalah
Bagian berikut ini tersedia untuk membantu memecahkan masalah:
Terkadang aplikasi di sistem Anda, termasuk terminal, perlu menemukan di mana .NET diinstal. Paket Penginstal macOS .NET harus secara otomatis mengonfigurasi sistem Anda. Namun, jika Anda menggunakan metode penginstalan manual atau skrip penginstalan .NET, Anda harus menambahkan direktori tempat .NET diinstal ke PATH variabel .
Beberapa aplikasi mungkin mencari DOTNET_ROOT variabel saat mencoba menentukan di mana .NET diinstal.
Ada banyak shell berbeda yang tersedia untuk macOS dan masing-masing memiliki profil yang berbeda. Contohnya:
Bash Shell: ~/.profile, /etc/profile
Korn Shell: ~/.kshrc atau .profile
Z Shell: ~/.zshrc atau .zprofile
Atur dua variabel lingkungan berikut di profil shell Anda:
DOTNET_ROOT
Variabel ini diatur ke folder .NET diinstal ke, seperti $HOME/.dotnet:
Bash
export DOTNET_ROOT=$HOME/.dotnet
PATH
Variabel ini harus mencakup DOTNET_ROOT folder dan DOTNET_ROOT/tools folder:
Bash
export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
System.Drawing.Common dan libgdiplus
Aplikasi .NET yang menggunakan System.Drawing.Common rakitan harus libgdiplus diinstal.
Cara mudah untuk mendapatkan libgdiplus adalah dengan menggunakan manajer paket Homebrew ("brew") untuk macOS. Setelah menginstal brew, instal libgdiplus dengan menjalankan perintah berikut di terminal:
Sumber untuk konten ini dapat ditemukan di GitHub, yang juga dapat Anda gunakan untuk membuat dan meninjau masalah dan menarik permintaan. Untuk informasi selengkapnya, lihat panduan kontributor kami.
Umpan balik .NET
.NET adalah proyek sumber terbuka. Pilih tautan untuk memberikan umpan balik:
.NET adalah platform pengembang sumber terbuka gratis, lintas platform untuk membangun berbagai jenis aplikasi. Dengan .NET, Anda dapat menggunakan beberapa bahasa, editor, dan pustaka untuk membangun situs, seluler, desktop, permainan, dan IoT.