Önyükleyici paketleri oluşturma

  • Makale

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>

İlgili içerik