Ubuntu'da .NET'e genel bakış

Bu makalede Ubuntu'ya .NET'in nasıl yükleneceği açıklanmaktadır. Ubuntu 22.04 sürümünden itibaren desteklenen .NET sürümlerinin çoğu yerleşik Ubuntu akışında kullanılabilir. Ubuntu .NET backports paket deposu, desteklenen diğer .NET sürümlerini içerir. Kullanılabilir sürümler hakkında daha fazla bilgi için Desteklenen dağıtımlar bölümüne bakın.

Canonical, Ubuntu'da .NET yayımlamayı devraldı. Ubuntu 22.04'den başlayarak, Microsoft artık Ubuntu için .NET'i Microsoft paket deposuna dağıtmaz.

Ubuntu yükseltirken dikkat edilmesi gerekenler

Ubuntu 22.04 veya sonraki bir sürüme yükseltiliyor mu? Önce .NET'i kaldırmayı düşünün.

Microsoft paket deposundan .NET yüklemek için bir paket yöneticisi kullandıysanız Ubuntu'yu yükselttikten sonra bir paket karma sorunuyla karşınıza çıkar. Canonical artık .NET'i Ubuntu 22.04 (ve sonraki sürümler) için paket akışlarında yayımlayabildiğine göre, paket yöneticisi daha önce yüklenmiş olan .NET sürümünü bilmiyor. Paketler en son .NET'e yükseltilemiyor. İlk olarak, bunları kaldırın ve [Ubuntu paket deposundan] yeniden yükleyin.

.NET'in nasıl yükleneceğine karar verme

Ubuntu sürümünüz yerleşik veya .NET backports Ubuntu akışı aracılığıyla .NET'i desteklediğinde, .NET'in bu derlemeleri için destek Canonical tarafından sağlanır ve derlemeler farklı iş yükleri için en iyi duruma getirilebilir. Microsoft, Microsoft paket deposu akışındaki paketler için destek sağlar.

.NET'i nasıl yüklemeniz gerektiğini belirlemek için aşağıdaki bölümleri kullanın:

• Ubuntu 22.04 veya üzerini kullanıyorum ve yalnızca .NET'e ihtiyacım var
• 22.04'e kadar Ubuntu sürümünü kullanıyorum
• , powershellveya gibi mdatpdiğer Microsoft paketlerini kullanıyorummssql
• .NET uygulaması oluşturmak istiyorum
• .NET uygulamasını kapsayıcı, bulut veya sürekli tümleştirme senaryosunda çalıştırmak istiyorum
• Ubuntu dağıtımım istediğim .NET sürümünü içermiyor veya destek dışı bir .NET sürümüne ihtiyacım var
• Önizleme sürümü yüklemek istiyorum
• APT kullanmak istemiyorum
• Arm tabanlı CPU kullanıyorum
• IBM System Z platformunu kullanıyorum

Ubuntu 22.04 veya üzerini kullanıyorum ve yalnızca .NET'e ihtiyacım var

powershell, mdatpveya mssqlgibi başka Microsoft paketlerine ihtiyacınız yoksa Ubuntu akışı aracılığıyla .NET'i yükleyin. Daha fazla bilgi için aşağıdaki sayfalara bakın:

• Ubuntu 24.10'a .NET yükleyin.
• Ubuntu 24.04'e .NET yükleyin.
• Ubuntu 22.04'e .NET yükleyin.

, veya powershellgibi mdatpmssqldiğer Microsoft paketlerini kullanmak için Microsoft deposunu yükleyecekseniz, Microsoft deposu tarafından sağlanan .NET paketlerinin önceliklerini kaldırmanız gerekir. Paketlerin önceliklerini kaldırma yönergeleri için bkz . Linux dağıtımım .NET paketleri sağlıyor ve bunları kullanmak istiyorum.

22.04'e kadar Ubuntu sürümünü kullanıyorum

Sürüme özgü Ubuntu sayfasındaki yönergeleri kullanın.

• 20.04 (LTS)

Ubuntu sürümünüz için hangi .NET sürümlerinin desteklendiği hakkında daha fazla bilgi için Desteklenen dağıtımlar bölümünü gözden geçirin. Eğer desteklenmeyen bir sürümü yüklüyorsanız, Microsoft paket deposunu kaydetme bölümüne bakın.

Başka Microsoft paketlerini, örneğin powershell, mdatp veya mssql kullanıyorum.

Ubuntu sürümünüz bir Ubuntu akışları aracılığıyla .NET'i destekliyorsa hangi akışın .NET'i yükleyeceğine karar vermeniz gerekir. Desteklenen dağıtımlar bölümü, paket akışlarında hangi .NET sürümlerinin kullanılabilir olduğunu listeleyen bir tablo sağlar.

.NET paketlerini bir Ubuntu akışından kaynaklamak istiyorsanız, Microsoft deposu tarafından sağlanan .NET paketlerinin önceliklerini kaldırmanız gerekir. Paketlerin önceliklerini kaldırma yönergeleri için bkz . Linux dağıtımım .NET paketleri sağlıyor ve bunları kullanmak istiyorum.

.NET uygulaması oluşturmak istiyorum

SDK için çalışma zamanı için kullandığınız paket kaynaklarını kullanın. .NET'i bir Ubuntu akışı üzerinden yüklemeniz önerilir. Ancak başka bir kaynaktan .NET yüklemek istiyorsanız (örneğin , daha yüksek SDK özellik bantlarına erişmek için Microsoft paket deposu ), .NET'i kaldırmalı, paket yöneticinizi Ubuntu akışındaki .NET paketlerini yoksayacak şekilde yapılandırmalı ve diğer kaynaktan yeniden yüklemelisiniz.

.NET'in nasıl yükleneceğine karar verme bölümündeki diğer önerileri gözden geçirin.

.NET uygulamasını kapsayıcı, bulut veya sürekli tümleştirme senaryosunda çalıştırmak istiyorum

Ubuntu sürümünüz ihtiyacınız olan .NET sürümünü sağlıyorsa bunu bir Ubuntu akışından yükleyin. Aksi takdirde, Microsoft paket deposunu kaydedin ve bu depodan .NET yükleyin. Desteklenen dağıtımlar bölümündeki bilgileri gözden geçirin.

İstediğiniz .NET sürümü kullanılamıyorsa dotnet-install betiğini kullanmayı deneyin.

Ubuntu dağıtımım istediğim .NET sürümünü içermiyor veya destek dışı bir .NET sürümüne ihtiyacım var

APT ve Microsoft paket deposunu kullanmanızı öneririz. Daha fazla bilgi için Microsoft paket deposuyla kaydetme ve yükleme bölümüne bakın.

Önizleme sürümü yüklemek istiyorum

.NET'i yüklemek için aşağıdaki yollardan birini kullanın:

• install-dotnet betiğini kullanarak .NET'i yükleyin.
• .NET'i el ile yükleme

APT kullanmak istemiyorum

Otomatik yükleme istiyorsanız Linux yükleme betiğini kullanın.

.NET yükleme deneyimi üzerinde tam denetim istiyorsanız bir tarball indirin ve .NET'i el ile yükleyin. Daha fazla bilgi için bkz . El ile yükleme.

Arm tabanlı CPU kullanıyorum

Ubuntu sürümünüz ihtiyacınız olan .NET sürümünü sağlıyorsa, yerleşik akıştan yükleyin. Desteklenen dağıtımlar bölümündeki bilgileri gözden geçirin.

İstediğiniz .NET sürümü kullanılamıyorsa, .NET'i yüklemek için aşağıdaki yollardan birini kullanmayı deneyin:

• Betik ile install-dotnet .NET'i yükleyin.
• .NET'i el ile yükleme

IBM System Z platformunu kullanıyorum

Canonical, Ubuntu 24.04'te .NET 8 ile başlayarak IBM System Z platformu için .NET'i destekler. Canonical, desteği diğer .NET ve Ubuntu sürümlerine genişletmek için çalışır.

Yerleşik Ubuntu akışı aracılığıyla .NET'i yükleyin. Daha fazla bilgi için aşağıdaki sayfaya bakın:

• Ubuntu 24.10'a .NET 9 yükleyin.

Desteklenen dağıtımlar

Aşağıdaki tablo, şu anda desteklenen .NET sürümlerinin ve desteklendiği Ubuntu sürümlerinin listesidir. Her bağlantı belirli Ubuntu sürümü sayfasına gider ve bu Ubuntu sürümü için .NET'in nasıl yükleneceğine ilişkin belirli yönergeler bulunur.

Ubuntu sürümü destek döneminin sonuna ulaştığında, .NET artık bu Ubuntu sürümüyle desteklenmemektedir.

Canonical, Microsoft tarafından sağlanan destek ömrünün ötesinde bile o Ubuntu sürümünün kullanım ömrü boyunca Ubuntu'nun yerleşik akışındaki .NET sürümlerini destekler ve .NET backports paket deposundaki .NET sürümleri için Microsoft tarafından sağlanan destek ömrünün ötesine geçmeyen en iyi çabayı göstererek destek sağlar.

Aşağıdaki .NET ❌ sürümleri artık desteklenmiyor:

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

Paket deposunu kaydetme

Ubuntu sürümünüze bağlı olarak Ubuntu backports veya Microsoft paket deposunu kaydetmeniz gerekebilir.

• Ubuntu .NET backports paket deposunu kaydedin
• Microsoft paket deposunu kaydetme

Ubuntu .NET geri port paket deposu

Ubuntu .NET backports paket deposu, yerleşik Ubuntu akışında bulunmayan .NET sürümlerini sağlar. Desteklenen dağıtımlar bölümü, paket akışında hangi .NET sürümlerinin kullanılabilir olduğunu listeleyen bir tablo sağlar. Canonical, bu paket deposunda bulunan paketleri korur ve Microsoft tarafından sağlanan destek ömrünü veya belirli Ubuntu sürümünün destek süresini kapsamayan en iyi çaba desteğini sağlar.

Daha fazla ayrıntı için Ubuntu .NET backports paket deposunun web görünümüne bakın.

Ubuntu .NET backports paket deposunu kaydetme

Bir terminal açın ve aşağıdaki komutu çalıştırın:

sudo add-apt-repository ppa:dotnet/backports

Ubuntu .NET backports paket deposunun kaydını kaldırın

Ubuntu .NET backports paket deposundaki paketleri artık kullanmak istemiyorsanız kaydı kaldırabilirsiniz. Bir terminal açın ve aşağıdaki komutu çalıştırın:

sudo add-apt-repository --remove ppa:dotnet/backports

add-apt-repository komutu bulunamadı

Yardımcı add-apt-repository(1) program çoğu Ubuntu yüklemesinde önceden yüklenmiştir.

Komutun add-apt-repository bulunamadığını belirten bir hata iletisi alırsanız, bu komutu sağlayan paketi yüklemeniz software-properties-common gerekir. Bir terminal açın ve aşağıdaki komutları çalıştırın:

sudo apt update
sudo apt install software-properties-common

Microsoft paket deposunu kaydetme

Microsoft paket deposu, daha önce veya şu anda Ubuntu sürümünüzle desteklenen tüm .NET sürümlerini içerir. Ubuntu sürümünüz .NET paketleri sağlıyorsa Ubuntu paketlerinin önceliklerini kaldırmanız ve Microsoft deposunu kullanmanız gerekir. Paketlerin önceliklerini kaldırma yönergeleri için bkz . Linux dağıtımım tarafından sağlanmayan bir .NET sürümüne ihtiyacım var.

Önizleme sürümleri Microsoft paket deposunda kullanılamaz . Daha fazla bilgi için bkz . Önizleme sürümlerini yükleme.

APT ile yükleme birkaç komutla yapılabilir. .NET'i yüklemeden önce aşağıdaki komutları çalıştırarak Microsoft paket imzalama anahtarını güvenilen anahtarlar listenize ekleyin ve paket deposunu ekleyin.

Bir terminal açın ve aşağıdaki komutları çalıştırın:

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

# Download Microsoft signing key and repository
wget https://packages.microsoft.com/config/$ID/$VERSION_ID/packages-microsoft-prod.deb -O packages-microsoft-prod.deb

# Install Microsoft signing key and repository
sudo dpkg -i packages-microsoft-prod.deb

# Clean up
rm packages-microsoft-prod.deb

# Update packages
sudo apt update

.NET'i yükleme, kaldırma veya güncelleştirme

Aşağıdaki bölümlerde paket yöneticisi aracılığıyla .NET'in nasıl yönetileceğini açıklanmaktadır.

.NET yükleme

komutuyla paket yöneticisi aracılığıyla .NET'i sudo apt install <package-name> yükleyin. yerine <package-name> yüklemek istediğiniz .NET paketinin adını yazın. Örneğin, .NET SDK 9.0'ı yüklemek için komutunu sudo apt install dotnet-sdk-9.0kullanın. Aşağıdaki tabloda şu anda desteklenen .NET paketleri listelenmektedir (Ubuntu sürümünüze göre farklılık gösterebilir):

Bazı ortam değişkenleri yüklendikten sonra .NET'in nasıl çalıştırıldığından etkilenir. Daha fazla bilgi için bkz . .NET SDK ve CLI ortam değişkenleri.

.NET'i kaldırma

.NET'i bir paket yöneticisi aracılığıyla yüklediyseniz, komutuyla apt-get remove aynı şekilde kaldırın:

sudo apt-get remove dotnet-sdk-6.0

Daha fazla bilgi için bkz . .NET'i kaldırma.

.NET'i güncelleştirme

.NET'i bir paket yöneticisi aracılığıyla yüklediyseniz, komutunu kullanarak apt upgrade paketi yükseltebilirsiniz. Örneğin, aşağıdaki komutlar dotnet-sdk-9.0 paketini en son sürümle yükseltir:

sudo apt update
sudo apt upgrade dotnet-sdk-9.0

Önizleme sürümlerini yönetme

Aşağıdaki bölümlerde .NET'in önizleme sürümlerinin nasıl yükleneceği ve kaldırıldığı açıklanmaktadır.

Önizleme sürümlerini yükleme

.NET'in önizleme ve sürüm adayı sürümleri paket depolarında kullanılamaz. .NET'in önizlemelerini ve sürüm adaylarını aşağıdaki yollardan biriyle yükleyebilirsiniz:

• install-dotnet.sh ile betikli yükleme
• Manuel ikili ayıklama

Önizleme sürümlerini kaldırma

.NET yüklemenizi yönetmek için paket yöneticisi kullanırken, daha önce bir önizleme sürümü yüklediyseniz bir çakışmayla karşılaşabilirsiniz. Paket yöneticisi önizleme dışı sürümü .NET'in önceki bir sürümü olarak yorumlayabilir. Önizleme olmayan sürümü yüklemek için önce önizleme sürümlerini kaldırın. .NET'i kaldırma hakkında daha fazla bilgi için bkz . .NET Çalışma Zamanı ve SDK'sını kaldırma.

Sorun giderme

Ubuntu 22.04'den başlayarak, yalnızca bir .NET parçasının kullanılabilir olduğu bir durumla karşılaşabilirsiniz. Örneğin, çalışma zamanını ve SDK'yı yüklediniz, ancak dotnet --info çalıştırdığınızda yalnızca çalışma zamanı listelenir. Bu durum iki farklı paket kaynağının kullanılmasıyla ilgili olabilir. Yerleşik Ubuntu 22.04 ve Ubuntu 22.10 paket akışları .NET'in bazı sürümlerini içerir, ancak tümünü içermez ve Microsoft akışlarından .NET'i de yüklemiş olabilirsiniz. Bu sorunu giderme hakkında daha fazla bilgi için bkz . Linux'ta eksik dosyalarla ilgili .NET hatalarını giderme.

APT sorunları

Bu bölüm, .NET'i yüklemek için APT kullanırken alabileceğiniz yaygın hatalar hakkında bilgi sağlar.

Paket bulunamıyor

.NET'i paket yöneticisi olmadan yükleme hakkında daha fazla bilgi için aşağıdaki makalelerden birine bakın:

• .NET'i yüklemek için install-dotnet betiğini kullanın.
• .NET'i el ile yükleyin.

Bulunamadı \ Bazı paketler yüklenemedi

{dotnet-package} paketi bulunamıyor veya Bazı paketler yüklenemedi gibi bir hata iletisi alırsanız aşağıdaki komutları çalıştırın.

Aşağıdaki komut kümesinde iki yer tutucu vardır.

• {dotnet-package}
  Bu, yüklemekte olduğunuz .NET paketini temsil eder, örneğin aspnetcore-runtime-8.0. Bu, aşağıdaki sudo apt-get install komutta kullanılır.

İlk olarak paket listesini temizlemeyi deneyin:

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

Ardından.NET'i yüklemeyi yeniden deneyin. Bu işe yaramazsa, aşağıdaki komutlarla el ile yükleme çalıştırabilirsiniz:

Ubuntu 23.10 veya sonraki bir sürümü kullanıyorsanız aşağıdaki komutları deneyin:

# 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}

23.10'den önceki bir Ubuntu sürümü kullanıyorsanız aşağıdaki komutları deneyin:

# 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}

Getirme başarısız oldu

.NET paketini yüklerken, benzeri Failed to fetch ... File has unexpected size ... Mirror sync in progress?bir hata görebilirsiniz. Bu hata, .NET için paket akışının daha yeni paket sürümleriyle yükseltildiği ve daha sonra yeniden denemeniz gerektiği anlamına gelebilir. Yükseltme sırasında paket beslemesi 30 dakikadan uzun süre ulaşılamaz olmamalıdır. Bu hatayı 30 dakikadan uzun bir süre boyunca sürekli alıyorsanız lütfen adresine https://github.com/dotnet/core/issuesbir sorun bildirin.

Bağımlılıklar

Paket yöneticisiyle yüklediğinizde, bu kitaplıklar sizin için yüklenir. Ancak, .NET'i el ile yüklerseniz veya bağımsız bir uygulama yayımlarsanız, uygulamanızı çalıştırmak için şu bağımlılıkları yüklemeniz gerekir:

• ca-certificates
• libc6
• libgcc1 (16.x ve 18.x için)
• libgcc-s1 (20.x veya üzeri için)
• libgssapi-krb5-2
• libicu55 (16.x için)
• libicu60 (18.x için)
• libicu66 (20.x için)
• libicu70 (22.04 için)
• libicu72 (23.10 için)
• libicu74 (24.04 veya üzeri için)
• liblttng-ust1 (22.x veya üzeri için)
• libssl1.0.0 (16.x için)
• libssl1.1 (18.x, 20.x için)
• libssl3 (22.x veya üzeri için)
• libstdc++6
• libunwind8 (22.x veya üzeri için)
• zlib1g

apt install komutuyla bağımlılıklar yüklenebilir. Aşağıdaki parçacık, zlib1g kitaplığının yüklenmesini gösterir.

sudo apt install zlib1g

.NET uygulaması System.Drawing.Common derlemesini kullanıyorsa libgdiplus yüklenmelidir. Daha fazla bilgi için bkz . System.Drawing.Common yalnızca Windows'ta desteklenir.

Mono deposunu sisteminize ekleyerek libgdiplus'ın son sürümünü yükleyebilirsiniz.

Sonraki adımlar

• .NET CLI'ya genel bakış
• .NET CLI için Sekme tamamlamayı etkinleştirme
• Öğretici: Visual Studio Code kullanarak .NET SDK ile konsol uygulaması oluşturma