Tek Paket Yazma Örneği

Örnek PUASample.msi, Windows Server 2008 R2 ve Windows 7'de kullanıcı başına veya makine başına yükleme bağlamı yüklenebilen çift amaçlı bir Windows Installer 5.0 paketi örneğidir. Bu örnek paket, Tek Paket Yazma'nde açıklanan geliştirme yönergelerini izler.

Örneğin bir kopyasını alma

Bu örneğin bir kopyası ve bir Windows Installer veritabanı tablo düzenleyicisi Orca.exe, Windows Installer Geliştiricileri için Windows SDK Bileşenleri ,içinde bulunmaktadır. Örnek ve tablo düzenleyicisi, PUASample1.msi ve Orca.msiWindows Installer yükleme dosyaları olarak Windows Server 2008 R2 ve Windows 7 için Windows Yazılım Geliştirme Seti ile birlikte sağlanır.

Sistem Gereksinimleri

Orca.exeveritabanı düzenleyicisi, Windows Server 2008 R2 ve öncesi ile Windows 7 ve önceki sürümleri gerektirir. PUASample1.msiçift amaçlı paket, Windows Server 2008 R2 ve Windows 7'de makine başına veya kullanıcı başına yükleme bağlamı yüklenebilir. PUASample1.msi yalnızca Windows Server 2008 ve önceki sürümlerde, Windows Vista'da ve önceki sürümlerde makine başına bağlamında yüklenebilir. Örneği yüklemeden PUASample1.msi içeriğini incelemek için veritabanı düzenleyicisini yükleyebilirsiniz. Örnek veya düzenleyici paketlerini yüklemek için DisableMSI ilkesinin uygulama yüklemelerini engelleyen bir değere ayarlanmadığından emin olun.

Dual-Purpose Paketi Tanımlama

çift amaçlı paketler MSIINSTALLPERUSER özelliğinin değerini 1 olarak başlatmalıdır. Bu, paketin Windows Server 2008 R2 ve Windows 7'de makine başına veya kullanıcı başına bağlamında yüklenebileceğini tanımlar. Paketteki MSIINSTALLPERUSER özelliğini yalnızca Tek Paket Yazma açıklanan geliştirme yönergelerine göre yazılmışsa ve kullanıcılara paketi kullanıcı başına veya makine başına bağlamında yükleme seçeneği sağlamayı planlıyorsanız ayarlayın. Çift amaçlı paket ayrıca ALLUSERS özelliğinin değerini de 2 olarak başlatmalıdır. Bu, uygulama için varsayılan yükleme bağlamı olarak kullanıcı bazında tanımlar. ALLUSERS özelliğinin değeri 2 dışında bir değerse, Windows Installer MSIINSTALLPERUSER özelliğini yoksayar.

PUASample1.msiiçeriğini incelemek için Orca.exegibi bir Windows Installer veritabanı düzenleyicisi kullanın. Örnek paketteki Özelliği tablosu aşağıdaki iki girdiyi içerir.

Özellik Tablosu (kısmi)

Yükleme Bağlamı için Özel İletişim Kutusu

Örnek paketin kullanıcı arabirimi, kullanıcıların yükleme zamanında kullanıcı başına veya makine başına yükleme bağlamını seçmesini sağlayan verifyReadyDialog adlı özel bir iletişim kutusu örneği içerir. Diyalog tablosu, VerifyReadyDialog iletişim kutusunu açıklayan bir kayıt içerir. Bu iletişim kutusu msidbDialogAttributesVisible (1), msidbDialogAttributesModal (2), msidbDialogAttributesMinimize (4) ve msidbDialogAttributesTrackDiskSpace (32) iletişim stili bitlerikullandığından, Öznitelikler alanına girilen değer 39'dur. İletişim kutusunun başlık çubuğunda, ProductName özelliğinin değeriyle verilen bir başlık gösterilir.

İletişim Kutusu Tablo (kısmi)

Denetimi tablosu, "VerifyReadyDialog" iletişim kutusu tarafından görüntülenen denetimleri için girdiler içerir. İletişim kutusunda PushButton denetimleri ve Metin denetimi görüntülenir. Tüm denetimler, msidbControlAttributesEnabled (2) ve msidbControlAttributesVisible (1) denetim özniteliklerinikullanır. InstallPerMachine denetimi, msidbControlAttributesElevationShield (8388608) ElevationShield denetim özniteliğini de kullanır. Bu denetim özniteliği, InstallPerMachine denetimine Kullanıcı Hesabı Denetimi (UAC) yükseltme simgesini (kalkan simgesi) ekler ve kullanıcıya uygulamayı makine başına bağlamda yüklemek için UAC kimlik bilgilerinin gerekli olduğunu bildirir. Denetim tablosunun Metin alanındaki değer, denetim tarafından görüntülenen metin stili ve metindir. Önceden tanımlanmış stilleri kullanarak denetime metin ekleme hakkında daha fazla bilgi için Denetim tablosu konusundaki Metin alanının açıklamasına bakın.

Denetimi Tablosu (kısmi)

ControlEvent tablosu, kullanıcı bir denetimle etkileşime geçtiğinde yükleyicinin gerçekleştirdiği ControlEventsveya eylemlerini belirtir. Kullanıcı InstallPerUser basma düğmesini etkinleştirdiğinde, OutOfDiskSpaceözelliği 1 ise, MSIINSTALLPERUSER özelliğinin değerini 1 olarak ayarlarsa, ALLUSERS özelliğinin değerini 2 olarak ayarlarsa, MSIFASTINSTALL özelliğini 1 olarak ayarlarsa, kullanıcı arabirimi bir OutOfDisk iletişim kutusu görüntüler. ve döndürür. MSIFASTINSTALL özelliği ayarlandığından yükleme sırasında Sistem Geri Yükleme noktası oluşturulmaz. Kullanıcı InstallPerMachine düğmesine tıkladığında, OutOfDiskSpace özelliği 1 ise kullanıcı arabirimi bir OutOfDisk iletişim kutusu görüntüler, ALLUSERS özelliğinin değerini 1 olarak ayarlar ve geri döner.

ControlEvent Tablosu (kısmi)

InstallPerUser denetimi, Windows Installer Windows Installer 5.0'dan önceki bir Windows Installer sürümü kullanılarak herhangi bir yüklemenin kullanıcı arabiriminden kaldırılmalıdır. Örnek paketteki ControlCondition tablosu, geçerli sürüm Windows Installer 5.0'dan küçükse InstallPerUser denetimini devre dışı bırakmaya ve gizlemeye yönelik dört girdi içerir. Tablo, bu koşulu tanımlamak için VersionMsi özelliğinin değerini ve koşullu deyim söz dizimini kullanır. Eylem alanında belirtilen eylem yalnızca Koşul alanındaki deyim true olduğunda gerçekleştirilir.

ControlCondition Tablosu (kısmi)

Dizin Yapısını Belirtme

PUASample1.msiveritabanının Dizini tablosunu incelemek için düzenleyiciyi kullanın. Directory_Parent alanında boş dize bulunan Dizin Tablosu kaydı, hem kaynak hem de hedef dizin ağaçlarının kök dizinini temsil eder. TARGETDIR özelliği tanımlanmamışsa, yükleyici yükleme zamanında değerini ROOTDRIVE özelliğinin değerine ayarlar. SourceDir özelliği tanımlanmamışsa, yükleyici değerini Windows Installer paketini (.msi dosyası) içeren dizinin konumuna ayarlar. Dizin adları kısa|uzun biçimi kullanılarak belirtilir.

Dizin Tablosu (kısmi)

Kaynakta, bu Directory tablosu aşağıdaki dizin yollarına çözümür.

\[SourceDir\]\\Msft\\Sample1 \[SourceDir\]

Hedefte, Dizin tablosu aşağıdaki tablodaki yollarla çözülür. Yükleyici, ProgramFilesFolder ve ProgramMenuFolder özelliklerinin değerlerini, yükleme bağlamı ve sistemin Windows Server 2008 R2 ve Windows 7'nin 32 bit veya 64 bit sürümleri olup olmadığına bağlı konumlara ayarlar. Hedef klasörlerin yolları, kullanıcının kullanıcı başına mı yoksa makine başına yükleme mi seçtiğine bağlıdır.

Kullanıcı başına uygulamalar, ProgramFilesFolder özelliği değeriyle belirtilen Programlar klasörünün altındaki alt klasörlerde depolanmalıdır. Genellikle, uygulamanın yolu aşağıdaki formu alır.

%LOCALAPPDATA%\Programs\ISV adı\AppName.

Kullanıcı başına yapılandırma verileri, ProgramMenuFolder özelliğinin değeriyle belirtilen Programlar klasöründe depolanmalıdır. Bu klasör genellikle aşağıdaki yolda bulunur.

%APPDATA%\Microsoft\Windows\Başlat Menüsü\Programlar

32 bit Windows Installer Paketi bileşenleri yüklüyorsanız, Directory tablosundaki ProgramFilesFolderve CommonFilesFolder özelliğini kullanın. 64 bit Windows Installer Paketi bileşenlerini yüklüyorsanız, ProgramFiles64Folder ve CommonFiles64Folder özelliklerini kullanın. Uygulamanız aynı bileşenin aynı ada sahip 32 bit ve 64 bit sürümlerini içeriyorsa, bu sürümlerin farklı dizinlere kaydedildiğinden emin olun veya onlara farklı adlar verin.

Aşağıdaki Directory tablosu, 32 bit ve 64 bit bileşenleri içeren ve uygulamalar arasında paylaşılan bazı bileşenleri içeren bir paketle uyumlu bir dizin düzeni örneği sağlar.

Kaynakta, bu Directory tablosu aşağıdaki dizin yollarına çözümür.

\[SourceDir\]Prog32\\Msft\\Sample1\\x32\\myapp \[SourceDir\]Share32\\Common Files\\Msft\\Sample1\\x32\\shared \[SourceDir\]Prog64\\Msft\\Sample1\\x64\\myapp \[SourceDir\]Share64\\Common Files\\Msft\\Sample1\\x64\\shared \[SourceDir\]Sample1

Hedefte yer alan bu Dizin tablosu, aşağıdaki dizin yollarına çözülür. Hedef yollar, yükleme bağlamı ve sisteme bağlıdır.

Uygulama Kaydı

PUASample.msi, uygulamanın Uygulama Yolları kayıt defteri anahtarına bir alt anahtar ekler ve uygulama bilgilerinin bu anahtar altında kayıt defterine kaydedilmesini sağlayan kayıtlar gerçekleştirir. Uygulama Yolları ve uygulama kaydı hakkında daha fazla bilgi için, Kabuk Geliştirici Kılavuzuiçindeki kabuk genişletilebilirliği bölümünde yer alan PerceivedTypes, SystemFileAssociations ve Application Registration kısmına bakın. Yükleme sırasında, kullanıcı uygulamayı kullanıcı başına veya makine başına yükleme bağlamında yükleme kararı alır. İki amaçlı paket yazıldığında, paket geliştiricisi kayıtların HKEY_LOCAL_MACHINE veya HKEY_CURRENT_USER anahtarları altında gerçekleştirilip gerçekleştirilemeyeceğini bilemez.

Paket geliştiricisi, uygulamanın yürütülebilir dosyasının dosya tanımlayıcısını Dosya Tablosunun Dosya alanında tanımlar.

Dosya Tablosu (kısmi)

Kayıt defterine kaydedilecek değerler, Kayıt Defteri tablosunun Değer alanında Biçimlendirilmiş dizesi olarak belirtilebilir. Uygulama Yolları kayıt defteri anahtarının varsayılan değerini belirtmek için, Dosya tablosunun Dosya alanında tanımlanan dosya tanımlayıcısını ve Biçimlendirilmiş türün [#dosya anahtarı] kuralını kullanın. En üst düzey INSTALL eylemi, InstallExecuteSequence tablosundaki eylemleri gerçekleştirir. CostInitialize, FileCostve InstallFinalize eylemleri tamamlandıktan sonra, Windows Installer Kayıt Defteri tablosundaki biçimlendirilmiş [#MyAppFile] alt dizesini uygulama dosyasının tam yoluyla değiştirir.

Örnek, kök anahtarın konumunu içerecek özel bir regroot özelliğini tanımlar ve kullanıcı makine başına bir yükleme seçerse özellik değerini sıfırlamak için özel bir eylem kullanır. Kök konuma başvuran biçimlendirilmiş dize değerlerinde RegRoot özel özelliğini kullanın. Özelliği tablosunda PUASample.msi paketi özel özelliği tanımlar ve RegRoot değerini HKCU olarak ayarlar. Bu, çift amaçlı paketler için önerilen varsayılan bağlam olan kullanıcı başına yükleme bağlamı için özelliğinin değerini başlatır.

Özellik Tablosu (kısmi)

CustomAction tablosunda paket, Set_RegRoot_HKLM adlı özel bir eylem tanımlar. Tür alanındaki değer bunu standart özel eylem Özel Eylem Türü 51 olarak tanımlar. CustomAction tablosundaki Kaynak ve Hedef alanlarının anlamı özel eylem türüne bağlıdır. Standart özel eylem türleri hakkında daha fazla bilgi için bkz. Özel Eylem Türleri. Set_RegRoot_HKLM özel eyleminin Kaynak alanı RegRoot özelliğinin değerini belirtir. Yükleyici özel Set_RegRoot_HKLM eylemi gerçekleştirirse, bu, RegRoot özelliğinin değerini HKLM'ye sıfırlar.

ÖzelEylem Tablosu (kısmi)

En üst düzey INSTALL eylemi, InstallExecuteSequence tablosundaki eylemleri, bu tablonun Sıra alanında belirtilen sırayla gerçekleştirir. Set_RegRoot_HKLM özel eyleminin (1501) Sıra alanında yazılan değer, bu özel eylemin InstallInitialize eyleminden (1500) sonra ve ProcessComponents eyleminden (1600) önce gerçekleştirildiğini belirtir. Bu dizi, Set_RegRoot_HKLM özel eyleminin kaydının yükleme zamanında değerlendirilmesini sağlar. InstallExecuteSequence tablosunda önerilen eylem dizisi hakkında daha fazla bilgi için Önerilen InstallExecuteSequence konusuna bakın. Koşul alanında yazılan koşullu deyim söz dizimi, Set_RegRoot_HKLM eyleminin yalnızca ALLUSERS özelliğinin değeri yükleme zamanında 1 olarak değerlendirilirse gerçekleştirildiğini belirtir. 1 değerine sahip ALLUSERS özelliği, makine başına bir kurulum belirtir.

InstallExecuteSequence Tablosu (kısmi)

Kayıt Defteri tablosundaki aşağıdaki kayıtlar, ProductComponent bileşeni yüklüyse kayıtları gerçekleştirir. Kök alanındaki -1 değeri, kullanıcı başına yükleme için HKEY_LOCAL_MACHINE ve kullanıcı başına yükleme için HKEY_CURRENT_USER altında kaydı gerçekleştirmek için gereklidir. Kayıt Defteri alanında boş dize içeren kayıt, AppPaths kayıt defteri anahtarı altında uygulama için bir alt anahtar ekler ve "(Varsayılan)" değerini uygulamanın yürütülebilir dosyasının tam yoluna ayarlar. MyAppPathAlias kaydı, yürütülebilir dosyayı bir uygulama diğer ismiyle eşler ve kullanıcı komut satırı isteminde "puapct" diğer ismini yazarsa uygulamanın başlatılmasını sağlar. MyAppPathRegistration kaydı, yürütülebilir dosyanın adını dosyanın tam dosya yoluna eşler.

AutoPlay Kaydını İptal Et

Uygulama kullanıcısının, seçilen cihazlar için Donanım Otomatik Yürütme'yi başlatmasını engellemesini sağlayan kayıtları PUASample.msi gerçekleştirir. Bir olaya yanıt olarak Otomatik Yürütme'yi iptal etmek üzere bir işleyici kaydetme hakkında bilgi için, Kabuk Geliştirici Kılavuzuiçindeki kabuk genişletilebilirliği bölümünde bulunan Donanım ve Yazılımı Otomatik Yürütme ile Kullanıma Hazırlama konusuna bakın. Aşağıdaki kayıt, ProductComponent bileşeni yüklendiğinde Ad alanında belirtilen işleyiciyi kaydeder. Kök alanındaki -1 değeri, Windows Installer'a kaydın yükleme bağlamını temel alan bir konuma yeniden yönlendirileceğini belirtmek için gereklidir.

Kayıt Defteri Tablosu

önizleme işleyicisi kaydı

PUASample.msi, uygulamayı başlatmadan .pua dosyalarının salt okunur önizlemesini sağlayan bir önizleme işleyicisi yüklemek için gereken kayıtları gerçekleştirir. Önizleme işleyicilerini kaydetme hakkında bilgi için, Kabuk Geliştirici Kılavuzuiçindeki kabuk genişletilebilirliği bölümünde yer alan Önizleme İşleyicilerini Kaydetme konusuna bakın. Kayıt Defteri tablosundaki aşağıdaki kayıtlar, ProductComponent bileşeni yüklendiğinde işleyiciyi kaydeder. Kök alanındaki -1 değeri, Windows Installer'a kaydın yükleme bağlamını temel alan bir konuma yeniden yönlendirileceğini belirtmek için gereklidir.

Kayıt Defteri Tablosu