Bagikan melalui

Menginstal .NET di macOS

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

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 26 "Tahoe" 10.0, 9.0, 8.0
macOS 15 "Sequoia" 10.0, 9.0, 8.0
macOS 14 "Sonoma" 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. Menyertakan sebuah 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 Runtime .NET standar dan Runtime ASP.NET Core. Misalnya, jika Anda telah menginstal .NET SDK 9.0, maka runtime .NET 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 .NET Installer.

Pengembang

  • Visual Studio Code - C# Dev Kit

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

Pengguna dan Pengembang

  • .NET Installer

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

  • Install .NET dengan skrip

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

  • Install .NET secara manual

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

Menginstal .NET

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

  1. Buka browser dan navigasikan ke .

  2. Pilih tautan ke versi .NET yang ingin Anda instal, seperti .NET 10.0.

    Situs web unduhan .NET. Versi 6.0 hingga 9.0 tercantum. Kotak merah menyoroti tautan unduhan tersebut.

    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.

    Petunjuk / Saran

    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.

    Situs web unduhan .NET memperlihatkan tautan unduhan SDK dan Runtime. Header SDK dan Runtime disorot dengan kotak merah. Setiap kotak memiliki panah yang mengarah ke bawah ke bagian macOS.

    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 (Waktu Kompilasi)

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

      Gulir lebih jauh ke bawah untuk menemukan .NET Runtime standar untuk diunduh.

      Cuplikan layar ini memperlihatkan hanya tabel unduhan .NET Runtime dari situs web unduhan .NET. Baris macOS disorot dengan kotak merah.

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

    Cuplikan layar yang hanya menampilkan penginstal .NET yang sedang berjalan di macOS.

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

Petunjuk / Saran

Gunakan skrip install-dotnet.sh untuk melakukan langkah-langkah ini secara otomatis.

  1. Buka browser dan navigasikan ke .

  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.

    Petunjuk / Saran

    Jika Anda tidak yakin versi mana yang akan diunduh, pilih versi yang ditandai terbaru.

    Situs web unduhan .NET. Versi 6.0 hingga 9.0 tercantum. Kotak merah menyoroti tautan unduhan tersebut.

  3. Pilih tautan ke SDK atau Runtime yang ingin Anda instal. Cari kolom Binari pada baris macOS.

    Situs web unduhan .NET memperlihatkan tautan unduhan SDK. Header SDK disorot dengan kotak merah. Kotak memiliki panah yang menunjuk ke bawah ke bagian 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 lokasi yang Anda inginkan untuk memasang .NET pada sistem Anda. Contoh berikut menggunakan direktori HOME.

    mkdir -p ~/Applications/.dotnet
tar -xf "dotnet-sdk-9.0.100-rc.2.24474.11-osx-arm64.tar" -C ~/Applications/.dotnet/

Uji bahwa .NET berfungsi dengan mengubah direktori ke tempat .NET diinstal, dan jalankan perintah dotnet --info:

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 .

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

Petunjuk / Saran

Perintah ini disediakan cuplikan skrip di akhir prosedur ini.

  1. Buka terminal.

  2. Buka folder tempat Anda ingin mengunduh skrip, misalnya ~/Unduhan.

  3. Jika Anda tidak memiliki 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 secara default menginstal SDK terbaru ke 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 folder ~/.dotnet dan menjalankan perintah dotnet --info:

chdir ~/.dotnet
./dotnet --info

Penting

Beberapa program mungkin menggunakan variabel lingkungan untuk menemukan .NET pada sistem Anda, dan menggunakan perintah dotnet mungkin tidak berfungsi saat membuka terminal baru. Untuk bantuan mengatasi masalah ini, lihat bagian Make .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 dengan 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:

pemberitahuan notarisasi macOS Catalina

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

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 file tersebut akan ditampilkan dalam kotak teks. Pilih tombol Salin untuk menyalin nilai checksum ke clipboard Anda.

Halaman unduhan .NET dengan checksum

Gunakan perintah untuk mencetak checksum file yang telah Anda unduh. Misalnya, perintah berikut melaporkan checksum file dotnet-sdk-9.0.306-osx-x64.tar.gz :

$ shasum -a 512 dotnet-sdk-9.0.306-osx-x64.tar.gz
a9700f98e5aa4f70b2a08ddba2b1c6085106b0d17828bd719fdcef460b06c890b32d752fbff8e4659cd1ca4174b4b211b301fe682439ea9a24b6521ca5a64c69  dotnet-sdk-9.0.306-osx-x64.tar.gz

Bandingkan checksum dengan nilai yang disediakan oleh situs unduhan.

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 9 pada GitHub di https://github.com/dotnet/core/tree/main/release-notes/9.0#releases berisi bagian bernama Releases. Tabel di bagian tersebut menautkan ke file unduhan dan checksum untuk setiap rilis .NET 9. Gambar berikut menunjukkan tabel rilis .NET 8 sebagai referensi:

    Tabel versi catatan rilis GitHub untuk .NET

  2. Pilih tautan untuk versi .NET yang Anda unduh.

    Bagian sebelumnya digunakan .NET SDK 9.0.306, yang ada dalam rilis .NET 9.0.10.

  3. Di halaman rilis, Anda dapat melihat versi .NET Runtime dan .NET SDK, dan tautan ke file checksum. Gambar berikut menunjukkan tabel rilis .NET 8 sebagai referensi:

    Tabel unduhan dengan checksum untuk .NET

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

  5. Buka terminal.

  6. Gunakan untuk mengunduh file checksum.

    Ganti tautan dalam perintah berikut dengan tautan yang Anda salin.

    curl -O https://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt

  7. Dengan file checksum dan file rilis .NET yang diunduh ke direktori yang sama, gunakan perintah shasum -a 512 -c {file} untuk memvalidasi file yang diunduh.

    Saat validasi lolos, Anda akan melihat file yang dicetak dengan status OK :

    $ shasum -a 512 -c 9.0.10-sha.txt
dotnet-sdk-9.0.306-osx-x64.tar.gz: OK

    Jika Anda melihat file ditandai sebagai GAGAL, file yang Anda unduh tidak valid dan tidak boleh digunakan.

    $ shasum -a 512 -c 9.0.10-sha.txt
dotnet-sdk-9.0.306-osx-x64.tar.gz: FAILED
shasum: WARNING: 1 computed checksum did NOT match

Mac berbasis ARM

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

Perbedaan jalur

Pada Mac berbasis Arm, semua versi Arm64 .NET diinstal pada folder /usr/local/share/dotnet/. Namun, saat Anda menginstal x64 versi .NET SDK, SDK .NET diinstal ke folder /usr/local/share/do tnet/x64/do tnet/.

Variabel jalur

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

Pemecahan Masalah

Bagian berikut ini tersedia untuk membantu memecahkan masalah:

Membuat .NET tersedia di seluruh sistem

Terkadang aplikasi di sistem Anda, termasuk terminal, perlu menemukan tempat .NET diinstal. Paket .NET macOS Installer harus mengonfigurasi sistem Anda secara otomatis. Namun, jika Anda menggunakan metode penginstalan manual atau .NET menginstal skrip, Anda harus menambahkan direktori tempat .NET diinstal ke variabel PATH.

Beberapa aplikasi mungkin mencari variabel DOTNET_ROOT 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 tempat .NET diinstal, seperti $HOME/.dotnet:

    export DOTNET_ROOT=$HOME/.dotnet

  • PATH

    Variabel ini harus mencakup baik folder yang ini maupun folder yang itu.

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

Konten terkait

  • Last updated on