WiX: A Developer's Guide to Windows Installer XML Bytom

WiX is an open source project and a toolset that builds Windows installation packages from XML source code. WiX, which is used internally by Microsoft and by many companies around the World, simplifies many of the installation tasks that used to be shrouded in mystery. The tool set provides a command-line environment that you can integrate into your old-style build processes or you can use the newer technology from inside integrated development environments to build your setup packages. You'll find that you understand your installer better, can create it in less time, and save money in the process. No one really wants to devote a lifetime to understanding how to create a hassle-free installer for any software.This hands-on guide takes the mystery out of Windows Installer by showing how simple XML elements can be leveraged to create a sophisticated install package. By relying on Microsoft standards, you'll be able to use features like Property elements to customize your application's entry in Add/Remove Programs, the Shortcut element to create Start menu shortcuts, and other specialized elements for building upgrade and patch support and more.This book will show you the fundamental ingredients needed to build a professional-grade installer using Windows Installer XML. The initial chapters will introduce you to the set of required elements necessary to build a simple installer. We'll then explore those basic elements in more detail and see how best to use them in the real world.In the ensuing chapters, you'll move on to learn about adding conditions that alter what the user can install, then how to add actions to the install sequence and how to author a user interface. We'll move on to advanced topics such as editing data in the Windows Registry, installing a Windows service, and building your project from the command line. Finally, you'll learn to localize your package for different languages and detect older versions during upgrades. Each chapter uses to-the-point examples to illustrate the best way to use the language. Spis treści: WiX: A Developers Guide to Windows Installer XMLWiX: A Developer's Guide to Windows Installer XMLCreditsAbout the AuthorAbout the ReviewerPrefaceWhat this book coversWhat you need for this bookWho this book is forConventionsReader feedbackCustomer supportErrataPiracyQuestions1. Getting StartedIntroducing Windows Installer XMLWhat is WiX?Is WiX for you?Where can I get it?VotiveA word about GUIDsYour first WiX projectXML declaration and Wix elementProduct elementPackage elementMedia elementDirectoriesComponentsFilesFeaturesStart Menu shortcutsPutting it all togetherAdding a User InterfaceViewing the MSI databaseOrca.exeTurning logging on during installationOther resourcesSummary2. Creating Files and DirectoriesFile elementDirectoryRef elementComponentGroup elementFragment elementHarvesting files with heat.exeCopying and moving filesCopying files you installCopying existing filesMoving existing filesInstalling special-case filesAdding assembly files to the GACInstalling a TrueType fontCreating an empty folderSetting file permissionsSpeeding up file installationsSummary3. Putting Properties and AppSearch to WorkCustom propertiesDeclaring and setting propertiesReferencing propertiesProperty visibility and scopeSecure propertiesProperty datatypesPredefined Windows Installer propertiesImplied propertiesCited propertiesAppSearchDirectorySearchFileSearchComponentSearchRegistrySearchIniFileSearchSummary4. Improving Control with Launch Conditions and Installed StatesConditionsCondition syntaxLaunch conditionsFeature conditionsComponent conditionsAction stateInstalled stateSummary5. Understanding the Installation SequenceInstallUISequenceUI standard actionsAppSearchLaunchConditionsValidateProductIDCostInitializeFileCostCostFinalizeExecuteActionInstallExecuteSequenceExecute standard actionsInstallValidateInstallInitializeProcessComponentsUnpublishFeaturesRemoveRegistryValuesRemoveShortcutsRemoveFilesInstallFilesCreateShortcutsWriteRegistryValuesRegisterUserRegisterProductPublishFeaturesPublishProductInstallFinalizeImmediate vs. deferredCustom actionsSet a Windows Installer PropertySet the location of an Installed DirectoryRun embedded VBScript or JScriptCall an external VBScript or JScript fileCall a function from a dynamic-link libraryTrigger an executableSend an error that stops the installationRollback custom actionsAccessing properties in a deferred actionAdding conditions to custom actionsDeployment Tools FoundationSession objectGetting and setting propertiesLoggingShowing a MessageBoxAccessing feature and component statesQuerying the MSI databaseInserting rows into the MSI databaseSummary6. Adding a User InterfaceWiX standard dialog setsWixUI_AdvancedWixUI_FeatureTreeWixUI_InstallDirWixUI_MondoCustomizing a standard dialog setCreating your own dialogsICE20 errorsAdding dialog filesScheduling dialogsDialog elementAdding TextStyle elementsAdding a tabbable controlAdding a progress dialogModal windowsICE20 revisitedFilesInUseErrorFatalErrorUserExitExitSummary7. Using UI ControlsControlsPushButtonTextScrollableTextLineGroupBoxBitmapIconEditMaskedEditPathEditCheckBoxRadioButtonGroupComboBoxListBoxListViewDirectoryListDirectoryComboSelectionTreeVolumeCostListVolumeSelectComboBillboardProgressBarSummary8. Tapping into Control EventsPublish elementSubscribe elementPublish eventsAddLocalDoActionEndDialogNewDialogPublishing a propertySubscribe eventsScriptInProgressSelectionActionTimeRemainingSummary9. Working from the Command LineCandle.exeCommand-line arguments (compiling)-arch-d-ext-fips-I-nologo-o-p-pedantic-sfdvital-ss-sw-trace-v-wxResponse files.wixobj filesCompile-time variablesEnvironment variablesSystem variablesCustom variablesPreprocessor extensionsConditional statements and iterationsif...elseif...elseifdefifndefIterationsErrors and warningsLight.exeCommand-line arguments (linking)-ai-b-bf-binder-cultures-d-dut-ext-loc-nologo-notidy-o[ut]-pedantic-sadmin-sadv-sloc-sma-ss-sts-sui-sv-sw[N]-usf -v-wx[N]-xoCommand-line arguments (binding)-bcgg-cc -ct -cub -dcl:level-eav-fv-ice-pdbout -reusecab-sa-sacl-sf-sh-sice:-sl-spdb-svalLink-time variablesLocalization variablesBinder variablesCustom variablesBuilding an installer without Visual StudioSummary10. Accessing the Windows RegistryReading from the RegistryWriting to the RegistryRegistryValueRegistryKeySetting NeverOverwriteRemoving Registry valuesRemoveRegistryKeyRemoveRegistryValueCopying Registry valuesRegistry permissionsSummary11. Controlling Windows ServicesCreating a simple Windows serviceUsing sc.exeUsing WiX to install a serviceStarting, stopping, and uninstalling a serviceSetting the service's user accountAdding service dependenciesService recovery with Util:ServiceConfigSummary12. Localizing Your InstallerSetting language and code page attributesPackage elementProduct elementWiX localization filesThe role of Light.exeLocalizing error messagesLocalizing the EULACreating a multi-language MSISummary13. Upgrading and PatchingPlanning for updatesChoosing an update typePer-user or per-machineMajor upgradeMinor upgradeAuthoring a patch fileBuilding the patch on the command lineSmall updateSummary