Aracılığıyla paylaş

macOS'a .NET yükleme

  • Makale

Bu makalede macOS'ta hangi .NET sürümlerinin desteklendiği, .NET'in nasıl yükleneceği ve SDK ile çalışma zamanı arasındaki fark hakkında bilgi verilmektedir.

.NET'in en son sürümü 8'dir.

.NET'i indirin

Desteklenen sürümler

Aşağıdaki tabloda desteklenen .NET sürümleri ve hangi macOS'ta desteklendiği listelenmektedir. .NET sürümü destek sonuna ulaşana veya macOS sürümü artık desteklenmeyene kadar bu sürümler desteklenmeye devam eder.

macOS Sürümü .NET
macOS 15 "Sequoia" 8.0, 6.0
macOS 14 "Sonoma" 8.0, 6.0
macOS 13 "Ventura" 8.0, 6.0

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

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

Çalışma zamanı , .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 Çalışma Zamanı
    ASP.NET Core uygulamalarını çalıştırır. .NET çalışma zamanını içerir. Yükleyici olarak kullanılamaz.

  • .NET Çalışma Zamanı
    Bu işlem normal .NET uygulamaları çalıştırır, ancak ASP.NET Core'da oluşturulan uygulamalar gibi özel uygulamaları çalıştırmaz.

SDK, .NET uygulamaları ve kitaplıkları derlemek ve yayımlamak için kullanılır. En son SDK, .NET'in önceki 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 8.0 yüklüyse, .NET Runtime 8.0 ve ASP.NET Core 8.0 Runtime'ın her ikisi de yüklenir. Ancak, sdk ile başka bir çalışma zamanı sürümü yüklenmez ve ayrı olarak yüklemeniz gerekir.

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

.NET'i yüklemenin farklı yolları vardır ve bazı ürünler kendi .NET sürümlerini yönetebilir. .NET'i kendi .NET sürümünü yöneten bir yazılım aracılığıyla yüklerseniz, sistem genelinde etkinleştirilmemiş olabilir. .NET'i 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ükleyicisi

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

  • Betik ile .NET 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'i el ile yükleme

    .NET'i belirli bir klasöre yüklemeniz ve .NET'in diğer kopyalarından ayrı olarak ç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ün bağlantısını (.NET 8.0 gibi) seçin.

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

    Bu bağlantı sizi .NET'in bu 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ı üst bilgileri kırmızı bir kutuyla vurgulanır. Her kutuda macOS bölümüne işaret eden bir ok vardır.

    Ö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 ikili yükleme aracılığıyla sağlandığından bu bölüm boş.

      İndirme için standart .NET Çalışma Zamanı'nı bulmak için daha aşağı kaydırın.

      .NET indirme web sitesinden yalnızca .NET Çalışma Zamanı indirme tablosunu gösteren ekran görüntüsü. macOS satırı kırmızı bir 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.

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

.NET'i 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ı (.NET 8.0 gibi) seçin.

    Bu bağlantı sizi .NET'in bu 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ı bir 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 dosyalar sütununu arayın.

    SDK indirme bağlantılarını gösteren .NET indirme web sitesi. SDK üst bilgisi kırmızı bir kutuyla vurgulanı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. Tarball'ı sisteminizde .NET'i istediğiniz yere 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'in yüklü olduğu dizini değiştirerek .NET'in çalıştığını test edin ve komutunu çalıştırın dotnet --info :

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

Betik ile .NET yükleme

dotnet-install betikleri, çalışma zamanının otomasyon ve kaydedilmemiş yüklemeleri için kullanılır. Betiği adresinden https://dot.net/v1/dotnet-install.shindirebilirsiniz.

Betik varsayılan olarak .NET 8 olan en son uzun vadeli destek (LTS) sürümünü yükler. Anahtarı belirterek channel belirli bir sürümü seçebilirsiniz. runtime Çalışma zamanı yüklemek için anahtarını ekleyin. Aksi takdirde betik SDK'yı yükler.

İpucu

Bu komutlar, bu yordamın sonunda bir betik parçacığı sağlanır.

  1. Bir terminal açın.

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

  3. Komutunuz wget yoksa Brew ile 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

Klasöre ~/.dotnet gidip komutunu çalıştırarak .NET'i test edin dotnet --info :

chdir ~/.dotnet
./dotnet --info

Önemli

Bazı programlar sisteminizde .NET'i bulmak için ortam değişkenlerini kullanabilir ve yeni bir terminal açılırken komutunun kullanılması dotnet çalışmayabilir. Bu sorunu çözme konusunda yardım için .NET'i sistem genelinde kullanılabilir hale getirme bölümüne bakın.

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 kullanabilir. Ayrıca, henüz yüklü değilse C# Dev Kit uzantısı sizin için .NET'i yükler.

Visual Studio Code aracılığıyla .NET yükleme yönergeleri için bkz . VS Code'da C# kullanmaya başlama.

Noter tasdiki

.NET ile yapılan uygulamalar da dahil olmak üzere, geliştirici kimliğiyle dağıtılan macOS için oluşturulan yazılımların noter onaylı olması gerekir.

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 tasdiklileştirmenin .NET'i (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 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 sağlama toplamı bir metin kutusunda görüntülenir. Sağlama toplamı değerini panonuza kopyalamak için Kopyala düğmesini seçin.

Sağlama toplamı içeren .NET indirme sayfası

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

$ sha512sum dotnet-sdk-8.0.100-linux-x64.tar.gz
13905ea20191e70baeba50b0e9bbe5f752a7c34587878ee104744f9fb453bfe439994d38969722bdae7f60ee047d75dda8636f3ab62659450e9cd4024f38b2a5  dotnet-sdk-8.0.100-linux-x64.tar.gz

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

Önemli

Bu örneklerde bir Linux dosyası gösteriliyor olsa da, bu bilgiler macOS için de aynı şekilde geçerlidir.

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ı indirme ve .NET yükleme ikili dosyasını doğrulama adımları açıklanmaktadır:

  1. GitHub'daki https://github.com/dotnet/core/tree/main/release-notes/8.0#releases .NET 8 sürüm notları sayfasında Releases adlı bir bölüm bulunur. Bu bölümdeki tablo, her .NET 8 sürümü için indirme ve sağlama toplamı dosyalarına bağlanır:

    .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 8.0.0 sürümündeki .NET SDK 8.0.100 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:

    .NET için sağlama toplamları içeren indirme tablosu

  4. Sağlama Toplamı bağlantısına sağ tıklayın ve bağlantıyı panonuza kopyalayın.

  5. Bir terminal açın.

  6. Sağlama toplamı dosyasını indirmek için kullanın curl -O {link} .

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

    curl -O https://dotnetcli.blob.core.windows.net/dotnet/checksums/8.0.0-sha.txt

  7. Hem sağlama toplamı dosyası hem de .NET yayın dosyası aynı dizine indirilirken, indirilen dosyayı doğrulamak için komutunu kullanın sha512sum -c {file} --ignore-missing .

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

    $ sha512sum -c 8.0.0-sha.txt --ignore-missing
dotnet-sdk-8.0.100-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 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

Sorun giderme

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

.NET'i sistem genelinde kullanılabilir hale getirme

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

Bazı uygulamalar .NET'in DOTNET_ROOT yüklü olduğu yeri belirlemeye çalışırken değişkeni arayabilir.

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

  • Bash Kabuğu: ~/.profile, /etc/profile
  • Korn Kabuğu: ~/.kshrc veya .profile
  • Z Kabuğu: ~/.zshrc veya .zprofile

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

  • DOTNET_ROOT

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

    export DOTNET_ROOT=$HOME/.dotnet

  • PATH

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

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

Arm tabanlı Mac'ler

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

.NET Sürümleri

Aşağıdaki tabloda Arm tabanlı Mac'te hangi .NET sürümlerinin desteklendiği açıklanmaktadır:

.NET Sürümü SDK Çalışma Zamanı Yol çakışması
8 Yes Evet Hayır
8 Yes Evet Hayır
6 Yes Evet Hayır
6 Yes Evet Hayır

.NET SDK'sının x64 ve Arm64 sürümleri birbirinden bağımsız olarak mevcuttur. Yeni bir sürüm yayınlanırsa, her yüklemenin yükseltilmesi gerekir.

Yol farklılıkları

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

Yol çakışmaları

x64 .NET SDK'sı, önceki bölümde açıklandığı gibi kendi dizinine yüklenir. Bu, .NET SDK'sının Arm64 ve x64 sürümlerinin aynı makinede var olmasını sağlar. Bununla birlikte, .NET 6 öncesi herhangi bir x64 SDK'sı desteklenmez ve Arm64 sürümü olan /usr/local/share/dotnet/ klasörüyle aynı konuma yüklenir. Desteklenmeyen bir x64 SDK'sını yüklemek istiyorsanız, önce Arm64 sürümünü kaldırmanız gerekir. Bunun tersi de geçerlidir; Arm64 sürümünü yüklemek için desteklenmeyen x64 SDK'sını kaldırmanız gerekir.

Yol değişkenleri

.NET 6 SDK'sının PATH hem x64 hem de Arm64 sürümleri yüklüyse, .NET'i sistem yoluna ekleyen ortam değişkenlerinin (değişken gibi) değiştirilmesi gerekebilir. Ayrıca, bazı araçlar ortam değişkenine dayanır ve bu değişkenin DOTNET_ROOT uygun .NET 6 SDK yükleme klasörüne işaret edecek şekilde güncelleştirilmiş olması gerekir.

System.Drawing.Common ve libgdiplus

Derlemeyi kullanan .NET uygulamalarının System.Drawing.Common yüklenmesi gerekir libgdiplus .

Elde libgdiplus etmenin kolay bir yolu, macOS için Homebrew ("brew") paket yöneticisini kullanmaktır. Brew yükledikten sonra terminalde aşağıdaki komutları çalıştırarak yükleyinlibgdiplus:

brew update
brew install mono-libgdiplus

İlgili içerik