Instal .NET SDK atau .NET Runtime di Debian

Artikel ini menjelaskan cara menginstal .NET di Debian. Ketika versi Debian tidak didukung, .NET tidak lagi didukung dengan versi tersebut. Namun, instruksi ini dapat membantu Anda menjalankan .NET pada versi tersebut, meskipun tidak didukung.

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.

Untuk informasi lebih lanjut tentang menginstal .NET tanpa manajer paket, lihat salah satu artikel berikut ini:

• install-dotnet Gunakan skrip untuk menginstal .NET.
• Instal .NET secara manual.

Distribusi yang didukung

Tabel berikut adalah daftar rilis .NET yang saat ini didukung dan versi Debian tempat mereka didukung. Versi ini tetap didukung sampai versi .NET mencapai akhir dukungan atau versi Debian mencapai akhir masa pakai.

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

Menginstal versi pratinjau

Versi kandidat pratinjau dan rilis .NET tidak tersedia di repositori paket. Anda dapat menginstal pratinjau dan merilis kandidat .NET dengan salah satu cara berikut:

• Penginstalan skrip dengan install-dotnet.sh
• Ekstraksi biner manual

Menghapus versi pratinjau

Saat menggunakan manajer paket untuk mengelola penginstalan .NET, Anda mungkin mengalami konflik jika sebelumnya sudah menginstal rilis pratinjau. Manajer paket dapat menginterpretasikan rilis non-pratinjau sebagai versi .NET sebelumnya. Untuk menginstal rilis non-pratinjau, hapus instalan versi pratinjau terlebih dahulu. Untuk informasi lebih lanjut tentang menghapus instalan .NET, lihat Cara menghapus .NET Runtime dan SDK.

Debian 12

Menginstal dengan APT dapat dilakukan dengan beberapa perintah. Sebelum Anda menginstal .NET, jalankan perintah berikut untuk menambahkan kunci penandatanganan paket Microsoft ke daftar kunci tepercaya Anda, lalu tambahkan repositori paket.

Buka terminal dan jalankan perintah berikut:

wget https://packages.microsoft.com/config/debian/12/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-9.0

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-9.0

sudo apt-get install -y dotnet-runtime-9.0

sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-8.0

sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-8.0

sudo apt-get install -y dotnet-runtime-8.0

Gunakan APT untuk memperbarui .NET

Ketika rilis patch baru tersedia untuk .NET, Anda cukup meningkatkannya melalui APT dengan perintah berikut:

sudo apt-get update
sudo apt-get upgrade

Jika Anda sudah meningkatkan distribusi Linux sejak menginstal .NET, Anda mungkin perlu mengonfigurasi ulang repositori paket Microsoft. Jalankan petunjuk penginstalan untuk versi distribusi Anda saat ini untuk meningkatkan ke repositori paket yang sesuai untuk pembaruan .NET.

Pemecahan Masalah

Bagian ini menyediakan informasi tentang kesalahan umum yang mungkin Anda dapatkan saat menggunakan APT untuk menginstal .NET.

Tidak dapat menemukan paket

Untuk informasi lebih lanjut tentang menginstal .NET tanpa manajer paket, lihat salah satu artikel berikut ini:

• install-dotnet Gunakan skrip untuk menginstal .NET.
• Instal .NET secara manual.

Tidak dapat menemukan \ Beberapa paket tidak dapat diinstal

Jika Anda menerima pesan kesalahan yang mirip dengan Tidak dapat menemukan paket {dotnet-package} atau Beberapa paket tidak dapat diinstal, jalankan perintah berikut.

Ada dua tempat penampung dalam sekumpulan perintah berikut.

• {dotnet-package}
  Ini mewakili paket .NET yang Anda instal, seperti aspnetcore-runtime-8.0. Ini digunakan dalam perintah sudo apt-get install berikut.

Pertama, coba hapus daftar paket:

sudo dpkg --purge packages-microsoft-prod && sudo dpkg -i packages-microsoft-prod.deb
sudo apt-get update

Kemudian, coba instal .NET lagi. Jika tidak berhasil, Anda dapat menjalankan penginstalan manual dengan perintah berikut:

Jika Anda menggunakan Debian 12 atau yang lebih baru, coba perintah berikut:

# Get OS version info which adds the $ID and $VERSION_ID variables
source /etc/os-release

# Download the Microsoft keys
sudo apt-get install -y gpg wget
wget https://packages.microsoft.com/keys/microsoft.asc
cat microsoft.asc | gpg --dearmor -o microsoft.asc.gpg

# Add the Microsoft repository to the system's sources list
wget https://packages.microsoft.com/config/$ID/$VERSION_ID/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list

# Move the key to the appropriate place
sudo mv microsoft.asc.gpg $(cat /etc/apt/sources.list.d/microsoft-prod.list | grep -oP "(?<=signed-by=).*(?=\])")

# Update packages and install .NET
sudo apt-get update && \
  sudo apt-get install -y {dotnet-package}

Jika Anda menggunakan versi Debian sebelum 12, coba perintah berikut:

# Define the OS version, name, and codename
source /etc/os-release

# Download the Microsoft keys
sudo apt-get install -y gpg wget
wget https://packages.microsoft.com/keys/microsoft.asc
cat microsoft.asc | gpg --dearmor -o microsoft.asc.gpg
sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/

# Add the Microsoft repository to the system's sources list
wget https://packages.microsoft.com/config/$ID/$VERSION_ID/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list

# Set ownership
sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg
sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list

# Update packages and install .NET
sudo apt-get update && \
  sudo apt-get install -y {dotnet-package}

Gagal mengambil

Saat menginstal paket .NET, Anda mungkin melihat kesalahan yang mirip dengan Failed to fetch ... File has unexpected size ... Mirror sync in progress?. Kesalahan ini bisa berarti bahwa umpan paket untuk .NET sedang ditingkatkan dengan versi paket yang lebih baru, dan Anda harus mencoba lagi nanti. Selama peningkatan, umpan paket seharusnya tidak tersedia selama lebih dari 30 menit. Jika Anda terus menerima kesalahan ini selama lebih dari 30 menit, silakan ajukan masalah di https://github.com/dotnet/core/issues.

Dependensi

Saat Anda menginstal dengan manajer paket, pustaka ini diinstal untuk Anda. Namun, jika Anda menginstal .NET secara manual atau menerbitkan aplikasi mandiri, Anda harus memastikan pustaka ini diinstal:

12.x

• libc6
• libgcc-s1
• libgssapi-krb5-2
• libicu72
• libssl3
• libstdc++6
• zlib1g

11.x

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

10.x

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

Catatan lain

Dependensi dapat diinstal dengan apt install perintah . Cuplikan berikut menunjukkan penginstalan libc6 pustaka:

sudo apt install libc6

Jika aplikasi .NET menggunakan rakitan System.Drawing.Common , libgdiplus harus diinstal. Untuk informasi selengkapnya, lihat System.Drawing.Common hanya didukung di Windows.

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

Langkah berikutnya

• Gambaran umum .NET CLI
• Cara mengaktifkan penyelesaian TAB untuk CLI .NET
• Tutorial: Membuat aplikasi konsol dengan .NET SDK menggunakan Visual Studio Code