Bagikan melalui

Menginstal .NET di macOS

  • Artikel

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

Versi terbaru .NET adalah 8.

Unduh .NET

Rilis yang didukung

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 adalah daftar rilis .NET yang saat ini didukung dan versi macOS yang didukungnya:

Sistem Operasi .NET 8 (LTS) .NET 6 (LTS)
macOS 14.0 "Sonoma" ✔️ 8.0 ✔️ 6.0
macOS 13.0 "Ventura" ✔️ 8.0 ✔️ 6.0
macOS 12.0 "Monterey" ✔️ 8.0 ✔️ 6.0
macOS 11.0 "Big Sur" ❌ ✔️ 6.0
macOS 10.15 "Catalina" ❌ ✔️ 6.0

Untuk daftar lengkap versi .NET dan siklus hidup dukungannya, lihat Kebijakan Dukungan .NET.

Rilis yang tidak didukung

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

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 dua runtime berbeda yang dapat Anda instal di macOS:

  • runtime ASP.NET Core
    Menjalankan aplikasi ASP.NET Core. Termasuk runtime .NET.

  • Runtime .NET
    Runtime ini adalah runtime paling sederhana dan tidak menyertakan runtime lainnya. Sangat disarankan agar Anda menginstal runtime ASP.NET Core untuk kompatibilitas terbaik dengan aplikasi .NET.

Unduh .NET Runtime

Informasi SDK

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

Notarisasi

Dimulai dengan macOS Catalina (versi 10.15), semua perangkat lunak yang dibuat setelah 1 Juni 2019 yang didistribusikan dengan ID Pengembang harus diberi notarisasi. Persyaratan ini berlaku untuk runtime .NET, SDK .NET, dan perangkat lunak yang dibuat dengan .NET.

Runtime dan penginstal SDK untuk .NET telah disahkan sejak 18 Februari 2020. Versi yang dirilis sebelumnya tidak disahkan. Jika Anda menjalankan aplikasi yang tidak disahkan, Anda akan melihat kesalahan yang mirip dengan gambar berikut:

pemberitahuan notarisasi macOS Catalina

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

libgdiplus

Aplikasi .NET yang menggunakan rakitan System.Drawing.Common memerlukan libgdiplus untuk 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 prompt Terminal (perintah):

brew update
brew install mono-libgdiplus

Penginstalan otomatis

macOS memiliki alat penginstal mandiri yang dapat digunakan untuk menginstal .NET:

Pemasangan manual

Sebagai alternatif untuk penginstal macOS untuk .NET, Anda dapat mengunduh dan menginstal SDK dan runtime secara manual. Penginstalan manual biasanya dilakukan sebagai bagian dari pengujian integrasi berkelanjutan. Untuk pengembang atau pengguna, umumnya lebih baik menggunakan alat penginstal.

Unduh rilis biner untuk SDK atau runtime dari salah satu situs berikut. .NET SDK mencakup runtime yang sesuai:

Ekstrak file yang diunduh dan gunakan export perintah untuk mengatur DOTNET_ROOT ke lokasi folder yang diekstrak lalu pastikan .NET berada di PATH. DOTNET_ROOT Mengekspor membuat perintah .NET CLI tersedia di terminal. Untuk informasi selengkapnya tentang variabel lingkungan .NET, lihat variabel lingkungan .NET SDK dan CLI.

Versi .NET yang berbeda dapat diekstrak ke folder yang sama, yang berdampingan.

Contoh

Perintah berikut menggunakan Bash untuk mengatur variabel DOTNET_ROOT lingkungan ke direktori kerja saat ini diikuti oleh .dotnet. Direktori tersebut dibuat jika tidak ada. Variabel DOTNET_FILE lingkungan adalah nama file dari rilis biner .NET yang ingin Anda instal. File ini diekstrak ke DOTNET_ROOT direktori. DOTNET_ROOT Direktori dan subdirektorinya tools ditambahkan ke PATH variabel lingkungan.

Penting

Jika Anda menjalankan perintah ini, ingatlah untuk mengubah DOTNET_FILE nilai menjadi nama biner .NET yang Anda unduh.

DOTNET_FILE=dotnet-sdk-8.0.100-osx-x64.tar.gz
export DOTNET_ROOT=$(pwd)/.dotnet

mkdir -p "$DOTNET_ROOT" && tar zxf "$DOTNET_FILE" -C "$DOTNET_ROOT"

export PATH=$PATH:$DOTNET_ROOT

Anda dapat menginstal lebih dari satu versi .NET di folder yang sama.

Anda juga dapat menginstal .NET ke direktori beranda yang diidentifikasi oleh HOME variabel atau ~ jalur:

export DOTNET_ROOT=$HOME/.dotnet

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.

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 :

$ 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 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. Salin tautan ke file checksum.

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

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

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

Mengatur variabel lingkungan di seluruh sistem

Jika Anda menggunakan instruksi di bagian Contoh penginstalan manual, variabel yang ditetapkan hanya berlaku untuk sesi terminal Anda saat ini. Tambahkan ke profil shell Anda. 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.

Apa yang didukung

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.

Menginstal dengan Visual Studio untuk Mac

Visual Studio untuk Mac menginstal .NET SDK saat beban kerja .NET dipilih. Untuk mulai menggunakan pengembangan .NET di macOS, lihat Menginstal Visual Studio 2022 untuk Mac.

Penting

Visual Studio untuk Mac sedang dihentikan. Untuk informasi selengkapnya, lihat Apa yang terjadi pada Visual Studio untuk Mac?.

Versi .NET SDK Versi Visual Studio
8.0 Visual Studio 2022 untuk Mac 17.6.1 atau yang lebih tinggi. (Hanya tersedia sebagai fitur pratinjau.)
6.0 Visual Studio 2022 untuk Mac 17.0 atau yang lebih tinggi.

macOS Visual Studio 2022 untuk Mac dengan beban kerja .NET dipilih.

Penting

Microsoft telah mengumumkan penghentian Visual Studio untuk Mac. Visual Studio untuk Mac tidak akan lagi didukung mulai 31 Agustus 2024. Alternatifnya meliputi:

  • Visual Studio Code dengan C# Dev Kit dan ekstensi terkait, seperti .NET MAUI dan Unity.
  • Visual Studio berjalan di Windows di VM di Mac.
  • Visual Studio berjalan di Windows di VM di Cloud.

Untuk informasi selengkapnya, lihat Pengumuman penghentian Visual Studio untuk Mac.

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 otomatis seperti yang dilakukan Visual Studio, menambahkan dukungan .NET sederhana.

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

Instal dengan otomatisasi bash

Skrip dotnet-install digunakan untuk penginstalan otomatisasi dan 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 ASP.NET Core untuk kompatibilitas maksimum. Runtime ASP.NET Core juga menyertakan runtime .NET standar.

./dotnet-install.sh --channel 8.0 --runtime aspnetcore

Untuk mempelajari cara menggunakan .NET CLI, lihat gambaran umum .NET CLI.

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.

Langkah berikutnya