Bagikan melalui

Instal .NET di Linux dengan menggunakan skrip penginstalan atau dengan mengekstrak biner

  • Artikel

Artikel ini menunjukkan cara menginstal .NET SDK atau .NET Runtime bahasa umum di Linux dengan menggunakan skrip penginstalan atau dengan mengekstrak biner. Untuk daftar distribusi yang mendukung manajer paket bawaan, lihat Menginstal .NET di Linux.

Instal SDK (yang mencakup runtime) jika Anda ingin mengembangkan aplikasi .NET. Atau, jika Anda hanya perlu menjalankan aplikasi, instal Runtime. Jika Anda menginstal Runtime, sebaiknya instal ASP.NET Core Runtime karena menyertakan runtime .NET dan ASP.NET Core.

dotnet --list-sdks Gunakan perintah dan dotnet --list-runtimes untuk melihat versi mana yang diinstal. Untuk informasi lebih lanjut, lihat Cara memeriksa apakah .NET sudah diinstal.

Rilis .NET

Ada dua jenis rilis yang didukung, rilis Dukungan Jangka Panjang (LTS) atau Standard Term Support (STS). Kualitas semua rilis sama. Satu-satunya perbedaan adalah panjang dukungan. Rilis LTS mendapatkan dukungan dan patch gratis selama 3 tahun. Rilis STS mendapatkan dukungan dan patch gratis selama 18 bulan. Untuk informasi selengkapnya, lihat Kebijakan Dukungan .NET.

Tabel berikut mencantumkan status dukungan dari setiap versi .NET (dan .NET Core):

✔️ Didukung ❌Tidak didukung
8 (LTS) 5
7 (STS) 3.1
6 (LTS) 3.0
2.2
2.1
2.0
1.1
1.0

Dependensi

Ada kemungkinan bahwa ketika Anda menginstal .NET, dependensi tertentu mungkin tidak diinstal, seperti ketika menginstal secara manual. Daftar berikut merinci distribusi Linux yang didukung oleh Microsoft dan memiliki dependensi yang mungkin perlu Anda instal. Periksa halaman distribusi untuk informasi selengkapnya:

Untuk informasi umum tentang dependensi, lihat Aplikasi Linux mandiri.

Dependensi RPM

Jika distribusi Anda sebelumnya tidak tercantum, dan berbasis RPM, Anda mungkin memerlukan dependensi berikut:

  • krb5-libs
  • libicu
  • openssl-libs

Jika versi OpenSSL lingkungan runtime target adalah 1.1 atau yang lebih baru, instal compat-openssl10.

Dependensi DEB

Jika distribusi Anda sebelumnya tidak tercantum, dan berbasis RPM, Anda mungkin memerlukan dependensi berikut:

  • libc6
  • libgcc1
  • libgssapi-krb5-2
  • libicu67
  • libssl1.1
  • libstdc++6
  • zlib1g

Dependensi umum

Jika aplikasi .NET menggunakan rakitan System.Drawing.Common , libgdiplus juga perlu diinstal. Karena System.Drawing.Common tidak lagi didukung di Linux, ini hanya berfungsi pada .NET 6 dan memerlukan pengaturan System.Drawing.EnableUnixSupport sakelar konfigurasi runtime.

Anda biasanya dapat menginstal versi terbaru libgdiplus dengan menambahkan repositori Mono ke sistem Anda.

Penginstalan berskrip

Skrip penginstalan dotnet digunakan untuk otomatisasi dan penginstalan non-admin SDK dan Runtime bahasa umum. Anda dapat mengunduh skrip dari https://dot.net/v1/dotnet-install.sh. Ketika .NET diinstal dengan cara ini, Anda harus menginstal dependensi yang diperlukan oleh distribusi Linux Anda. Gunakan tautan di artikel Instal .NET di Linux untuk distribusi Linux spesifik Anda.

Penting

Bash diperlukan untuk menjalankan skrip.

Anda dapat mengunduh skrip dengan wget:

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

Sebelum menjalankan skrip ini, pastikan Anda memberikan izin agar skrip ini berjalan sebagai yang dapat dieksekusi:

chmod +x ./dotnet-install.sh

Skrip default untuk menginstal versi SDK dukungan jangka panjang (LTS) terbaru, yaitu .NET 8. Untuk menginstal rilis terbaru, yang mungkin bukan versi (LTS), gunakan --version latest parameter .

./dotnet-install.sh --version latest

Untuk menginstal .NET Runtime alih-alih SDK, gunakan parameter --runtime.

./dotnet-install.sh --version latest --runtime aspnetcore

Anda dapat menginstal versi utama tertentu dengan --channel parameter untuk menunjukkan versi tertentu. Perintah berikut menginstal .NET 8.0 SDK.

./dotnet-install.sh --channel 8.0

Untuk informasi selengkapnya, lihat referensi skrip dotnet-install.

Untuk mengaktifkan .NET pada baris perintah, lihat Mengatur variabel lingkungan di seluruh sistem.

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

Pemasangan manual

Sebagai alternatif untuk manajer paket, Anda dapat mengunduh dan menginstal SDK dan runtime bahasa umum secara manual. Penginstalan manual umumnya digunakan sebagai bagian dari pengujian integrasi berkelanjutan atau pada distribusi Linux yang tidak didukung. Untuk pengembang atau pengguna, lebih baik menggunakan manajer paket.

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-linux-x64.tar.gz
export DOTNET_ROOT=$(pwd)/.dotnet

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

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

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

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

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 skrip penginstalan sebelumnya, variabel yang ditetapkan hanya berlaku untuk sesi terminal Anda saat ini. Tambahkan ke profil shell Anda. Ada banyak shell berbeda yang tersedia untuk Linux dan masing-masing memiliki profil yang berbeda. Contohnya:

  • Bash Shell: ~/.bash_profile atau ~/.bashrc
  • 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

Langkah berikutnya