Baca dalam bahasa Inggris

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

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

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.

    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.

    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.

    Situs web unduhan .NET memperlihatkan tautan unduhan SDK dan Runtime. Header SDK dan Runtime disorot dengan kotak merah. Setiap kotak memiliki panah yang menunjuk 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 (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.

      Cuplikan layar hanya memperlihatkan 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 berjalan di macOS.

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.

    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 Biner di 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 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.

  1. Buka terminal.

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

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

    Bash
    brew install wget
    
  4. Jalankan perintah berikut untuk mengunduh skrip:

    Bash
    wget https://dot.net/v1/dotnet-install.sh
    
  5. Memberikan izin eksekusi skrip

    Bash
    chmod +x dotnet-install.sh
    
  6. 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:

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

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.

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:

pemberitahuan notarisasi macOS Catalina

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.

Halaman unduhan .NET dengan checksum

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 :

Bash
$ 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:

    Tabel versi catatan rilis github untuk .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.

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

    Tabel unduhan dengan checksums untuk .NET

  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.

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

    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:

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:

    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:

Console
brew update
brew install mono-libgdiplus