Voorbeeld van het samenstellen van een enkel pakket

Het voorbeeld PUASample.msi is een voorbeeld van een Windows Installer 5.0-pakket voor twee doeleinden dat kan worden geïnstalleerd in de installatiecontext per gebruiker of per computer installatiecontext op Windows Server 2008 R2 en Windows 7. Dit voorbeeldpakket volgt de ontwikkelingsrichtlijnen die worden beschreven in Single Package Authoring.

Een kopie van het voorbeeld verkrijgen

Een kopie van dit voorbeeld en een Windows Installer-databasetabeleditor, Orca.exe, bevinden zich in de Windows SDK-onderdelen voor Windows Installer-ontwikkelaars. De voorbeeld- en tabeleditor worden geleverd met de Windows Software Development Kit voor Windows Server 2008 R2 en Windows 7 als de Installatiebestanden van Windows Installer PUASample1.msi en Orca.msi.

Systeemvereisten

De database-editor, Orca.exe, vereist Windows Server 2008 R2 en eerder en Windows 7 en eerder. Het tweeledig pakket, PUASample1.msi, kan worden geïnstalleerd in de installatiecontext per machine of per gebruiker op Windows Server 2008 R2 en Windows 7. PUASample1.msi kan alleen worden geïnstalleerd in de context per computer op Windows Server 2008 en eerder en Windows Vista en eerder. U kunt de database-editor installeren om de inhoud van PUASample1.msi te onderzoeken zonder het voorbeeld te installeren. Als u de voorbeeld- of editorpakketten wilt installeren, moet u ervoor zorgen dat het DisableMSI--beleid niet is ingesteld op een waarde die toepassingsinstallaties blokkeert.

Een Dual-Purpose-pakket identificeren

Pakketten met twee doeleinden moeten de waarde van de eigenschap MSIINSTALLPERUSER initialiseren op 1. Hiermee wordt het pakket geïdentificeerd dat kan worden geïnstalleerd in de context per machine of per gebruiker op Windows Server 2008 R2 en Windows 7. Stel de eigenschap MSIINSTALLPERUSER alleen in het pakket in als deze is geschreven volgens de ontwikkelingsrichtlijnen die worden beschreven in single package authoring en als u gebruikers de optie wilt bieden om het pakket te installeren in de context per gebruiker of per machine. Een pakket voor twee doeleinden moet ook de waarde van de eigenschap ALLUSERS initialiseren op 2. Dit specificeert de standaardinstallatiecontext per gebruiker voor de toepassing. Als de waarde van de eigenschap ALLUSERS een andere waarde is dan 2, negeert Windows Installer de eigenschap MSIINSTALLPERUSER.

Gebruik een Windows Installer-database-editor, zoals Orca.exe, om de inhoud van PUASample1.msite onderzoeken. De eigenschapstabel in het voorbeeldpakket bevat de volgende twee vermeldingen.

Eigenschap Tabel (gedeeltelijk)

Aangepast dialoogvenster voor installatiecontext

De gebruikersinterface van het voorbeeldpakket bevat een voorbeeld van een aangepast dialoogvenster, VerifyReadyDialog, waarmee gebruikers de installatiecontext per gebruiker of per machine kunnen selecteren tijdens de installatie. De tabel Dialoogvenster bevat een record waarin het dialoogvenster VerifyReadyDialog wordt beschreven. De waarde die is ingevoerd in het veld Kenmerken is 39 omdat in dit dialoogvenster de msidbDialogAttributesVisible (1), msidbDialogAttributesModal (2), msidbDialogAttributesMinimize (4) en msidbDialogAttributesTrackDiskSpace (32) dialoogvensterstijl bitsgebruikt. Op de titelbalk van het dialoogvenster wordt een titel weergegeven die is opgegeven door de waarde van de eigenschap ProductName.

dialoogvenster tabel (gedeeltelijk)

De tabel Control bevat vermeldingen voor de bedieningselementen die worden weergegeven in het dialoogvenster VerifyReadyDialog. In het dialoogvenster worden de besturingselementen PushButton en een besturingselement Text weergegeven. Alle besturingselementen maken gebruik van de msidbControlAttributesEnabled (2) en msidbControlAttributesVisible (1) besturingskenmerken. Het besturingselement InstallPerMachine maakt ook gebruik van het ElevationShield besturingskenmerk msidbControlAttributesElevationShield (8388608). Dit besturingskenmerk voegt het UAC-verhogingspictogram (schildpictogram) toe aan het besturingselement InstallPerMachine en informeert de gebruiker dat UAC-referenties vereist zijn om de applicatie in de per-machinecontext te installeren. De waarde in het veld Tekst van de tabel Control is de tekststijl en de tekst die door het besturingselement wordt weergegeven. Zie de beschrijving van het veld Tekst in het onderwerp Besturingselementtabel voor meer informatie over het toevoegen van tekst aan een besturingselement met behulp van vooraf gedefinieerde stijlen.

Control Table (gedeeltelijk)

De tabel ControlEvent specificeert de ControlEvents, of acties, die het installatieprogramma uitvoert wanneer de gebruiker met een besturingselement interactie heeft. Wanneer een gebruiker de InstallPerUser-knop activeert, toont de gebruikersinterface een OutOfDisk-dialoogvenster als de eigenschap OutOfDiskSpace de waarde 1 heeft. Vervolgens wordt de waarde van de eigenschap MSIINSTALLPERUSER ingesteld op 1, de waarde van de eigenschap ALLUSERS ingesteld op 2, en de eigenschap MSIFASTINSTALL ingesteld op 1, waarna het proces wordt afgerond. Omdat de eigenschap MSIFASTINSTALL is ingesteld, wordt er geen systeemherstelpunt gegenereerd voor de installatie. Wanneer een gebruiker de InstallPerMachine-knop activeert, wordt in de gebruikersinterface een OutOfDisk-dialoogvenster weergegeven als de eigenschap OutOfDiskSpace 1 is; vervolgens wordt de waarde van de eigenschap ALLUSERS op 1 ingesteld en wordt er geretourneerd.

ControlEvent Tabel (gedeeltelijk)

Het onderdeel InstallPerUser moet worden verwijderd uit de gebruikersinterface van een installatie die een Windows Installer-versie gebruikt die ouder is dan Windows Installer 5.0. De tabel ControlCondition in het voorbeeldpakket bevat vier vermeldingen die InstallPerUser uitschakelen en verbergen als de huidige versie van Windows Installer lager is dan 5.0. De tabel gebruikt de waarde van de eigenschap VersionMsi en de syntaxis van de voorwaardelijke instructie om deze voorwaarde te definiëren. De actie die is opgegeven in het veld Actie wordt alleen uitgevoerd als de instructie in het veld Voorwaarde waar is.

ControlCondition Tabel (gedeeltelijk)

Mapstructuur opgeven

Gebruik de database-editor om de tabel Directory van PUASample1.msite onderzoeken. De record van de maptabel met een lege tekenreeks in het Directory_Parent veld vertegenwoordigt de hoofdmap van zowel de bron- als doelmapstructuren. Als de eigenschap TARGETDIR niet is gedefinieerd, stelt het installatieprogramma de waarde tijdens de installatie in op de waarde van de eigenschap ROOTDRIVE. Als de eigenschap SourceDir niet is gedefinieerd, stelt het installatieprogramma de waarde in op de locatie van de map met het Windows Installer-pakket (.msi bestand.) De mapnamen worden opgegeven met de korte|lange indeling.

Adreslijst Tabel (gedeeltelijk)

Aan de bron wordt deze Directory tabel vertaald naar de volgende directorypaden.

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

De Directory--tabel verwijst naar de paden in de volgende tabel. Het installatieprogramma stelt de waarden van de eigenschappen ProgramFilesFolder en ProgramMenuFolder op locaties die afhankelijk zijn van de installatiecontext en of het systeem de 32-bits of 64-bits versies van Windows Server 2008 R2 en Windows 7 is. De paden naar de doelmappen zijn afhankelijk van of de gebruiker een installatie per gebruiker of per computer selecteert.

Toepassingen per gebruiker moeten worden opgeslagen in submappen onder de map Programma's die zijn opgegeven door de waarde van ProgramFilesFolder eigenschap. Normaal gesproken heeft het pad naar de toepassing de volgende vorm.

%LOCALAPPDATA%\Programs\ISV name\AppName.

Configuratiegegevens per gebruiker moeten worden opgeslagen in de map Programma's die zijn opgegeven door de waarde van de eigenschap ProgramMenuFolder. Deze map bevindt zich meestal op de volgende locatie.

%APPDATA%\Microsoft\Windows\Start Menu\Programs

Als u 32-bits Windows Installer-pakket onderdelen installeert, gebruikt u de eigenschap ProgramFilesFolder en CommonFilesFolder in de tabel Directory. Als u 64-bits Windows Installer-pakket onderdelen installeert, gebruikt u de eigenschappen ProgramFiles64Folder en CommonFiles64Folder. Als uw toepassing 32-bits en 64-bits versies van hetzelfde onderdeel bevat met dezelfde naam, moet u ervoor zorgen dat deze versies worden opgeslagen in verschillende mappen of deze verschillende namen geven.

De volgende Directory tabel bevat een voorbeeld van een mapindeling die compatibel is met een pakket dat 32-bits en 64-bits onderdelen bevat en enkele onderdelen bevat die worden gedeeld tussen toepassingen.

Bij de bron wordt deze Directory tabel omgezet in de volgende mappaden.

\[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

Op de bestemming wordt deze Directory- tabel omgezet in de volgende directorypaden. De doelpaden zijn afhankelijk van de installatiecontext en het systeem.

Toepassingsregistratie

De PUASample.msi voegt een subsleutel toe aan de App Paths-registersleutel voor de toepassing en registreert deze zodat informatie over de toepassing kan worden opgeslagen in het register onder deze sleutel. Zie de PerceivedTypes, SystemFileAssociations en Application Registration in het gedeelte shell extensibility van de Shell Developer's Guidevoor meer informatie over App-paden en toepassingsregistratie. Tijdens de installatie neemt de gebruiker de beslissing om de toepassing te installeren in de installatiecontext per gebruiker of per machine. Op het moment dat het pakket met twee doeleinden is gemaakt, kan de pakketontwikkelaar niet weten of de registraties moeten worden uitgevoerd onder de HKEY_LOCAL_MACHINE- of HKEY_CURRENT_USER sleutels.

De pakketontwikkelaar definieert de bestands-id voor het uitvoerbare bestand van de toepassing in het veld Bestand van de File Table.

bestand tabel (gedeeltelijk)

Waarden die in het register moeten worden opgeslagen, kunnen worden gespecificeerd in het veld Waarde van de tabel Register als een geformatteerde tekenreeks. Gebruik de bestands-id die is gedefinieerd in het veld Bestand van de tabel File en de conventie [#filekey] van het opgemaakte type om de standaardwaarde voor de registersleutel App-paden op te geven. De INSTALL-actie op het hoogste niveau voert de acties uit in de InstallExecuteSequence-tabel. Nadat de CostInitialize, FileCosten InstallFinalize acties in deze tabel zijn voltooid, vervangt Windows Installer de opgemaakte subtekenreeks [#MyAppFile] in de registertabel door het volledige pad naar het toepassingsbestand.

Het voorbeeld definieert een aangepaste eigenschap, RegRoot, die de locatie van de hoofdsleutel bevat en gebruikt een aangepaste actie om de eigenschapswaarde opnieuw in te stellen als de gebruiker een installatie per computer kiest. Gebruik de aangepaste eigenschap RegRoot in opgemaakte tekenreekswaarden die verwijzen naar de hoofdlocatie. In de eigenschap tabel definieert het PUASample.msi pakket de aangepaste eigenschap en stelt de waarde van RegRoot in op HKCU. Hiermee initialiseert u de waarde van de eigenschap voor de installatiecontext per gebruiker, de aanbevolen standaardcontext voor pakketten met twee doeleinden.

Eigenschap Tabel (gedeeltelijk)

In de tabel CustomAction definieert het pakket een aangepaste actie met de naam Set_RegRoot_HKLM. De waarde in het veld Type identificeert deze als een aangepaste actietype 51 standaard aangepaste actie. De betekenis van de velden Bron en Doel in de tabel CustomAction is afhankelijk van het aangepaste actietype. Zie Aangepaste actietypenvoor meer informatie over de standaardtypen van aangepaste acties. Het veld Bron voor de aangepaste actie Set_RegRoot_HKLM specificeert dat de waarde van de eigenschap RegRoot is. Als het installatieprogramma de aangepaste Set_RegRoot_HKLM actie uitvoert, wordt de waarde van de eigenschap RegRoot opnieuw ingesteld op HKLM.

CustomAction Table (gedeeltelijk)

Met de bovenliggende actie INSTALL worden de acties in de InstallExecuteSequence-tabel uitgevoerd, in de volgorde die is opgegeven in het veld Volgorde van die tabel. De waarde die is geschreven in het veld Reeks voor de aangepaste actie Set_RegRoot_HKLM (1501) geeft aan dat deze aangepaste actie moet worden uitgevoerd na de actie InstallInitialize (1500) en vóór de actie ProcessComponents (1600.) Deze volgorde zorgt ervoor dat de record voor de Set_RegRoot_HKLM aangepaste actie tijdens de installatie wordt geëvalueerd. Zie het onderwerp Suggested InstallExecuteSequence voor meer informatie over de aanbevolen reeks acties in de tabel InstallExecuteSequence. De syntaxis van de voorwaardelijke verklaring, opgesteld in het veld 'Voorwaarde', geeft aan dat de Set_RegRoot_HKLM-actie alleen wordt uitgevoerd als de waarde van de eigenschap ALLUSERS op installatie tijd resulteert in 1. Een ALLUSERS eigenschapswaarde van 1 specificeert een installatie per machine.

Installatie-Uitvoer-Volgorde Tabel (gedeeltelijk)

De volgende records in de register- tabel zorgen voor het uitvoeren van de registraties als de ProductComponent-component is geïnstalleerd. De waarde -1 in het hoofdveld is vereist voor het uitvoeren van de registratie onder HKEY_LOCAL_MACHINE voor een installatie per gebruiker en onder HKEY_CURRENT_USER voor een installatie per gebruiker. De record met een lege tekenreeks in het veld Register voegt een subsleutel toe voor de toepassing onder de registersleutel AppPaths en stelt de waarde '(Standaard)' in op het volledige pad van het uitvoerbare bestand van de toepassing. De registratie van MyAppPathAlias wijst het uitvoerbare bestand toe aan een toepassingsalias en stelt de toepassing in staat om te worden gestart als de gebruiker de alias 'puapct' typt bij een opdrachtregelprompt. De registratie van MyAppPathRegistration wijst de naam van het uitvoerbare bestand toe aan het volledige pad van het bestand.

Automatisch afspelen-registratie annuleren

De PUASample.msi voert registraties uit waarmee de toepassingsgebruiker kan voorkomen dat Hardware Autoplay wordt gestart voor geselecteerde apparaten. Zie voor informatie over het registreren van een handler om AutoPlay te annuleren als reactie op een gebeurtenis het onderwerp Hardware en software voor gebruik voorbereiden met AutoPlay in de sectie shell uitbreidbaarheid van de Shell Developer's Guide. De volgende record registreert de handler die is opgegeven in het veld Naam wanneer het onderdeel ProductComponent is geïnstalleerd. De waarde -1 in het hoofdveld is vereist om op te geven aan Windows Installer dat de registratie moet worden omgeleid naar een locatie die afhankelijk is van de installatiecontext.

Registerlijst Tabel

Preview-handlerregistratie

De PUASample.msi voert registraties uit die vereist zijn voor het installeren van een preview-handler waarmee een alleen-lezenvoorbeeld van .pua-bestanden mogelijk is zonder de toepassing te starten. Voor informatie over het registreren van preview-handlers, zie het onderwerp Preview-handlers registreren in de sectie shell-uitbreidbaarheid van de Shell Developer's Guide. De volgende records in de tabel Registry registreren de handler wanneer het onderdeel ProductComponent is geïnstalleerd. De waarde -1 in het hoofdveld is vereist om op te geven aan Windows Installer dat de registratie moet worden omgeleid naar een locatie die afhankelijk is van de installatiecontext.

Register Tabel