Geliştiriciler için .NET Framework dağıtım kılavuzu

Bu makale, uygulamalarıyla .NET Framework 4.5'ten .NET Framework 4.8'e .NET Framework'ün herhangi bir sürümünü yüklemek isteyen geliştiriciler için bilgi sağlar.

.NET Framework için yeniden dağıtılabilir paketleri ve dil paketlerini indirme sayfalarından indirebilirsiniz:

• .NET Framework 4.8.1
• .NET Framework 4.8
• .NET Framework 4.7.2
• .NET Framework 4.7.1
• .NET Framework 4.7
• .NET Framework 4.6.2
• .NET Framework 4.6.1
• .NET Framework 4.6
• .NET Framework 4.5.2
• .NET Framework 4.5.1
• .NET Framework 4.5

Önemli notlar:

• .NET Framework 4.5.1 ile .NET Framework 4.8 arasındaki .NET Framework sürümleri.NET Framework 4.5 için yerinde güncelleştirmelerdir; bu da aynı çalışma zamanı sürümünü kullandıkları anlamına gelir, ancak derleme sürümleri güncelleştirilir ve yeni türler ve üyeler içerir.

• .NET Framework 4.5 ve sonraki sürümleri .NET Framework 4 üzerinde artımlı olarak oluşturulur. .NET Framework 4 yüklü bir sisteme .NET Framework 4.5 veya sonraki sürümleri yüklediğinizde, sürüm 4 derlemeleri daha yeni sürümlerle değiştirilir.

• Uygulamanızda bir Microsoft bant dışı paketine başvuruyorsanız, derleme uygulama paketine eklenir.

• .NET Framework 4.5 veya sonraki sürümleri yüklemek için yönetici ayrıcalıklarına sahip olmanız gerekir.

• .NET Framework 4.5, Windows 8 ve Windows Server 2012'ye dahildir, bu nedenle bu işletim sistemlerinde uygulamanızla dağıtmanız gerekmez. Benzer şekilde, .NET Framework 4.5.1, Windows 8.1 ve Windows Server 2012 R2'ye dahildir. .NET Framework 4.5.2 hiçbir işletim sistemine dahil değildir. .NET Framework 4.6 Windows 10'a, .NET Framework 4.6.1 Windows 10 Kasım Güncelleştirmesi'ne ve .NET Framework 4.6.2 ise Windows 10 Yıldönümü Güncelleştirmesi'ne dahildir. .NET Framework 4.7, Windows 10 Creators Update'e, .NET Framework 4.7.1 Windows 10 Fall Creators Update'e ve .NET Framework 4.7.2 de Windows 10 Ekim 2018 Güncelleştirmesi ve Windows 10 Nisan 2018 Güncelleştirmesi'ne dahildir. .NET Framework 4.8, Windows 10 Mayıs 2019 Güncelleştirmesi ve sonraki tüm Windows 10 güncelleştirmelerine dahildir. Donanım ve yazılım gereksinimlerinin tam listesi için bkz . Sistem Gereksinimleri.

• .NET Framework 4.5'den başlayarak kullanıcılarınız kurulum sırasında çalışan .NET Framework uygulamalarının listesini görüntüleyebilir ve kolayca kapatabilir. Bu, .NET Framework yüklemelerinin neden olduğu sistem yeniden başlatmalarını önlemeye yardımcı olabilir. Bkz . Sistem Yeniden Başlatmalarını Azaltma.

• .NET Framework 4.5 veya sonraki sürümlerin kaldırılması, önceden var olan .NET Framework 4 dosyalarını da kaldırır. .NET Framework 4'e geri dönmek istiyorsanız, bunu ve güncelleştirmeleri yeniden yüklemeniz gerekir. Bkz . .NET Framework 4'ün yüklenmesi.

• .NET Framework 4.5 yeniden dağıtılabilir sürümü 9 Ekim 2012'de, microsoft tarafından üretilen ve imzalanan dosyalardaki dijital imzanın süresinin erken dolmasına neden olan dijital sertifikada hatalı zaman damgasıyla ilgili bir sorunu düzeltecek şekilde güncelleştirildi. Daha önce 16 Ağustos 2012 tarihli .NET Framework 4.5 yeniden dağıtılabilir paketini yüklediyseniz, kopyanızı .NET Framework indirme sayfasından en son yeniden dağıtılabilir paketle güncelleştirmenizi öneririz. Bu sorun hakkında daha fazla bilgi için bkz . Microsoft Güvenlik Danışmanlığı 2749655.

Bir sistem yöneticisinin .NET Framework'ünü ve sistem bağımlılıklarını bir ağa nasıl dağıtabileceği hakkında bilgi için bkz . Yöneticiler için Dağıtım Kılavuzu.

Uygulamanız için dağıtım seçenekleri

Kullanıcıların yükleyebilmesi için uygulamanızı bir web sunucusuna veya başka bir merkezi konuma yayımlamaya hazır olduğunuzda, çeşitli dağıtım yöntemleri arasından seçim yapabilirsiniz. Bunlardan bazıları Visual Studio ile sağlanır. Aşağıdaki tabloda uygulamanız için dağıtım seçenekleri listelenmiştir ve her seçeneği destekleyen .NET Framework yeniden dağıtılabilir paketini belirtir. Bunlara ek olarak, uygulamanız için özel bir kurulum programı yazabilirsiniz; Daha fazla bilgi için .NET Framework Yüklemesini Uygulamanızın Kurulumuna Zincirleme bölümüne bakın.

Yeniden dağıtılabilir paketler

.NET Framework iki yeniden dağıtılabilir pakette kullanılabilir: web yükleyicisi (önyükleyici) ve çevrimdışı yükleyici (tek başına yeniden dağıtılabilir). Tüm .NET Framework indirmeleri , .NET Framework İndirme sayfasında barındırılır. Aşağıdaki tablo iki paketi karşılaştırır:

* Çevrimdışı yükleyici, tüm hedef platformların bileşenlerini içerdiğinden daha büyüktür. Kurulumu çalıştırmayı bitirdiğinizde, Windows işletim sistemi yalnızca kullanılan yükleyiciyi önbelleğe alır. Yüklemeden sonra çevrimdışı yükleyici silinirse, kullanılan disk alanı web yükleyicisi tarafından kullanılanla aynıdır. Uygulamanızın kurulum programını oluşturmak için kullandığınız araç (örneğin, InstallAware veya InstallShield) yüklemeden sonra kaldırılan bir kurulum dosyası klasörü sağlıyorsa, çevrimdışı yükleyici kurulum klasörüne yerleştirilerek otomatik olarak silinebilir.

** Web yükleyicisini özel kurulumla kullanıyorsanız, kullanıcının Çok Dilde Kullanıcı Arabirimi (MUI) ayarına göre varsayılan dil ayarlarını kullanabilir veya komut satırındaki /LCID seçeneği kullanarak başka bir dil paketi belirtebilirsiniz. Örnekler için Varsayılan .NET Framework Kullanıcı Arabirimini Kullanarak Zincirleme bölümüne bakın.

Dağıtım yöntemleri

Dört dağıtım yöntemi kullanılabilir:

• .NET Framework bağımlılığı ayarlayabilirsiniz. Uygulamanızın yüklemesinde önkoşul olarak şu yöntemlerden birini kullanarak .NET Framework belirtebilirsiniz:

  • ClickOnce dağıtımlarını kullanma (Visual Studio ile kullanılabilir)

  • InstallAware projesi oluşturma (Visual Studio kullanıcıları için ücretsiz sürüm)

  • InstallShield projesi oluşturma (Visual Studio ile kullanılabilir)

  • Windows Installer XML (WiX) araç takımını kullanma

• Kullanıcılarınızdan .NET Framework'ü el ile yüklemelerini isteyebilirsiniz.

• .NET Framework kurulum işlemini uygulamanızın kurulumuna zincirleyebilir (dahil edebilir) ve .NET Framework yükleme deneyimini nasıl işlemek istediğinize karar vekleyebilirsiniz:

  • Varsayılan kullanıcı arabirimini kullanın. .NET Framework yükleyicisinin yükleme deneyimini sağlamasına izin verin.

  • Birleşik bir yükleme deneyimi sunmak ve .NET Framework yükleme ilerleme durumunu izlemek için kullanıcı arabirimini özelleştirin.

Bu dağıtım yöntemleri aşağıdaki bölümlerde ayrıntılı olarak açıklanmıştır.

.NET Framework'te bağımlılık ayarlama

Uygulamanızı dağıtmak için ClickOnce, InstallAware, InstallShield veya WiX kullanıyorsanız, uygulamanızın bir parçası olarak yüklenebilmesi için .NET Framework'e bağımlılık ekleyebilirsiniz.

ClickOnce dağıtımı

ClickOnce dağıtımı Visual Basic ve Visual C# ile oluşturulan projeler için kullanılabilir, ancak Visual C++ için kullanılamaz.

Visual Studio'da ClickOnce dağıtımı'nı seçmek ve .NET Framework'e bağımlılık eklemek için:

1. Yayımlamak istediğiniz uygulama projesini açın.

2. Çözüm Gezgini'da projenizin kısayol menüsünü açın ve özellikler'i seçin.

3. Yayımla bölmesini seçin.

4. Önkoşullar düğmesini seçin.

5. Önkoşullar iletişim kutusunda Önkoşul bileşenlerini yüklemek için kurulum programı oluştur onay kutusunun seçili olduğundan emin olun.

6. Önkoşullar listesinde projenizi oluşturmak için kullandığınız .NET Framework sürümünü bulun ve seçin.

7. Önkoşulların kaynak konumunu belirtmek için bir seçenek belirleyin ve ardından Tamam'ı seçin.

   .NET Framework indirme konumu için bir URL sağlarsanız, .NET Framework indirme sayfasını veya kendi sitenizi belirtebilirsiniz. Yeniden dağıtılabilir paketi kendi sunucunuza yerleştiriyorsanız, bu paketin web yükleyicisi değil çevrimdışı yükleyici olması gerekir. Web yükleyicisine yalnızca .NET Framework indirme sayfasından bağlanabilirsiniz. URL, kendi uygulamanızın dağıtıldığı diski de belirtebilir.

8. Özellik Sayfaları iletişim kutusunda Tamam'ı seçin.

InstallAware dağıtımı

InstallAware tek bir kaynaktan Windows uygulaması (APPX), Windows Installer (MSI), Yerel Kod (EXE) ve App-V (Application Virtualization) paketleri oluşturur. Kurulumunuza .NET Framework'ün herhangi bir sürümünü kolayca ekleyin ve isteğe bağlı olarak varsayılan betikleri düzenleyerek yüklemeyi özelleştirin. Örneğin InstallAware, .NET Framework 4.7 kurulumu başarısız olan sertifikaları Windows 7'ye önceden yükler. InstallAware hakkında daha fazla bilgi için Windows Installer için InstallAware web sitesine bakın.

InstallShield dağıtımı

InstallShield, Windows uygulama paketleri (MSIX, APPX), Windows Installer paketleri (MSI) ve Yerel Kod (EXE) yükleyicileri oluşturur. InstallShield, Visual Studio tümleştirmesi de sağlar. Daha fazla bilgi için InstallShield web sitesine bakın.

Windows Installer XML (WiX) dağıtımı

Windows Installer XML (WiX) araç takımı, XML kaynak kodundan Windows yükleme paketleri oluşturur. WiX, MSI ve MSM kurulum paketlerini derlemek için derleme işlemlerinizle tümleştirilebilen bir komut satırı ortamını destekler. WiX kullanarak önkoşul olarak .NET Framework'leri belirtebilir veya .NET Framework dağıtım deneyimini tam olarak denetlemek için bir zincirleyici oluşturabilirsiniz. WiX hakkında daha fazla bilgi için Windows Installer XML (WiX) araç takımı web sitesine bakın.

.NET Framework'ü el ile yükleme

Bazı durumlarda, .NET Framework'ü uygulamanızla otomatik olarak yüklemek pratik olmayabilir. Bu durumda, kullanıcıların .NET Framework'ü kendilerinin yüklemesini sağlayabilirsiniz. Yeniden dağıtılabilir paket iki pakette kullanılabilir. Kurulum işleminizde, kullanıcıların .NET Framework'ü nasıl bulup yüklemeleri gerektiğine ilişkin yönergeler sağlayın.

.NET Framework yüklemesini uygulamanızın kurulumuna zincirleme

Uygulamanız için özel bir kurulum programı oluşturuyorsanız uygulamanızın kurulum işlemine .NET Framework kurulum işlemini zincirleyebilirsiniz (dahil edebilirsiniz). Zincirleme, .NET Framework yüklemesi için iki kullanıcı arabirimi seçeneği sağlar:

• .NET Framework yükleyicisi tarafından sağlanan varsayılan kullanıcı arabirimini kullanın.

• Uygulamanızın kurulum programıyla tutarlılık sağlamak için .NET Framework yüklemesi için özel bir kullanıcı arabirimi oluşturun.

Her iki yöntem de web yükleyicisini veya çevrimdışı yükleyiciyi kullanmanıza olanak sağlar. Her paketin avantajları vardır:

• Web yükleyicisini kullanırsanız, .NET Framework kurulum işlemi hangi yükleme paketinin gerekli olduğuna karar verir ve yalnızca bu paketi web'den indirip yükler.

• Çevrimdışı yükleyiciyi kullanıyorsanız, kullanıcılarınızın kurulum sırasında web'den herhangi bir ek dosya indirmesi gerekmeyecek şekilde yeniden dağıtım medyanıza tüm .NET Framework yükleme paketlerini ekleyebilirsiniz.

Varsayılan .NET Framework kullanıcı arabirimini kullanarak zincirleme

.NET Framework yükleme işlemini sessizce zincirleme ve .NET Framework yükleyicisinin kullanıcı arabirimini sağlamasına izin vermek için kurulum programınıza aşağıdaki komutu ekleyin:

<.NET Framework redistributable> /q /norestart /ChainingPackage <PackageName>

Örneğin, yürütülebilir programınız Contoso.exe ve .NET Framework 4.5 çevrimdışı yeniden dağıtılabilir paketini sessizce yüklemek istiyorsanız komutunu kullanın:

dotNetFx45_Full_x86_x64.exe /q /norestart /ChainingPackage Contoso

Yüklemeyi özelleştirmek için ek komut satırı seçeneklerini kullanabilirsiniz. Örneğin:

• Kullanıcıların sistem yeniden başlatmalarını en aza indirmek üzere çalışan .NET Framework uygulamalarını kapatmaları için bir yol sağlamak için pasif modu ayarlayın ve şu seçeneği kullanın /showrmui :

  dotNetFx45_Full_x86_x64.exe /norestart /passive /showrmui /ChainingPackage Contoso

  Bu komut, Restart Manager'ın kullanıcılara .NET Framework uygulamalarını yüklemeden önce .NET Framework uygulamalarını kapatma fırsatı veren bir ileti kutusu görüntülemesini sağlar.

• Web yükleyicisini kullanıyorsanız, dil paketi belirtmek için seçeneğini kullanabilirsiniz /LCID . Örneğin, .NET Framework 4.5 web yükleyicisini Contoso kurulum programınıza zincirleyip Japonca dil paketini yüklemek için uygulamanızın kurulum işlemine aşağıdaki komutu ekleyin:

  dotNetFx45_Full_setup.exe /q /norestart /ChainingPackage Contoso /LCID 1041

  Seçeneği atlarsanız /LCID , kurulum kullanıcının MUI ayarıyla eşleşen dil paketini yükler.

  Not

  Farklı dil paketlerinin farklı sürüm tarihleri olabilir. Belirttiğiniz dil paketi indirme merkezinde kullanılamıyorsa, kurulum dil paketi olmadan .NET Framework'ü yükler. .NET Framework kullanıcının bilgisayarında zaten yüklüyse, kurulum yalnızca dil paketini yükler.

Seçeneklerin tam listesi için Komut Satırı Seçenekleri bölümüne bakın.

Yaygın dönüş kodları için İade Kodları bölümüne bakın.

Özel kullanıcı arabirimi kullanarak zincirleme

Özel bir kurulum paketiniz varsa, kurulum ilerleme durumunu kendi görünümünüzü gösterirken .NET Framework kurulumunu sessizce başlatmak ve izlemek isteyebilirsiniz. Bu durumda kodunuzun aşağıdakileri kapsadığından emin olun:

• .NET Framework donanım ve yazılım gereksinimlerini denetleyin.

• .NET Framework'ün doğru sürümünün kullanıcının bilgisayarında zaten yüklü olup olmadığını algılayın .

  Önemli

  .NET Framework'ün doğru sürümünün zaten yüklü olup olmadığını belirlerken, hedef sürümünüzün yüklü olup olmadığını değil, hedef sürümünüzün veya sonraki bir sürümün yüklü olup olmadığını denetlemeniz gerekir. Başka bir deyişle, kayıt defterinden aldığınız yayın anahtarının hedef sürümünüzün yayın anahtarına eşit olup olmadığını değil, hedef sürümünüzün yayın anahtarına eşit olup olmadığını değerlendirmeniz gerekir.

• Dil paketlerinin kullanıcının bilgisayarında zaten yüklü olup olmadığını algılayın .

• Dağıtımı denetlemek istiyorsanız, .NET Framework kurulum işlemini sessizce başlatın ve izleyin (bkz . Nasıl yapılır: .NET Framework 4.5 Yükleyicisinden İlerleme Durumu Alma).

• Çevrimdışı yükleyiciyi dağıtıyorsanız dil paketlerini ayrı ayrı zincirleyin.

• Komut satırı seçeneklerini kullanarak dağıtımı özelleştirin. Örneğin, .NET Framework web yükleyicisini zincirlediğiniz halde varsayılan dil paketini geçersiz kılmak istiyorsanız, önceki bölümde açıklandığı gibi seçeneğini kullanın /LCID .

• Sorun giderme.

.NET Framework algılama

Yükleme başarılı olduğunda .NET Framework yükleyicisi kayıt defteri anahtarlarını yazar. Kayıt defterindeki klasörü adlı Releasebir DWORD değer için denetleyerek .NET Framework 4.5 veya üzerinin HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full yüklü olup olmadığını test edebilirsiniz. ("NET Framework Kurulumu" bir noktayla başlamaz.) Bu anahtarın varlığı, .NET Framework 4.5 veya sonraki bir sürümün bu bilgisayara yüklendiğini gösterir. değeri Release hangi .NET Framework sürümünün yüklü olduğunu gösterir.

Dil paketlerini algılama

Adlı Releasebir DWORD değeri için kayıt defterindeki HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\LCID klasörünü denetleyerek belirli bir dil paketinin yüklenip yüklenmediğini test edebilirsiniz. ("NET Framework Kurulumu" bir noktayla başlamaz.) LCID bir yerel ayar tanımlayıcısı belirtir; bunların listesi için desteklenen dillere bakın.

Örneğin, tam Japonca dil paketinin (LCID=1041) yüklü olup olmadığını algılamak için kayıt defterinden aşağıdaki adlandırılmış değeri alın:

Bir dil paketinin son sürüm sürümünün .NET Framework'ün belirli bir sürümü için 4.5 ile 4.7.2 arasında yüklü olup olmadığını belirlemek için, .NET Framework'ü Algılama adlı önceki bölümde açıklanan RELEASE anahtarı DWORD değerinin değerini denetleyin.

Dil paketlerini uygulama kurulumunuza zincirleme

.NET Framework, belirli kültürler için yerelleştirilmiş kaynaklar içeren bir dizi bağımsız dil paketi yürütülebilir dosyası sağlar. Dil paketleri .NET Framework indirme sayfalarından kullanılabilir:

• .NET Framework 4.8.1
• .NET Framework 4.8
• .NET Framework 4.7.2
• .NET Framework 4.7.1
• .NET Framework 4.7
• .NET Framework 4.6.2
• .NET Framework 4.6.1
• .NET Framework 4.6
• .NET Framework 4.5.2
• .NET Framework 4.5.1
• .NET Framework 4.5

.NET Framework 4.5.1'den başlayarak paket adları NDP-KB-x86-x64-AllOS<>>numberversion<-<culture>.exe biçimindedir; burada version .NET Framework'ün sürüm numarasıdır, number bir Microsoft Bilgi Bankası makale numarasıdır ve culture bir ülke/bölge belirtir. Bu paketlerden birine örnek olarak verilmiştir NDP452-KB2901907-x86-x64-AllOS-JPN.exe. Paket adları, bu makalenin başlarındaki Yeniden Dağıtılabilir Paketler bölümünde listelenmiştir.

.NET Framework çevrimdışı yükleyicisi ile bir dil paketi yüklemek için bunu uygulamanızın kurulumuna zincirlemeniz gerekir. Örneğin, .NET Framework 4.5.1 çevrimdışı yükleyicisini Japonca dil paketiyle dağıtmak için aşağıdaki komutu kullanın:

NDP451-KB2858728-x86-x64-AllOS-JPN.exe /q /norestart /ChainingPackage <ProductName>

Web yükleyicisini kullanıyorsanız dil paketlerini zincirlemeniz gerekmez; kurulum, kullanıcının MUI ayarıyla eşleşen dil paketini yükler. Farklı bir dil yüklemek istiyorsanız, dil paketi belirtmek için seçeneğini kullanabilirsiniz /LCID .

Komut satırı seçeneklerinin tam listesi için Komut Satırı Seçenekleri bölümüne bakın.

Sorun giderme

Dönüş kodları

Aşağıdaki tabloda .NET Framework yeniden dağıtılabilir yükleyicisi için en yaygın dönüş kodları listelenmektedir. Dönüş kodları yükleyicinin tüm sürümleri için aynıdır. Ayrıntılı bilgilerin bağlantıları için sonraki bölüme bakın.

İndirme hatası kodları

Aşağıdaki içeriğe bakın:

• Arka Plan Akıllı Aktarım Hizmeti (BITS) hata kodları

• URL takma adı hata kodları

• WinHttp hata kodları

Diğer hata kodları

Aşağıdaki içeriğe bakın:

• Windows Installer hata kodları

• Windows Update Aracısı sonuç kodları

.NET Framework'i kaldırma

Windows 8'den başlayarak, .NET Framework 4.5 veya sonraki sürümleri Denetim Masası'de Windows özelliklerini aç ve kapat'ı kullanarak kaldırabilirsiniz. Windows'un eski sürümlerinde, Denetim Masası'da Program Ekle veya Kaldır'ı kullanarak .NET Framework 4.5 veya sonraki sürümleri kaldırabilirsiniz.

Ek

Komut satırı seçenekleri

Aşağıdaki tabloda, .NET Framework 4.5 yeniden dağıtılabilir öğesini uygulamanızın kurulumuna zincirlerken ekleyebileceğiniz seçenekler listelenmiştir.

Desteklenen diller

Aşağıdaki tabloda .NET Framework 4.5 ve sonraki sürümlerde kullanılabilen .NET Framework dil paketleri listelenmektedir.

Ayrıca bkz.

• Yöneticiler için Dağıtım Kılavuzu
• Sistem Gereksinimleri
• Geliştiriciler için .NET Framework'ü yükleme
• Engellenen .NET Framework yükleme ve kaldırma sorunlarını giderme
• .NET Framework 4.5 Yüklemeleri Sırasında Sistem Yeniden Başlatmalarını Azaltma
• Nasıl Yapılır: .NET Framework 4.5 Yükleyicisinden İlerleme Durumunu Alma