Aracılığıyla paylaş


Yükleme betiği kullanarak veya ikili dosyaları ayıklayarak Linux'a .NET yükleme

Bu makalede, yükleme betiğini kullanarak veya ikili dosyaları ayıklayarak Linux'ta .NET SDK'sının veya .NET Çalışma Zamanı'nın nasıl yükleneceği gösterilmektedir. Yerleşik paket yöneticisini destekleyen dağıtımların listesi için bkz. Linux üzerinde .NET yükleme.

.NET uygulamaları geliştirmek istiyorsanız SDK'yi (çalışma zamanını içerir) yükleyin. Ya da yalnızca uygulamaları çalıştırmanız gerekiyorsa Çalışma Zamanı'nı yükleyin. Çalışma Zamanını yüklüyorsanız hem .NET hem de ASP.NET Core çalışma zamanlarını içerdiğinden ASP.NET Core Runtime yüklemenizi öneririz.

Hangi sürümlerin yüklü olduğunu görmek için dotnet --list-sdks ile dotnet --list-runtimes komutlarını kullanın. Daha fazla bilgi için bkz. .NET zaten yüklü olup olmadığını denetleme.

.NET sürümleri

İki tür desteklenen sürüm vardır: Uzun Süreli Destek (LTS) ve Standart Terim Desteği (STS). Tüm sürümlerin kalitesi aynıdır. Tek fark desteğin uzunluğudur. LTS sürümleri üç yıl boyunca ücretsiz destek ve yamalar alır. STS sürümleri iki yıl boyunca ücretsiz destek ve yamalar alır. Daha fazla bilgi için bkz. .NET Destek İlkesi.

Aşağıdaki tabloda, .NET (ve .NET Core) her sürümünün destek durumu listelenir:

✔️ Destekli ❌ Destek dışı
10 (LTS) 7
9 (STS) 6
8 (LTS) 5
3.1
3.0
2.2
2.1
2.0
1.1
1.0

Bağımlılıklar

.NET'i yüklediğinizde, özellikle manuel olarak yükleme yapıyorsanız, belirli bağımlılıklar yüklenmeyebilir. Aşağıdaki listede, Microsoft tarafından desteklenen ve yüklemeniz gerekebilecek bağımlılıkları olan Linux dağıtımları açıklanır. Daha fazla bilgi için dağıtım sayfasına bakın:

Bağımlılıklar hakkında genel bilgi için bkz . Bağımsız Linux uygulamaları.

RPM bağımlılıkları

Dağıtımınız daha önce listelenmemişse ve RPM tabanlıysa aşağıdaki bağımlılıklara ihtiyacınız olabilir:

  • glibc
  • libgcc
  • CA sertifikaları
  • openssl-libs
  • libstdc++
  • libicu
  • tzdata
  • krb5-libs

DEB bağımlılıkları

Dağıtımınız daha önce listelenmemişse ve debian tabanlıysa aşağıdaki bağımlılıklara ihtiyacınız olabilir:

  • libc6
  • libgcc1
  • libgssapi-krb5-2
  • libicu70
  • libssl3
  • libstdc++6
  • zlib1g

Yazılımla yükleme

dotnet-install betikleri, SDK ve Çalışma Zamanı'nın otomasyon ve yönetici olmayan yüklemeleri için kullanılır. Betiği https://dot.net/v1/dotnet-install.sh adresinden indirebilirsiniz. .NET bu şekilde yüklendiğinde, Linux dağıtımınız için gereken bağımlılıkları yüklemeniz gerekir. Linux dağıtımınız için Linux'ta .NET yükleme makalesindeki bağlantıları kullanın.

Önemli

Betiği çalıştırmak için Bash gereklidir.

wget kullanarak betiği indirebilirsiniz:

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

Veya ile: curl

curl -L https://dot.net/v1/dotnet-install.sh -o dotnet-install.sh

Bu betiği çalıştırmadan önce, bu betiğin yürütülebilir dosya olarak çalışması için izin verdiğinden emin olun:

chmod +x ./dotnet-install.sh

Betik, varsayılan olarak en son uzun süreli destek (LTS) SDK sürümünü, .NET 10'u yükler. (LTS) sürümü olmayan en son sürümü yüklemek için parametresini --version latest kullanın.

./dotnet-install.sh --version latest

SDK yerine .NET Çalışma Zamanı yüklemek için --runtime parametresini kullanın.

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

Belirli bir ana sürümü yüklemek için --channel parametresiyle belirli bir sürümü belirtebilirsiniz. Aşağıdaki komut .NET 9.0 SDK'sını yükler.

./dotnet-install.sh --channel 9.0

Daha fazla bilgi için dotnet-install betiklerine referans bakın.

Komut satırında .NET etkinleştirmek için bkz. Ortam değişkenlerini sistem genelinde ayarlama.

.NET CLI'yı kullanmayı öğrenmek için bkz. .NET CLI'ya genel bakış.

El ile yükleme

Paket yöneticilerine alternatif olarak SDK'yı ve çalışma zamanını indirip el ile yükleyebilirsiniz. El ile yükleme yaygın olarak sürekli tümleştirme testinin bir parçası olarak veya desteklenmeyen bir Linux dağıtımında kullanılır. Bir geliştirici veya kullanıcı için paket yöneticisi kullanmak daha iyidir.

Aşağıdaki sitelerden birinden çalışma ortamı veya SDK için ikili sürümü indirin. .NET SDK'sı ilgili çalışma zamanını içerir:

İndirilen dosyayı ayıklayın ve export komutunu kullanarak DOTNET_ROOT ayıklanan klasörün konumuna ayarlayın ve .NET PATH içinde olduğundan emin olun. DOTNET_ROOT dışarı aktarmak, .NET CLI komutlarının terminalde kullanılabilir olmasını sağlar. .NET ortam değişkenleri hakkında daha fazla bilgi için bkz. .NET SDK ve CLI ortam değişkenleri.

.NET farklı sürümleri, yan yana bulunan aynı klasöre ayıklanabilir.

Örnek

Aşağıdaki komutlar, ortam değişkenini DOTNET_ROOT geçerli çalışma dizinine ve ardından .dotnetöğesine ayarlamak için Bash kullanır. Eğer mevcut değilse o dizin oluşturulur. DOTNET_FILE ortam değişkeni, yüklemek istediğiniz .NET ikili sürümünün dosya adıdır. Bu dosya DOTNET_ROOT dizinine çıkarılır. DOTNET_ROOT dizini ve tools alt dizini, PATH ortam değişkenine eklenir.

Önemli

Bu komutları çalıştırırsanız, DOTNET_FILE değerini indirdiğiniz .NET ikili dosyasının adıyla değiştirmeyi unutmayın.

DOTNET_FILE=dotnet-sdk-9.0.306-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

Aynı klasöre birden fazla .NET sürümü yükleyebilirsiniz.

ayrıca HOME değişkeni veya ~ yolu tarafından tanımlanan giriş dizinine .NET yükleyebilirsiniz:

export DOTNET_ROOT=$HOME/.dotnet

.NET CLI'yı kullanmayı öğrenmek için bkz. .NET CLI'ya genel bakış.

İndirilen ikili dosyaları doğrulama

Yükleyiciyi veya ikili sürümü indirdikten sonra dosyanın değiştirilmediğinden veya bozulmadığından emin olmak için dosyayı doğrulayın. Bilgisayarınızda sağlama toplamını doğrulayabilir ve ardından indirme web sitesinde bildirilenlerle karşılaştırabilirsiniz.

Dosyayı resmi bir indirme sayfasından indirdiğinizde, dosyanın doğrulama toplamı bir metin kutusunda görüntülenir. Sağlama toplamı değerini panonuza kopyalamak için Kopyala düğmesini seçin.

Özet kontrolü (checksum) içeren .NET indirme sayfası

İndirdiğiniz dosyanın sağlama toplamını yazdırmak için sha512sum komutunu kullanın. Örneğin, aşağıdaki komut dotnet-sdk-9.0.306-linux-x64.tar.gz dosyasının sağlama toplamını bildirir:

$ sha512sum dotnet-sdk-9.0.306-linux-x64.tar.gz
bbb6bdc3c8048e7cc189759b406257839e7d4bd6b8b1ba4bcdaeea8f92340e6855231043dd73f902130ca5357af72b810bb51a4da4d1315a2927ff85f831f1d5  dotnet-sdk-9.0.306-linux-x64.tar.gz

Sağlama toplamını indirme sitesi tarafından sağlanan değerle karşılaştırın.

Doğrulamak için sağlama toplamı dosyası kullanma

.NET sürüm notları, indirilen dosyanızı doğrulamak için kullanabileceğiniz sağlama toplamı dosyasının bağlantısını içerir. Aşağıdaki adımlarda sağlama toplamı dosyasını indirip bir .NET kurulum ikilisine doğrulamak için izlenmesi gereken adımlar açıklanmaktadır:

  1. https://github.com/dotnet/core/tree/main/release-notes/9.0#releases GitHub .NET 9 sürüm notları sayfasında Releases adlı bir bölüm bulunur. Bu bölümdeki tablo, her .NET 9 sürümü için indirme ve kontrol toplamı dosyalarına bağlantılar sağlar. Aşağıdaki görüntüde .NET 8 sürüm tablosu başvuru olarak gösterilmektedir:

    .NET için GitHub sürüm notları sürüm tablosu

  2. İndirdiğiniz .NET sürümünün bağlantısını seçin.

    Önceki bölümde, .NET 9.0.10 sürümünde yer alan .NET SDK 9.0.306 kullanılmıştır.

  3. Yayın sayfasında .NET Çalışma Zamanı ve .NET SDK sürümünü ve sağlama toplamı dosyasının bağlantısını görebilirsiniz. Aşağıdaki görüntüde .NET 8 sürüm tablosu başvuru olarak gösterilmektedir:

    Sağlama toplamları içeren .NET indirme tablosu

  4. Checksum bağlantısına sağ tıklayın ve panoya kopyalayın.

  5. Bir terminal açın.

  6. curl -O {link} kullanarak sağlama toplamı dosyasını indirin.

    Aşağıdaki komuttaki bağlantıyı kopyaladığınız bağlantıyla değiştirin.

    curl -O https://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt
    
  7. Hem sağlama toplamı dosyası hem de .NET yayın dosyası aynı dizine indirilirken, indirilen dosyayı doğrulamak için sha512sum -c {file} --ignore-missing komutunu kullanın.

    Doğrulama başarılı olduğunda dosyanın Tamam durumuyla yazdırıldığını görürsünüz:

    $ sha512sum -c 9.0.10-sha.txt --ignore-missing
    dotnet-sdk-9.0.306-linux-x64.tar.gz: OK
    

    BAŞARıSıZ olarak işaretlenmiş bir dosya görürseniz, indirdiğiniz dosya geçerli değildir ve kullanılmamalıdır.

    $ sha512sum -c 9.0.10-sha.txt --ignore-missing
    dotnet-sdk-9.0.306-linux-x64.tar.gz: FAILED
    sha512sum: WARNING: 1 computed checksum did NOT match
    sha512sum: 9.0.10-sha.txt: no file was verified
    

Sistem genelinde ortam değişkenlerini ayarlama

Önceki yükleme betiğini kullandıysanız, ayarlanan değişkenler yalnızca geçerli terminal oturumunuza uygulanır. Bunları kabuk profilinize ekleyin. Linux için kullanılabilen birçok farklı kabuk vardır ve her birinin farklı bir profili vardır. Örneğin:

  • Bash Kabuğu: ~/.bash_profile veya ~/.bashrc
  • Korn Shell: ~/.kshrc ya da .profile
  • Z Shell: ~/.zshrc veya .zprofile

Kabuk profilinizde aşağıdaki iki ortam değişkenini ayarlayın:

  • DOTNET_ROOT

    Bu değişken, $HOME/.dotnet gibi .NET yüklendiği klasöre ayarlanır:

    export DOTNET_ROOT=$HOME/.dotnet
    
  • PATH

    Bu değişken hem klasörü DOTNET_ROOT hem de DOTNET_ROOT/tools klasörü içermelidir:

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

Sonraki adımlar