Aracılığıyla paylaş

macOS'a .NET yükleme

Bu makalede macOS'ta hangi .NET sürümlerinin desteklendiği, .NET nasıl yükleneceği ve SDK ile çalışma zamanı arasındaki farkın ne olduğu öğretilir.

.NET en son sürümü 10'dur.

İndir .NET

Desteklenen sürümler

Aşağıdaki tabloda desteklenen .NET sürümleri ve hangi macOS'ta desteklendiği listelenmektedir. Bu sürümler, .NET sürümünün desteği sona erene veya macOS sürümü artık desteklenmeyene kadar desteklenir.

macOS Sürümü .NET
macOS 26 "Tahoe" 10.0, 9.0, 8.0
macOS 15 "Sequoia" 10.0, 9.0, 8.0
macOS 14 "Sonoma" 9.0, 8.0

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

Çalışma zamanı veya SDK

runtime .NET ile oluşturulan uygulamaları çalıştırmak için kullanılır. Uygulama yazarı bir uygulama yayımladığında, çalışma zamanını kendi uygulamasına ekleyebilir. Çalışma zamanını içermiyorlarsa, doğru çalışma zamanını yüklemek kullanıcıya aittir.

macOS'a yükleyebileceğiniz iki çalışma zamanı vardır ve her ikisi de SDK'ya dahildir.

  • ASP.NET Core Runtime
    ASP.NET Core uygulamaları çalıştırır. .NET çalışma zamanını içerir. Yükleyici olarak kullanılamaz.

  • .NET Runtime
    Bu, normal .NET uygulamaları çalıştırır, ancak ASP.NET Core üzerinde oluşturulan uygulamalar gibi özel uygulamalar çalışmaz.

SDK .NET uygulamaları ve kitaplıkları oluşturmak ve yayımlamak için kullanılır. En son SDK, önceki .NET sürümleri için uygulama derlemeyi destekler. Normal koşullarda yalnızca en son SDK'nın yüklü olması gerekir.

SDK'nın yüklenmesi hem standart .NET Çalışma Zamanı'nı hem de ASP.NET Core Çalışma Zamanı'nı içerir. Örneğin, .NET SDK 9.0 yüklüyse, .NET Çalışma Zamanı 9.0 ve ASP.NET Core 9.0 Çalışma Zamanı da yüklüdür. Ancak, başka bir çalışma zamanı sürümü SDK ile birlikte yüklenmeyecektir ve onu ayrı olarak yüklemeniz gerekecektir.

.NET nasıl yükleneceğini seçme

.NET yüklemenin farklı yolları vardır ve bazı ürünler kendi .NET sürümünü yönetebilir. .NET kendi .NET sürümünü yöneten yazılım aracılığıyla yüklerseniz, sistem genelinde etkinleştirilmemiş olabilir. .NET diğer yazılımlar aracılığıyla yüklemenin etkilerini anladığınızdan emin olun.

Aşağıdaki bölümlerde yer alan listeleri gözden geçirdikten sonra hangi yöntemi seçmeniz gerektiğine emin değilseniz, büyük olasılıkla .NET Installer paketini kullanmak istersiniz.

Geliştiriciler

  • Visual Studio Code - C# Geliştirme Seti

    .NET uygulamaları geliştirmek için Visual Studio Code için C# Dev Kit uzantısını yükleyin. Uzantı önceden yüklenmiş bir SDK kullanabilir veya sizin için bir SDK yükleyebilir.

Kullanıcılar ve Geliştiriciler

  • .NET Yükleyici

    .NET yüklemek için tek başına yükleyiciyi kullanın. Bu yöntem, geliştiricinize veya kullanıcı makinenize .NET yüklemenin tipik yoludur.

  • .NET betikle yükleme

    SDK veya Çalışma Zamanı yüklemesini otomatikleştirebilen bir bash betiği. Hangi .NET sürümünün yükleneceğini seçebilirsiniz.

  • .NET el ile yükleme

    belirli bir klasöre .NET yüklemeniz ve .NET diğer kopyalarından ayrı çalıştırmanız gerektiğinde bu yükleme yöntemini kullanın.

.NET yükleme

Yükleyici paketleri, .NET yüklemenin kolay bir yolu olan macOS için kullanılabilir.

  1. Bir tarayıcıyı açın ve https://dotnet.microsoft.com/download/dotnet dizinine gidin.

  2. Yüklemek istediğiniz .NET sürümün bağlantısını seçin( örneğin, .NET 10.0.

    .NET indirme web sitesi. 6.0 ile 9.0 arasında sürümler listelenir. Kırmızı kutu bu indirme bağlantılarını vurgular.

    Bu bağlantı sizi bu .NET sürümünü indirmek için bağlantılar içeren sayfaya getirir

    SDK'yı yükleyecekseniz en son .NET sürümünü seçin. SDK, .NET'in önceki sürümleri için uygulama derlemeyi destekler.

    İpucu

    Hangi sürümü indirebileceğinizden emin değilseniz en son olarak işaretlenmiş sürümü seçin.

  3. Bu sayfada SDK ve Çalışma Zamanı için indirme bağlantıları sunulur. Burada .NET SDK'sını veya .NET Çalışma Zamanı'nı indirebilirsiniz.

    SDK ve Çalışma Zamanı indirme bağlantılarını gösteren .NET indirme web sitesi. SDK ve Çalışma Zamanı başlıkları kırmızı bir kutu ile vurgulanmıştır. Her kutuda, macOS bölümüne işaret eden bir ok bulunur.

    Önceki resimde vurgulanmış iki bölüm vardır. SDK'yı indiriyorsanız 1. bölüme bakın. .NET Çalışma Zamanı için bölüm 2'ye bakın.

    • Bölüm 1 (SDK)

      Bu bölüm SDK indirme alanıdır. macOS satırının Yükleyiciler sütununda iki mimari listelenir: Arm64 ve x64.

      • M1 veya M3 Pro gibi bir Apple işlemci çalıştırıyorsanız Arm64'i seçin.
      • Intel işlemci çalıştırıyorsanız x64'i seçin.

    • Bölüm 2 (Çalışma Zamanı)

      Bu bölüm çalışma zamanı indirmelerini içerir. macOS satırındaki Yükleyiciler sütununun bağlantılarının boş olduğuna dikkat edin! ASP.NET Core Runtime yalnızca SDK'da veya binary yüklemesi aracılığıyla sağlandığından bu bölüm boş.

      Daha aşağı kaydırarak standart .NET Runtime indirme bağlantısını bulun.

      .NET indirme web sitesindeki yalnızca .NET Çalışma Zamanı indirme tablosunu gösteren ekran görüntüsü. macOS satırı kırmızı kutuyla vurgulanır.

      • M1 veya M3 Pro gibi bir Apple işlemci çalıştırıyorsanız Arm64'i seçin.
      • Intel işlemci çalıştırıyorsanız x64'i seçin.

  4. İndirme işlemi tamamlandıktan sonra açın.

  5. Yükleyici'deki adımları izleyin.

    macOS üzerinde çalışan .NET yükleyicisini gösteren bir ekran görüntüsü.

.NET el ile yükleme

macOS yükleyicilerine alternatif olarak SDK'yı ve çalışma zamanını indirip el ile yükleyebilirsiniz. El ile yükleme genellikle sürekli tümleştirme senaryosunda parça otomasyonu olarak gerçekleştirilir. Geliştiriciler ve kullanıcılar genellikle yükleyiciyi kullanmak ister.

İpucu

Bu adımları otomatik olarak gerçekleştirmek için install-dotnet.sh betiğini kullanın.

  1. Bir tarayıcıyı açın ve https://dotnet.microsoft.com/download/dotnet dizinine gidin.

  2. yüklemek istediğiniz .NET sürümünün bağlantısını seçin( örneğin, .NET 8.0.

    Bu bağlantı sizi bu .NET sürümünü indirmek için bağlantılar içeren sayfaya getirir

    SDK'yı yükleyecekseniz en son .NET sürümünü seçin. SDK, .NET'in önceki sürümleri için uygulama derlemeyi destekler.

    İpucu

    Hangi sürümü indirebileceğinizden emin değilseniz en son olarak işaretlenmiş sürümü seçin.

    .NET indirme web sitesi. 6.0 ile 9.0 arasında sürümler listelenir. Kırmızı kutu bu indirme bağlantılarını vurgular.

  3. Yüklemek istediğiniz SDK veya Çalışma Zamanı bağlantısını seçin. macOS satırında İkili sütununu arayın.

    .NET SDK indirme bağlantılarını gösteren web sitesi. SDK başlığı kırmızı bir kutu ile vurgulanmıştır. Kutuda, macOS bölümüne işaret eden bir ok vardır.

    • M1 veya M3 Pro gibi bir Apple işlemci çalıştırıyorsanız Arm64'i seçin.
    • Intel işlemci çalıştırıyorsanız x64'i seçin.

  4. Bir terminal açın ve .NET ikili dosyasının indirildiği yere gidin.

  5. Sisteminizde .NET için istediğiniz yere tarball'ı ayıklayın. Aşağıdaki örnek, HOME dizinini ~/Applications/.dotnetkullanır.

    mkdir -p ~/Applications/.dotnet
tar -xf "dotnet-sdk-9.0.100-rc.2.24474.11-osx-arm64.tar" -C ~/Applications/.dotnet/

.NET yüklendiği dizini değiştirerek .NET çalıştığını test edin ve dotnet --info komutunu çalıştırın:

chdir ~/Applications/.dotnet/
./dotnet --info

Komut dosyası ile .NET'i yükleme.

dotnet-install betikleri, çalışma zamanını otomatikleştirme ve yönetici ayrıcalıkları olmadan yükleme yapmak için kullanılır. Betiği bu adresten https://dot.net/v1/dotnet-install.sh indirebilirsiniz.

Betik, varsayılan olarak .NET 8 uzun dönem desteği (LTS) sürümünü yükler. channel anahtarını belirterek belirli bir sürümü seçebilirsiniz. runtime anahtarını ekleyerek bir çalışma zamanı yükleyin. Aksi takdirde betik SDK'yı yükler.

İpucu

Bu komutlar, bu prosedürün sonunda bir betik parçacığı sunulmuştur.

  1. Bir terminal açın.

  2. Betiği indirmek istediğiniz ~/downloads gibi bir klasöre gidin.

  3. Eğer wget komutu yoksa, Brew ile onu yükleyin

    brew install wget

  4. Betiği indirmek için aşağıdaki komutu çalıştırın:

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

  5. Betik yürütme izinlerini verme

    chmod +x dotnet-install.sh

  6. .NET yüklemek için betiği çalıştırın.

    Betik varsayılan olarak dizine en son SDK'nın yüklenmesini sağlar ~/.dotnet .

    ./dotnet-install.sh

Tek bir bash betiği olarak tüm komutlar şunlardır:

chdir ~/Downloads
brew install wget
wget https://dot.net/v1/dotnet-install.sh
chmod +x dotnet-install.sh
./dotnet-install.sh

~/.dotnet klasörüne gidip dotnet --info komutunu çalıştırarak .NET test edin:

chdir ~/.dotnet
./dotnet --info

Önemli

Bazı programlar, sisteminizdeki .NET bulmak için ortam değişkenlerini kullanabilir ve yeni bir terminal açılırken dotnet komutunu kullanmak çalışmayabilir. Bu sorunu çözme konusunda yardım için bkz. Make .NET kullanılabilir sistem genelinde bölümü.

Visual Studio Code için .NET yükleme

Visual Studio Code, masaüstünüzde çalışan güçlü ve basit bir kaynak kodu düzenleyicisidir. Visual Studio Code sisteminizde zaten yüklü olan SDK'yi kullanabilirsiniz. Ayrıca C# Dev Kit uzantısı henüz yüklü değilse sizin için .NET yükler.

Visual Studio Code aracılığıyla .NET yükleme yönergeleri için bkz. VS Code'da C# ile Çalışmaya Başlama.

Noter onayı

MacOS için oluşturulan ve Geliştirici Kimliği ile dağıtılan yazılımlar, .NET ile yapılan uygulamalar da dahil olmak üzere noter onaylı olmalıdır.

Noter onaylı olmayan bir uygulama çalıştırırsanız aşağıdaki görüntüye benzer bir hata penceresi görüntülenir:

macOS Catalina noter tasdiki uyarısı

Zorunlu noter tasdik işleminin .NET (ve .NET uygulamalarınızı) nasıl etkilediği hakkında daha fazla bilgi için bkz. MacOS Catalina Notarization ile çalışma.

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 kontrol toplamını doğrulayabilir ve ardından indirme sitesinde bildirilenlerle karşılaştırabilirsiniz.

Dosyayı resmi bir indirme sayfasından indirdiğinizde, dosyanın sağlama 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 shasum -a 512 komutunu kullanın. Örneğin, aşağıdaki komut dotnet-sdk-9.0.306-osx-x64.tar.gz dosyasının sağlama toplamını bildirir:

$ shasum -a 512 dotnet-sdk-9.0.306-osx-x64.tar.gz
a9700f98e5aa4f70b2a08ddba2b1c6085106b0d17828bd719fdcef460b06c890b32d752fbff8e4659cd1ca4174b4b211b301fe682439ea9a24b6521ca5a64c69  dotnet-sdk-9.0.306-osx-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 shasum -a 512 -c {file} komutunu kullanın.

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

    $ shasum -a 512 -c 9.0.10-sha.txt
dotnet-sdk-9.0.306-osx-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.

    $ shasum -a 512 -c 9.0.10-sha.txt
dotnet-sdk-9.0.306-osx-x64.tar.gz: FAILED
shasum: WARNING: 1 computed checksum did NOT match

Arm tabanlı Mac'ler

Aşağıdaki bölümlerde Arm tabanlı Mac'e .NET yüklerken dikkate almanız gerekenler açıklanmaktadır.

Yol farklılıkları

Arm tabanlı Mac'te, .NET tüm Arm64 sürümleri normal /usr/local/share/dotnet/ klasörüne yüklenir. Ancak, .NET SDK'nın x64 sürümünü yüklediğinizde, /usr/local/share/dotnet/x64/dotnet/ klasörüne yüklenir.

Yol değişkenleri

.NET SDK'sının hem x64 hem de Arm64 sürümleri yüklüyse, PATH değişkeni gibi sistem yoluna .NET ekleyen ortam değişkenlerinin değiştirilmesi gerekebilir. Ayrıca bazı araçlar DOTNET_ROOT ortam değişkenini de kullanarak uygun .NET SDK yükleme klasörüne işaret edecek şekilde güncelleştirilecektir.

Sorun giderme

Sorunları gidermeye yardımcı olmak için aşağıdaki bölümler kullanılabilir:

.NET sistem genelinde kullanılabilir hale getirme

Bazen terminal de dahil olmak üzere sisteminizdeki uygulamaların .NET yüklendiği yeri bulması gerekir. .NET macOS Yükleyici paketi sisteminizi otomatik olarak yapılandırmalıdır. Ancak, manual yükleme yöntemini veya .NET yükleme betiğini kullandıysanız, .NET yüklü olduğu dizini PATH değişkenine eklemeniz gerekir.

Bazı uygulamalar, .NET nereye yüklendiğini belirlemeye çalışırken DOTNET_ROOT değişkenini arayabilir.

macOS için kullanılabilen birçok farklı kabuk vardır ve her birinin farklı bir profili vardır. Örneğin:

  • Bash Shell: ~/.profile, /etc/profile
  • 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

İlgili içerik

  • Last updated on