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

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

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

• .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'den .NET Framework sürümüne kadar olan sürümler, .NET Framework 4.5'e yerinde güncelleştirmeler yapar. Bu da aynı çalışma zamanı sürümünü kullanmaları anlamına gelir, ancak derleme sürümleri güncelleştirilir ve yeni türler ve üyeler .NET Framework 4.8 içerir.

• .NET Framework 4.5 ve sonraki sürümler, 4. sürümde .NET Framework olarak yerleşiktir. .NET Framework 4 yüklü bir sisteme .NET Framework 4.5 veya sonraki sürümleri yükleyebilirsiniz, sürüm 4 derlemeleri daha yeni sürümlerle değiştirilir.

• Uygulamanıza bir Microsoft bant dışında pakete başvurursanız, derleme uygulama paketine dahil edilir.

• 4.5 veya sonraki .NET Framework 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 dahil edilir, bu nedenle bu işletim sistemlerinde uygulamanıza dağıtmanız gerek değildir. Benzer şekilde .NET Framework 4.5.1, R2'Windows 8.1 Windows Server 2012 dahil edilir. .NET Framework 4.5.2 hiçbir işletim sistemine dahil değildir. .NET Framework 4.6, Windows 10 .NET Framework 4.6.1, Windows 10 Kasım Güncelleştirmesi'ne ve .NET Framework 4.6.2 de Windows 10 Yıldönümü Güncelleştirmesi'ne dahildir. .NET Framework 4.7 Windows 10 Creators Update,.NET Framework 4.7.1 Windows 10 Fall Creators Update'a ve .NET Framework 4.7.2 de Windows 10 Ekim 2018 Güncelleştirmesi ve Windows 10 Nisan 2018 Güncelleştirmesi. .NET Framework 4.8, Windows 10 Mayıs 2019 Güncelleştirmesi ve sonraki tüm güncelleştirmelere Windows 10 dahil edilir. Donanım ve yazılım gereksinimlerinin tam listesi için bkz. Sistem Gereksinimleri.

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

• 4.5 .NET Framework veya sonraki sürümleri kaldırmak, önceden var olan .NET Framework 4 dosyalarını da kaldırır. .NET Framework 4'e geri dönmek için yeniden yüklemeniz ve güncelleştirmeleri yüklemeniz gerekir. Bkz. .NET Framework 4'ü yükleme.

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

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

Uygulamanıza dağıtım seçenekleri

Kullanıcıların yüklemesi için, uygulamanızı bir web sunucusuna veya başka bir merkezi konuma yayımlamaya hazırsanız, birkaç dağıtım yönteminden birini seçebilirsiniz. Bu hizmetlerden bazıları Visual Studio. Aşağıdaki tabloda, uygulamanıza dağıtım seçenekleri liste ve her .NET Framework paketin yeniden dağıtılabilir paketini belirtir. Bunlara ek olarak, uygulamanıza özel bir kurulum programı da yazabilirsiniz; Daha fazla bilgi için, Uygulamanıza Yükleme .NET Framework Için 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 İndirme sayfasında .NET Framework barındırıldı. Aşağıdaki tabloda iki paket karşılaştırıldı:

* Tüm hedef platformların bileşenlerini içerdiğinden çevrimdışı yükleyici daha büyüktür. Kurulumu çalıştırmayı tamamlarken, Windows sistemi yalnızca kullanılan yükleyiciyi önbelleğe almaktadır. Çevrimdışı yükleyici yüklemeden sonra silinirse, kullanılan disk alanı web yükleyicisi tarafından kullanılanla aynıdır. Uygulama kurulum programını oluşturmak için kullanabileceğiniz araç (örneğin, InstallAware veya InstallShield)yüklemeden sonra kaldırılan bir kurulum dosyası klasörü sağlarsa, çevrimdışı yükleyici bunu kurulum klasörüne yerleştirerek 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ı seçeneğini kullanarak başka bir dil paketi /LCID belirtebilirsiniz. Örnekler için Varsayılan Kullanıcı Arabirimini Kullanarak Zincirleme .NET Framework bölümüne bakın.

Dağıtım yöntemleri

Dört dağıtım yöntemi mevcuttur:

• .NET Framework için bir bağımlılık ayarlayabilirsiniz. aşağıdaki yöntemlerden birini kullanarak, uygulamanızın yüklemesinde bir önkoşul olarak .NET Framework belirtebilirsiniz:

  • ClickOnce dağıtımı kullan (Visual Studio ile kullanılabilir)

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

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

  • Windows Installer XML (wix) araç takımını kullanın

• kullanıcılarınızın .NET Framework el ile yüklemesiniisteyebilirsiniz.

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

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

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

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

.NET Framework bağımlılığı ayarlama

uygulamanızı dağıtmak için ClickOnce, ınstallaware, ınstallshield veya wix kullanıyorsanız, .NET Framework bir bağımlılık ekleyerek uygulamanızın bir parçası olarak yüklenebilmesini sağlayabilirsiniz.

ClickOnce dağıtımı

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

Visual Studio, ClickOnce dağıtım ve .NET Framework bir bağımlılık ekleme ' yi seçin:

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

2. Çözüm Gezgini ' de, projeniz için kısayol menüsünü açın ve ardından Ö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 işaretli 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ı ya da kendi bir sitesini belirtebilirsiniz. Yeniden dağıtılabilir paketi kendi sunucunuza yerleştiriyorsanız, web yükleyicisinin değil, çevrimdışı yükleyici olmalıdır. yalnızca .NET Framework indirme sayfasındaki web yükleyicisine bağlanabilirsiniz. URL aynı zamanda kendi uygulamanızın dağıtıldığı bir disk da belirtebilir.

8. Özellik sayfaları Iletişim kutusunda Tamam' ı seçin.

InstallAware dağıtımı

ınstallaware, tek bir kaynaktan Windows app (APPX), Windows Installer (msı), yerel kod (EXE) ve app-V (uygulama sanallaştırma) paketleri oluşturur. .NET Framework, isteğe bağlı olarak, varsayılan betikleri düzenleyerekyüklemeyi özelleştirerek, kuruluminizdeki tüm sürümlerini kolayca ekleyin . örneğin, ınstallaware, .NET Framework 4,7 kurulumu başarısız olmadan Windows 7 ' ye sertifika ön yüklemesine neden olur. ınstallaware hakkında daha fazla bilgi için bkz. ınstallaware for Windows Installer web sitesi.

InstallShield dağıtımı

ınstallshield Windows uygulama paketleri (msix, APPX), Windows Installer paketleri (msı) ve yerel kod (EXE) yükleyicilerini oluşturur. ınstallshield ayrıca Visual Studio tümleştirme de sağlar. Daha fazla bilgi için InstallShield Web sitesine bakın.

Windows Yükleyici XML (WiX) dağıtımı

Windows Installer xml (wix) araç takımı, xml kaynak kodundan yükleme paketleri Windows oluşturur. WiX, MSI ve MSM kurulum paketleri oluşturmak için yapı süreçlerinizle tümleştirilebilen bir komut satırı ortamını destekler. wix kullanarak, .NET Framework bir önkoşul olarak belirtebilirveya .NET Framework dağıtım deneyimini tam olarak denetlemek için bir bağlayıcı 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üklensin

bazı durumlarda .NET Framework uygulamanıza otomatik olarak yüklemek pratik olabilir. bu durumda, kullanıcıların .NET Framework kendilerini yüklemesini sağlayabilirsiniz. Yeniden dağıtılabilir paket ikipakette kullanılabilir. Kurulum sürecinizdeki kullanıcıların .NET Framework bulması ve yüklemesi için yönergeler sağlayın.

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

uygulamanız için özel bir kurulum programı oluşturuyorsanız, uygulamanızın kurulum sürecinde .NET Framework kurulum işlemini zincirleyebilirsiniz (dahil). zincirleme .NET Framework yüklemesi için iki uı seçeneği sağlar:

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

• uygulamanızın kurulum programıyla tutarlı olması 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 izin verir. Her paketin avantajları vardır:

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

• çevrimdışı yükleyiciyi kullanıyorsanız, kullanıcılarınızın kurulum sırasında web 'den başka dosya indirmesini sağlamak için yeniden dağıtım medyanıza sahip .NET Framework yükleme paketlerinin tamamını dahil edebilirsiniz.

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

.NET Framework yükleme işlemini sessizce zincirlemek ve .NET Framework yükleyicinin 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 şu komutu kullanın:

dotNetFx45_Full_x86_x64.exe /q /norestart /ChainingPackage Contoso

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

• kullanıcıların, sistem yeniden başlatmaları en aza indirmek için .NET Framework uygulamaları kapatmalarının bir yolunu sağlamak için pasif modu ayarlayın ve /showrmui seçeneği aşağıdaki gibi kullanın:

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

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

• Web yükleyicisini kullanıyorsanız, /LCID bir dil paketi belirtmek için seçeneğini kullanabilirsiniz. örneğin, .NET Framework 4,5 web yükleyicisini Contoso kurulum programınıza zincirlemek ve 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

  /LCIDSeçeneğini atlarsanız, Kurulum kullanıcının MUI ayarıyla eşleşen dil paketini yükler.

  Not

  Farklı dil paketlerinde farklı sürüm tarihleri olabilir. belirttiğiniz dil paketi indirme merkezinde yoksa, kurulum .NET Framework dil paketi olmadan 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.

Ortak dönüş kodları için dönüş kodları bölümüne bakın.

Özel bir kullanıcı arabirimi kullanarak zincirleme

özel bir kurulum paketiniz varsa, kurulum ilerleme durumunun kendi görünümünü 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 gereksinimlerinidenetleyin.

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

  Önemli

  .NET Framework 'nin doğru sürümünün zaten yüklü olup olmadığını belirlemek için, hedef sürümünüzün yüklenip yüklenmediğini değil, hedef sürümünüzün veya sonraki bir sürümünün yüklü olup olmadığını denetlemeniz gerekir. Diğer 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ından büyük veya ona eşit olup olmadığını değerlendirmelisiniz.

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

• dağıtımı denetlemek isterseniz, .NET Framework kurulum işlemini sessizce başlatın ve izleyin (bkz. nasıl yapılır: .NET Framework 4,5 yükleyicisinden ilerleme durumunu alma).

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

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

• Sorun giderin.

.NET Framework Algıla

yükleme başarılı olduğunda .NET Framework yükleyicisi kayıt defteri anahtarlarını yazar. HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Fulladlı bir değer için kayıt defterindeki klasörü denetleyerek .NET Framework 4,5 veya sonraki bir sürümünün yüklenip yüklenmediğini test edebilirsiniz DWORD Release . ("NET Framework Setup" bir noktayla başlamayacağını unutmayın.) bu anahtarın varlığı, bu bilgisayarda .NET Framework 4,5 veya sonraki bir sürümün yüklü olduğunu gösterir. değeri, Release hangi .NET Framework sürümünün yüklendiğini gösterir.

Dil paketlerini algılama

Kayıt defterindeki bir DWORD değeri için HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\FullLCID klasörünü kontrol ederek belirli bir dil paketinin \ yüklü olup olmadığını test Release edin. ("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 yayın sürümünün 4.5 ile 4.7.2 arasında belirli bir .NET Framework sürümü için yük olup olmadığını belirlemek için, önceki bölümde açıklanan RELEASE key DWORD değerinin değerini (Detecting .NET Framework).

Dil paketlerini uygulama kuruluma zincirleme

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

• .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 sürümünden itibaren, paket adları NDP<version>-KB<number>-x86-x64-AllOS-<>.exe şeklindedir ve burada .NET Framework'nin sürüm numarasıdır, Microsoft Bilgi Bankası makale numarasıdır ve culture version number culture ülke/bölge belirtir. Bu paketlerden biri NDP452-KB2901907-x86-x64-AllOS-JPN.exe örneğidir. Paket adları bu makalenin önceki kısımlarında yer alan Yeniden Dağıtılabilir Paketler bölümünde listelenmiştir.

Çevrimdışı yükleyici ile bir dil .NET Framework yüklemek için, onu uygulamanı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 zorunda değildir; kurulumu, kullanıcının MUI ayarıyla eşleşen dil paketini yükleyecek. Farklı bir dil yüklemek için seçeneğini kullanarak bir /LCID dil paketi belirtebilirsiniz.

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, yeniden dağıtılabilir yükleyici için en .NET Framework kodları listele. 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 bilinen adı hata kodları

• WinHttp hata kodları

Diğer hata kodları

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

• Windows Yükleyici hata kodları

• Windows Aracı sonuç kodlarını güncelleştirme

Kaldırma .NET Framework

Windows 8'den başlayarak, .NET Framework 4.5 veya sonraki sürümleri kaldırmak için 4.5 veya Windows özellikleri aç ve kapat Denetim Masası. Windows'nin eski sürümlerinde, .NET Framework'de Program Ekle veya Kaldır'ı kullanarak 4.5 veya sonraki sürümleri Denetim Masası.

Ek

Komut satırı seçenekleri

Aşağıdaki tabloda, 4.5 yeniden dağıtılabilir .NET Framework 4.5'i uygulama kurulumuna zincirlerken dahil etmek istediğiniz seçenekler listelenmiştir.

Desteklenen diller

Aşağıdaki tabloda, .NET Framework 4.5 ve sonraki sürümler için .NET Framework dil paketleri listele.

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