Önyükleyici paketleri oluşturma
Kurulum programı, Windows Installer (.msi) dosyaları ve yürütülebilir programlar gibi yeniden dağıtılabilir bileşenleri algılamak ve yüklemek için yapılandırılabilir genel bir yükleyicidir. Yükleyici, önyükleyici olarak da bilinir. Bileşenin yüklenmesini yönetmek için meta verileri belirten bir dizi XML bildirimi aracılığıyla programlanır. ClickOnce için Önkoşullar iletişim kutusunda görüntülenen her yeniden dağıtılabilir bileşen veya önkoşul bir önyükleyici paketidir. Önyükleyici paketi, önkoşulun nasıl yüklenmesi gerektiğini açıklayan bildirim dosyalarını içeren bir dizin ve dosya grubudur.
Önyükleyici önce önkoşullardan herhangi birinin zaten yüklü olup olmadığını algılar. Önkoşullar yüklü değilse, önce önyükleyici lisans sözleşmelerini gösterir. İkincisi, son kullanıcı lisans sözleşmelerini kabul ettikten sonra önkoşullar için yükleme başlar. Aksi takdirde, tüm önkoşullar algılanırsa, önyükleyici uygulama yükleyicisini başlatır.
Özel önyükleyici paketleri oluşturma
Visual Studio'da XML Düzenleyicisi'ni kullanarak önyükleyici bildirimlerini oluşturabilirsiniz. Önyükleyici paketi oluşturma örneğini görmek için bkz . İzlenecek yol: Gizlilik istemiyle özel önyükleyici oluşturma.
Önyükleyici paketi oluşturmak için bir ürün bildirimi ve bir bileşenin her yerelleştirilmiş sürümü için bir paket bildirimi de oluşturmanız gerekir.
Product.xml ürün bildirimi, paket için dilden bağımsız meta verileri içerir. Bu, yeniden dağıtılabilir bileşenin tüm yerelleştirilmiş sürümleri için ortak meta verileri içerir. Bu dosyayı oluşturmak için bkz . Nasıl yapılır: Ürün Bildirimi Oluşturma.
Package.xml paket bildirimi dile özgü meta verileri içerir; genellikle yerelleştirilmiş hata iletileri içerir. Bir bileşenin her yerelleştirilmiş sürümü için en az bir paket bildirimi olmalıdır. Bu dosyayı oluşturmak için bkz . Nasıl yapılır: Paket Bildirimi Oluşturma.
Bu dosyalar oluşturulduktan sonra, ürün bildirimi dosyasını özel önyükleyici için adlı bir klasöre yerleştirin. Paket bildirim dosyası, yerel ayar için adlı bir klasöre gider. Örneğin, paket bildirimi dosyası İngilizce yeniden dağıtım içinse, dosyayı en adlı bir klasöre yerleştirin. Japonca için ja ve Almanca için de gibi her yerel ayar için bu işlemi yineleyin. Son özel önyükleyici paketi aşağıdaki klasör yapısına sahip olabilir.
CustomBootstrapperPackage
product.xml
CustomBootstrapper.msi
de
eula.rtf
package.xml
en
eula.rtf
package.xml
ja
eula.rtf
package.xml
Ardından, yeniden dağıtılabilir dosyaları önyükleyici klasör konumuna kopyalayın. Daha fazla bilgi için bkz . Nasıl yapılır: Yerelleştirilmiş önyükleyici paketi oluşturma.
*\Program Files (x86)\Microsoft SDKs\ClickOnce Bootstrapper\Packages*
veya
*<VS Install Path>\MSBuild\Microsoft\VisualStudio\BootstrapperPackages*
Not
Visual Studio yükleme yolu altında yukarıda listelenen yol, Visual Studio 2019 Güncelleştirme 7 sürümünden itibaren çalışır.
Önyükleyici klasörünün konumunu yol değerinden aşağıdaki kayıt defteri anahtarında da bulabilirsiniz:
*HKLM\Software\Microsoft\GenericBootstrapper*
64 bit sistemlerde aşağıdaki kayıt defteri anahtarını kullanın:
*HKLM\Software\Wow6432Node\Microsoft\GenericBootstrapper*
Her yeniden dağıtılabilir bileşen, packages dizininin altındaki kendi alt klasöründe görünür. Ürün bildirimi ve yeniden dağıtılabilir dosyalar bu alt klasöre yerleştirilmelidir. Bileşen ve paket bildirimlerinin yerelleştirilmiş sürümleri, Kültür Adı'na göre adlı alt klasörlere yerleştirilmelidir.
Bu dosyalar önyükleyici klasörüne kopyalandıktan sonra, önyükleyici paketi otomatik olarak Visual Studio Önkoşulları iletişim kutusunda görüntülenir. Özel önyükleyici paketiniz görünmüyorsa Önkoşullar iletişim kutusunu kapatıp yeniden açın. Daha fazla bilgi için bkz . Önkoşullar iletişim kutusu.
Aşağıdaki tabloda, önyükleyici tarafından otomatik olarak doldurulan özellikler gösterilmektedir.
Özellik | Açıklama |
---|---|
ApplicationName | Uygulamanın adı. |
Processorarchitecture | Yürütülebilir dosya tarafından hedeflenen platformun işlemcisi ve sözcük başına bit sayısı. Değerler şunlardır: -Intel - IA64 - AMD64 |
VersionNT | Windows işletim sistemlerinin sürüm numarası. Sürümün söz dizimi Major.Minor.ServicePack şeklindedir. |
VersionMSI | Yükleme sırasında çalıştırılacak Windows Installer derlemesinin (msi.dll) sürümü. |
Yönetici User | Bu özellik, kullanıcının yönetici ayrıcalıkları varsa ayarlanır. Değerler true veya false şeklindedir. |
InstallMode | Yükleme modu, bileşenin nereden yüklenmesi gerektiğini gösterir. Değerler şunlardır: - Giriş Sitesi - Önkoşullar satıcının Web sitesinden yüklenir. - SpecificSite - Önkoşullar seçtiğiniz konumdan yüklenir. - SameSite - Önkoşullar uygulamayla aynı konumdan yüklenir. |
Yeniden dağıtılabilirleri uygulama yüklemelerinden ayırma
Yeniden dağıtılabilir dosyalarınızın Kurulum projelerinde dağıtılmasını engelleyebilirsiniz. Bunu yapmak için.NET Framework dizininizdeki RedistList klasöründe yeniden dağıtılabilir bir liste oluşturun:
%ProgramFiles%\Microsoft.NET\RedistList
Yeniden dağıtılabilir liste, şu biçimi kullanarak adlandırmanız gereken bir XML dosyasıdır: <Şirket Adı.<>Bileşen Adı>. RedistList.xml. Örneğin, bileşen Acme tarafından üretilen DataWidgets olarak adlandırılıyorsa Acme.DataWidgets.RedistList.xml kullanın. Yeniden dağıtılabilir listenin içeriğine bir örnek şuna benzer olabilir:
<?xml version="1.0" encoding="UTF-8"?>
<FileList Redist="Acme.DataWidgets" >
<File AssemblyName="Acme.DataGrid" Version="1.0.0.0" PublicKeyToken="b03f5f7f11d50a3a" Culture="neutral" ProcessorArchitecture="MSIL" InGAC="true" />
</FileList>