Windows'a .NET yükleme

Bu makalede Windows'da hangi .NET sürümlerinin desteklendiği, .NET'in nasıl yükleneceği ve SDK ile çalışma zamanı arasındaki farklar öğretilir.

.NET Framework'ün aksine. .NET, Windows sürümünüzle bağlantılı değildir. Windows'ta yalnızca tek bir .NET Framework sürümü yüklü olabilir. Ancak .NET tek başınadır ve bilgisayarınızda herhangi bir yere yüklenebilir. Bazı uygulamalar kendi .NET kopyalarını içerebilir.

Varsayılan olarak, yükleme yöntemi farklı bir dizin seçmediği sürece .NET bilgisayarınızdaki Program Files\dotnet dizinine yüklenir.

.NET, çalışma zamanı ve SDK'lardan oluşur. Çalışma zamanı .NET uygulamaları çalıştırır ve SDK, uygulama oluşturmak için kullanılır.

Doğru çalışma zamanını seçme

Windows için farklı uygulama türlerinin çalıştırılmasını sağlayan üç farklı çalışma zamanı vardır. SDK üç çalışma zamanını da içerir ve çalışma zamanı yükleyicisi ek çalışma zamanı içerebilir. Aşağıdaki tabloda belirli bir .NET yükleyicisine hangi çalışma zamanının dahil olduğu açıklanmaktadır:

Windows'ta tüm .NET uygulamalarını çalıştırabilmenizi sağlamak için hem ASP.NET Core Runtime'ı hem de .NET Desktop Runtime'ı yükleyin. ASP.NET Core Runtime web tabanlı uygulamalar, .NET Desktop Runtime ise Windows Presentation Foundation (WPF) veya Windows Forms uygulaması gibi masaüstü uygulamaları çalıştırır.

.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 Yükleyicisi'ni kullanmak istersiniz.

Geliştiriciler

• Visual Studio

  Visual Studio kullanarak .NET uygulamaları geliştirmek istediğinizde .NET yüklemek için Visual Studio'yu kullanın. Visual Studio kendi .NET kopyasını yönetir. Bu yöntem SDK, Çalışma Zamanı ve Visual Studio şablonlarını yükler.

• 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ı, sizin için zaten yüklü bir SDK kullanabilir veya bir SDK yükleyebilir.

Kullanıcılar ve Geliştiriciler

• .NET Yükleyicisi

  .NET'i çalıştırdığınız yürütülebilir bir Windows Installer paketiyle yükleyin. Bu yöntem SDK ve Çalışma Zamanı'nı yükleyebilir. Yüklemeler sistem genelinde gerçekleştirilir.

• Windows Paket Yöneticisi (WinGet)

  .NET'i komut satırı aracılığıyla yönetmek istediğinizde .NET'i yüklemek için WinGet kullanın. Bu yöntem SDK ve Çalışma Zamanı'nı yükleyebilir. Yüklemeler sistem genelinde gerçekleştirilir.

• PowerShell

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

Desteklenen sürümler

Aşağıdaki tablo, şu anda desteklenen .NET sürümlerinin ve desteklendiği Windows sürümlerinin listesidir. .NET sürümü destek sonuna ulaşana veya Windows sürümü kullanım süresi sonuna ulaşana kadar bu sürümler desteklenmektedir.

Windows 10 sürümleri hizmet sonu tarihleri sürüme göre segmentlere ayrılmıştır. Aşağıdaki tabloda yalnızca Home, Pro, Pro Education ve Pro for Workstations sürümleri dikkate alınır. Belirli ayrıntılar için Windows yaşam döngüsü bilgi sayfasına bakın.

Windows 7 / 8.1 / Server 2012

Windows 7 ve Windows 8.1 yalnızca .NET 6'ı destekler. Ancak.NET 6, 12 Kasım 2024'den itibaren destek dışıdır.

Windows Server 2012 hala destekte olan herhangi bir .NET sürümü tarafından desteklenmektedir.

Windows'un bu üç sürümünün de yüklenmesi için daha fazla bağımlılık gerekir:

Aşağıdaki dll'lerden biriyle ilgili bir hata alırsanız önceki gereksinimler de gereklidir:

• api-ms-win-crt-runtime-l1-1-0.dll
• api-ms-win-cor-timezone-l1-1-0.dll
• hostfxr.dll

Arm tabanlı Windows bilgisayarları

.NET, Arm tabanlı Windows bilgisayarlarında desteklenir. Aşağıdaki bölümlerde.NET'i yüklerken dikkate almanız gerekenler açıklanmaktadır.

SDK farklılıkları

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

Yol farklılıkları

Arm tabanlı bir Windows bilgisayarda, .NET'in tüm Arm64 sürümleri normal C:\Program Files\dotnet\ klasörüne yüklenir. Ancak, .NET SDK'sının x64 sürümü C:\Program Files\dotnet\x64\ 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, .NET'i sistem yoluna ekleyen ortam değişkenlerinin (değişken gibi PATH ) değiştirilmesi gerekebilir. Ayrıca, bazı araçlar ortam değişkenine dayanır ve bu değişkenin DOTNET_ROOT uygun .NET SDK yükleme klasörüne işaret edecek şekilde güncelleştirilmiş olması gerekir.

Visual Studio ile yükleme

Visual Studio, .NET'in diğer kopyalarından ayrı olarak kendi .NET kopyasını yükler. Visual Studio'nun farklı sürümleri farklı .NET sürümlerini destekler. Visual Studio'nun en son sürümü her zaman .NET'in en son sürümünü destekler.

Visual Studio Yükleyicisi Visual Studio'yu yükler ve yapılandırr. Bazı Visual Studio iş yükleri ASP.NET ve web geliştirme ve .NET Çok platformlu Uygulama kullanıcı arabirimi geliştirme gibi .NET'i içerir. .NET'in belirli sürümleri Tek Tek Bileşenler sekmesi aracılığıyla yüklenebilir.

Visual Studio belgelerinde aşağıdakiler hakkında yönergeler sağlanır:

• Visual Studio'yu yükleyin.
• Visual Studio iş yüklerini yapılandırın.

.NET Sürümleri ve Visual Studio

.NET uygulamaları geliştirmek için Visual Studio kullanıyorsanız, aşağıdaki tabloda visual studio'nun hedef .NET SDK sürümüne göre gereken en düşük sürümü açıklanmaktadır.

Visual Studio zaten yüklüyse, aşağıdaki adımlarla sürümünüzü de kontrol edebilirsiniz.

1. Visual Studio'yu açın.
2. Microsoft Visual Studio Hakkında Yardım'ı>seçin.
3. Hakkında iletişim kutusunda sürüm numarasını okuyun.

Hakkında daha fazla bilgi için bkz . .NET SDK, MSBuild ve Visual Studio sürüm oluşturma.

Visual Studio Code ile 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.

.NET Yükleyicisi

.NET'in indirme sayfasında Windows Installer yürütülebilir dosyaları sağlanır.

1. Bir web tarayıcısı açın ve https://dotnet.microsoft.com/download/dotnet sayfasına gidin.

2. İndirmek istediğiniz .NET sürümünü (örneğin, 8.0) seçin.

3. .NET indirme bağlantılarını içeren SDK veya Çalışma Zamanı kutusunu bulun.

4. Yükleyiciler sütununun altında Windows satırını bulun ve CPU mimarinizin bağlantısını seçin. Emin değilseniz en yaygın olan x64'i seçin.

   Tarayıcı yükleyiciyi otomatik olarak indirmelidir.

   İpucu

   Aşağıdaki görüntüde SDK gösterilmektedir, ancak Çalışma Zamanı'nı da indirebilirsiniz.

   

5. Windows Gezgini'ni açın ve dosyanın indirildiği yere, büyük olasılıkla İndirilenler klasörünüze gidin.

6. .NET yüklemek için dosyaya çift tıklayın.

   Windows Installer iletişim kutusu açılır.

   

7. Yükle'yi seçin ve .NET'i yüklemek için yönergeleri izleyin.

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

Komut satırı seçenekleri

Seçeneklerin /? listesini görüntülemek için parametresini kullanın.

.NET'i bir üretim ortamında olduğu gibi sessizce yüklemek veya sürekli tümleştirmeyi desteklemek istiyorsanız aşağıdaki seçenekleri kullanın:

• /install
  .NET'i yükler.

• /quiet
  Tüm kullanıcı arabirimi ve istemlerin görüntülenmesini engeller.

• /norestart
  Suppresses any attempts to restart.

dotnet-sdk-8.0.100-win-x64.exe /install /quiet /norestart

Windows Paket Yöneticisi (WinGet) ile yükleme

Aracı kullanarak winget.exe .NET'i Windows Paket Yöneticisi hizmeti aracılığıyla yükleyebilir ve yönetebilirsiniz. WinGet'i yükleme ve kullanma hakkında daha fazla bilgi için bkz. Uygulamaları yüklemek ve yönetmek için winget aracını kullanma.

.NET sistem genelinde yüklüyorsanız, yönetim ayrıcalıklarıyla yükleyin.

.NET WinGet paketleri şunlardır:

• Microsoft.DotNet.Runtime.8—.NET Runtime 8.0.
• Microsoft.DotNet.AspNetCore.8—ASP.NET Core Runtime 8.0
• Microsoft.DotNet.DesktopRuntime.8—.NET Desktop Runtime 8.0
• Microsoft.DotNet.SDK.8—.NET SDK 8.0

SDK’yı yükleyin

SDK'yı yüklerseniz ilgili çalışma zamanını yüklemeniz gerekmez.

1. WinGet'i yükleyin.

2. PowerShell veya Komut İstemi gibi bir terminal açın.

3. winget install komutunu çalıştırın ve SDK paketinin adını geçirin:

   winget install Microsoft.DotNet.SDK.8
   

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

Çalışma zamanını yükleme

Yükleyebileceğiniz farklı çalışma zamanları vardır. Her çalışma zamanına nelerin dahil olduğunu anlamak için Doğru çalışma zamanını seçme bölümüne bakın.

1. WinGet'i yükleyin.

2. PowerShell veya Komut İstemi gibi bir terminal açın.

3. winget install komutunu çalıştırın ve SDK paketinin adını geçirin:

   winget install Microsoft.DotNet.DesktopRuntime.8
   winget install Microsoft.DotNet.AspNetCore.8
   

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

Sürüm arama

Yüklemek istediğiniz paketin winget search farklı sürümlerini aramak için komutunu kullanın. Örneğin, aşağıdaki komut WinGet aracılığıyla kullanılabilen tüm .NET SDK'larını arar:

winget search Microsoft.DotNet.SDK

Arama sonuçları, her paket tanımlayıcısı olan bir tabloya yazdırılır.

Name                           Id                           Version                    Source
----------------------------------------------------------------------------------------------
Microsoft .NET SDK 9.0 Preview Microsoft.DotNet.SDK.Preview 9.0.100-preview.3.24204.13 winget
Microsoft .NET SDK 8.0         Microsoft.DotNet.SDK.8       8.0.300                    winget
Microsoft .NET SDK 7.0         Microsoft.DotNet.SDK.7       7.0.409                    winget
Microsoft .NET SDK 6.0         Microsoft.DotNet.SDK.6       6.0.422                    winget
Microsoft .NET SDK 5.0         Microsoft.DotNet.SDK.5       5.0.408                    winget
Microsoft .NET SDK 3.1         Microsoft.DotNet.SDK.3_1     3.1.426                    winget

Önizleme sürümlerini yükleme

Önizleme sürümlerini, gibi 8sürüm numarasını sözcüğüyle Previewdeğiştirerek yükleyebilirsiniz. Aşağıdaki örnek ,NET Desktop Runtime'ın önizleme sürümünü yükler:

winget install Microsoft.DotNet.DesktopRuntime.Preview

PowerShell ile yükleme

Sürekli tümleştirme ve yönetici olmayan yüklemeler için .NET'in PowerShell betiği aracılığıyla dotnet-install yüklenmesi önerilir. Sisteminizde normal kullanım için .NET yüklüyorsanız.NET Yükleyicisi'ni veya Windows Paket Yöneticisi yükleme yöntemlerini kullanın.

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. Betik adresinde bulunur https://dot.net/v1/dotnet-install.ps1 ve kaynak kodu GitHub'da barındırılır.

Betik hakkında daha fazla bilgi için bkz . dotnet-install betik başvurusu.

Çalışma zamanını yükleme

.NET Çalışma Zamanı anahtarı sağlanarak -Runtime yüklenir.

1. Yükleme betiğini şu kaynaktan indirin: https://dot.net/v1/dotnet-install.ps1

2. PowerShell'i açın ve betiği içeren klasöre gidin.

3. En yüksek uyumluluk için hem Masaüstü çalışma zamanını hem de ASP.NET Core çalışma zamanını yüklemek için aşağıdaki komutları çalıştırın:

   dotnet-install.ps1 -Runtime windowsdesktop
   dotnet-install.ps1 -Runtime aspnetcore
   

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

SDK’yı yükleyin

SDK'yı yüklerseniz çalışma zamanlarını yüklemeniz gerekmez.

1. Yükleme betiğini şu kaynaktan indirin: https://dot.net/v1/dotnet-install.ps1

2. PowerShell'i açın ve betiği içeren klasöre gidin.

3. .NET SDK'sını yüklemek için aşağıdaki komutu çalıştırın.

   dotnet-install.ps1
   

   Not

   SDK, anahtarı atlayarak -Runtime yüklenir.

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

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.

İndirdiğiniz dosyanın sağlama toplamını doğrulamak için PowerShell veya Komut İstemi'ni kullanabilirsiniz. Örneğin, aşağıdaki komut dotnet-sdk-8.0.100-win-x64.exe dosyasının sağlama toplamını bildirir:

> certutil -hashfile dotnet-sdk-8.0.100-win-x64.exe SHA512
SHA512 hash of dotnet-sdk-8.0.100-win-x64.exe:
248acec95b381e5302255310fb9396267fd74a4a2dc2c3a5989031969cb31f8270cbd14bda1bc0352ac90f8138bddad1a58e4af1e56cc4a1613b1cf2854b518e
CertUtil: -hashfile command completed successfully.

> (Get-FileHash .\dotnet-sdk-8.0.100-win-x64.exe -Algorithm SHA512).Hash
248acec95b381e5302255310fb9396267fd74a4a2dc2c3a5989031969cb31f8270cbd14bda1bc0352ac90f8138bddad1a58e4af1e56cc4a1613b1cf2854b518e

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

Doğrulamak için PowerShell ve 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 .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:

   

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.

   İpucu

   Sağlama toplamı dosyanızı hangi .NET sürümünün içerdiğinden emin değilseniz, bu dosyayı bulana kadar bağlantıları inceleyin.

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:

   

4. Sağlama toplamı dosyasının bağlantısını kopyalayın.

5. Aşağıdaki betiği kullanın, ancak uygun sağlama toplamı dosyasını indirmek için bağlantıyı değiştirin:

   Invoke-WebRequest https://dotnetcli.blob.core.windows.net/dotnet/checksums/8.0.0-sha.txt -OutFile 8.0.0-sha.txt
   

6. Hem sağlama toplamı dosyası hem de .NET yayın dosyası aynı dizine indirilirken sağlama toplamı dosyasında .NET indirmesinin sağlama toplamını arayın:

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

   > (Get-Content .\8.0.0-sha.txt | Select-String "dotnet-sdk-8.0.100-win-x64.exe").Line -like (Get-FileHash .\dotnet-sdk-8.0.100-win-x64.exe -Algorithm SHA512).Hash + "*"
   True
   

   False'un yazdırıldığını görürseniz, indirdiğiniz dosya geçerli değildir ve kullanılmamalıdır.

Sorun giderme

.NET SDK'sını yükledikten sonra .NET CLI komutlarını çalıştırmaya çalışırken sorunlarla karşılaşabilirsiniz. Bu bölümde bu yaygın sorunlar toplanır ve çözümler sağlanır.

• .NET SDK bulunamadı
• Uygulama oluşturma işlemi beklenenden daha yavaş
• hostfxr.dll / api-ms-win-crt-runtime-l1-1-0.dll / api-ms-win-cor-timezone-l1-1-0.dll eksik

.NET SDK bulunamadı

Büyük olasılıkla .NET SDK'sının hem x86 (32 bit) hem de x64 (64 bit) sürümlerini yüklemişsinizdir. Komutu çalıştırdığınızda x64 sürümüne dotnet çözümlenmesi gerektiğinde x86 sürümüne çözümlendiğinden bu bir çakışmaya neden oluyor. Bu sorun, değişkeni önce x64 sürümünü çözecek şekilde ayarlayarak %PATH% düzeltilir.

1. komutunu çalıştırarak where.exe dotnet her iki sürümün de yüklü olduğunu doğrulayın. Bunu yaparsanız, hem Program Files\ hem de Program Files (x86)\ klasörleri için bir girdi görmeniz gerekir. Aşağıdaki örnekte gösterildiği gibi Program Files (x86)\ klasörü ilk sıradaysa, bu yanlıştır ve sonraki adıma geçmeniz gerekir.

   > where.exe dotnet
   C:\Program Files (x86)\dotnet\dotnet.exe
   C:\Program Files\dotnet\dotnet.exe
   

   Doğruysa ve önce Program Files\ ise, bu bölümün ele alındığı sorunla karşı karşıya değilsinizdir ve GitHub'da bir .NET yardım isteği sorunu oluşturmanız gerekir

2. Windows düğmesine basın ve aramaya "Sistem ortamı değişkenlerini düzenle" yazın. Sistem ortamı değişkenlerini düzenle'yi seçin.

   

3. Sistem Özellikleri penceresi Gelişmiş Sekmesi'ne açılır. Ortam Değişkenleri'ne tıklayın.

   

4. Ortam Değişkenleri penceresinin Sistem değişkenleri grubunun altında Yol* satırını ve ardından Düzenle düğmesini seçin.

   

5. C:\Program Files\dotnet\ girdisini C:\Program Files (x86)\dotnet\ üzerine taşımak için Yukarı Taşı ve Aşağı Taşı düğmelerini kullanın.

   

Uygulama oluşturma işlemi beklenenden daha yavaş

Bir Windows özelliği olan Akıllı Uygulama Denetimi'nin kapalı olduğundan emin olun. Akıllı Uygulama Denetimi'nin geliştirme için kullanılan makinelerde etkinleştirilmesi önerilmez. "Kapalı" dışındaki tüm ayarlar SDK performansını olumsuz etkileyebilir.

hostfxr.dll / api-ms-win-crt-runtime-l1-1-0.dll / api-ms-win-cor-timezone-l1-1-0.dll eksik

Microsoft Visual C++ 2015-2019 Yeniden Dağıtılabilir'i (64 bit veya 32 bit) yükleyin.

İlgili içerik

• .NET CLI'ya genel bakış
• Yeni bir .NET sürümüne yükseltin.
• .NET'in zaten yüklü olup olmadığını denetleme.
• Öğretici: Merhaba Dünya öğretici.
• Öğretici: Visual Studio Code ile yeni bir uygulama oluşturma.