Menginstal .NET di macOS

• Instal pada Windows
• Menginstal di macOS
• Menginstal di Linux

Artikel ini mengajarkan Anda tentang versi .NET mana yang didukung di macOS, cara menginstal .NET, dan apa perbedaannya antara SDK dan runtime.

Versi terbaru .NET adalah 8.

Unduh .NET

Versi yang didukung

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"	8.0, 6.0
macOS 14 "Sonoma"	8.0, 6.0
macOS 13 "Ventura"	8.0, 6.0

Versi .NET ❌ berikut tidak lagi didukung:

• .NET 7
• .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 menginstal .NET SDK 8.0, maka .NET Runtime 8.0 dan ASP.NET Core 8.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.

Pengembang

• Visual Studio Code - C# Dev Kit

  Instal ekstensi C# Dev Kit untuk Visual Studio Code untuk mengembangkan aplikasi .NET. Ekstensi dapat menggunakan SDK yang sudah diinstal atau menginstalnya untuk Anda.

Pengguna dan Pengembang

• Penginstal .NET

  Gunakan alat penginstal mandiri untuk menginstal .NET. Metode ini adalah cara umum untuk menginstal .NET pada pengembang atau komputer pengguna Anda.

• Menginstal .NET dengan skrip

  Skrip bash yang dapat mengotomatiskan penginstalan SDK atau Runtime. Anda dapat memilih versi .NET mana yang akan diinstal.

• Instal .NET secara manual

  Gunakan metode penginstalan ini ketika Anda perlu menginstal .NET ke folder tertentu, dan menjalankannya selain dari salinan .NET lainnya.

Menginstal .NET

Paket penginstal tersedia untuk macOS, cara mudah untuk menginstal .NET.

1. Buka browser dan navigasikan ke https://dotnet.microsoft.com/download/dotnet.

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

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

4. Setelah unduhan selesai, buka.

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

1. Buka browser dan navigasikan ke https://dotnet.microsoft.com/download/dotnet.

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

   

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

4. Buka terminal dan navigasikan ke tempat biner .NET diunduh.

5. Ekstrak tarball ke tempat Anda ingin .NET pada sistem Anda. Contoh berikut menggunakan direktori ~/Applications/.dotnetHOME .

   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:

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.

1. Buka terminal.

2. Navigasi ke folder tempat Anda ingin mengunduh skrip, seperti ~/Unduhan.

3. Jika Anda tidak memiliki wget perintah, instal dengan Brew

   brew install wget
   

4. Jalankan perintah berikut untuk mengunduh skrip:

   wget https://dot.net/v1/dotnet-install.sh
   

5. Memberikan izin eksekusi skrip

   chmod +x dotnet-install.sh
   

6. Jalankan skrip untuk menginstal .NET.

   Skrip default untuk menginstal SDK terbaru ke ~/.dotnet direktori.

   ./dotnet-install.sh
   

Berikut adalah semua perintah sebagai skrip bash tunggal:

chdir ~/Downloads
brew install wget
wget https://dot.net/v1/dotnet-install.sh
chmod +x dotnet-install.sh
./dotnet-install.sh

Uji .NET dengan menavigasi ke ~/.dotnet folder dan menjalankan dotnet --info perintah:

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.

Untuk petunjuk tentang menginstal .NET melalui Visual Studio Code, lihat Mulai menggunakan C# di VISUAL Code.

Notarisasi

Perangkat lunak yang dibuat untuk macOS yang didistribusikan dengan ID Pengembang harus diberi notarisasi, termasuk aplikasi yang dibuat dengan .NET.

Jika Anda menjalankan aplikasi yang tidak disahkan, jendela kesalahan yang mirip dengan gambar berikut ditampilkan:

Untuk informasi selengkapnya tentang bagaimana penerapan notarisasi memengaruhi .NET (dan aplikasi .NET Anda), lihat Bekerja dengan macOS Catalina Notarization.

Validasi

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 :

$ sha512sum dotnet-sdk-8.0.100-linux-x64.tar.gz
13905ea20191e70baeba50b0e9bbe5f752a7c34587878ee104744f9fb453bfe439994d38969722bdae7f60ee047d75dda8636f3ab62659450e9cd4024f38b2a5  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:

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

   

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.

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

   

4. Klik kanan pada tautan Checksum , dan salin tautan ke clipboard Anda.

5. Buka terminal.

6. Gunakan curl -O {link} untuk mengunduh file checksum.

   Ganti tautan dalam perintah berikut dengan tautan yang Anda salin.

   curl -O https://dotnetcli.blob.core.windows.net/dotnet/checksums/8.0.0-sha.txt
   

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

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

   $ 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
   

Pemecahan Masalah

Bagian berikut ini tersedia untuk membantu memecahkan masalah:

• Mac berbasis arm
• System.Drawing.Common dan libgdiplus
• Jadikan .NET tersedia di seluruh sistem

Jadikan .NET tersedia di seluruh sistem

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:

  export DOTNET_ROOT=$HOME/.dotnet
  

• PATH

  Variabel ini harus mencakup DOTNET_ROOT folder dan DOTNET_ROOT/tools folder:

  export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
  

Mac berbasis arm

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

Versi .NET

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

Versi .NET	SDK	Runtime	Konflik jalur
8	Ya	Ya	Tidak
8	Ya	Ya	Tidak
6	Ya	Ya	Tidak
6	Ya	Ya	Tidak

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

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

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, SDK x64 apa pun sebelum .NET 6 tidak didukung dan diinstal ke lokasi yang sama dengan versi Arm64, folder /usr/local/share/dotnet/ . Jika Anda ingin menginstal x64 SDK yang tidak didukung, Anda harus terlebih dahulu menghapus instalan versi Arm64. Sebaliknya juga benar, Anda perlu 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 6 SDK. Selain itu, beberapa alat mengandalkan DOTNET_ROOT variabel lingkungan, yang juga perlu diperbarui untuk menunjuk ke folder penginstalan .NET 6 SDK yang sesuai.

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:

brew update
brew install mono-libgdiplus

Konten terkait

• Cara memeriksa apakah .NET sudah diinstal.
• Bekerja dengan notarisasi macOS Catalina.
• Tutorial: Membuat aplikasi baru dengan Visual Studio Code.
• Tutorial: Membuat kontainer aplikasi .NET.