WiX Cookbook

WiX Cookbook

By : Nicholas Matthew Ramirez

1 (1)

Buy this Book

WiX Cookbook

1 (1)

By: Nicholas Matthew Ramirez

Buy this Book

Overview of this book

WiX is a dialect of XML used to make installers for Windows. Its declarative style avoids the complexity and limitations of procedural code, providing you with everything you need to package up an entire application into a single MSI file. This book gives you a good overview of WiX's capabilities to develop your own installer packages with functionalities beyond those available in Windows Installer. In the recipes of this book, you will see ways in which WiX can cut down on your installation time and help you streamline your deployment processes. You will see how to make customized installer UIs, write custom actions, create shortcuts, and also set your application as the default for a file type.

WiX Cookbook

Credits

About the Author

About the Reviewers

www.PacktPub.com

Preface

Free Chapter

Organizing and Building WiX Projects

Introduction

Installing WiX and creating a new project in Visual Studio 2013

Referencing the output of a .NET console application in a WiX project by using a preprocessor variable

Separating a portion of WIX markup into its own library

Compiling a WiX installer on a build machine using MSBuild

Building a WiX installer from the command line

Installing Files and Directories

Introduction

Installing directories onto the target computer

Adding a file to a directory

Installing a 64-bit executable file to Program Files

Including one component or another depending on the condition

Using the heat.exe tool to generate components

File and Folder Permissions

Introduction

Changing the permissions on a folder for a user

Changing the permissions on a file for a user

Marking a file as read only

Creating a file share

Setting the default program for a file type

Shortcuts

Introduction

Adding an application shortcut to the Start menu

Adding an icon to a shortcut

Placing a shortcut on the desktop

Creating a shortcut to a folder

Creating an advertised shortcut that installs a feature on demand

Editing XML Files during Installation

Introduction

Adding a new element to an XML file during installation

Setting the value of an attribute on an XML element

Inserting inner text into an XML element

Adding an XML element only if it does not already exist

Removing an XML element

Custom Actions

Introduction

Creating a C# custom action and referencing it in your project

Passing information entered by a user to a deferred custom action

Preventing custom action data from being displayed in the install log

Running an executable as a custom action without showing a console window by using CAQuietExec

Testing rollback custom actions with WixFailWhenDeferred

Installing Wizards

Introduction

Adding a wizard to guide users through the installation

Changing the logo images and default license agreement text of the wizard

Customizing the wizard by adding a new dialog window to it

Deciding which dialog to show next depending on the user's choices

Setting a property based on user input

Users and Groups

Introduction

Creating a local user

Adding a new user to a new group

Adding a new user to an existing group

Adding an existing user to a new group

Adding a new user with the log on as a service security setting

Handling Prerequisites

Introduction

Stopping the installation with a launch condition

Installing only to supported versions of Windows

Redistributing the .NET Framework with a bootstrapper

Executing either a 64-bit or 32-bit MSI depending on the user's operating system

Downloading resources from the Web with a web installer

Installing Websites

Introduction

Spinning up a new application pool in IIS

Adding a website to IIS that runs under your app pool

Creating a virtual directory

Adding a web application to IIS

Setting up a website to use SSL

Linking to the Web

Introduction

Adding a hyperlink control to a wizard dialog

Opening an installed HTML file after a successful installation

Launching a web page when a user uninstalls our software

Installing a shortcut that opens a web page

Updating programs and features to show a link to our company's website

Installing SQL Server Databases

Introduction

Installing a SQL Server instance with a bootstrapper

Adding a database to a SQL Server instance

Creating a table within a SQL Server database

Inserting data into a database table

Creating an ODBC data source for a SQL Server instance

Admin Tasks

Introduction

Setting an environment variable

Creating a scheduled task

Defining a new event source for the Windows event viewer

Registering a performance counter

Adding an exception to Windows Firewall

Index

Customer Reviews

1 (1)

5 star

4 star

3 star

2 star

1 star

100%

Placing a shortcut on the desktop

The Start menu is the best place to place application shortcuts because it keeps them organized and users only see them when they want to. The desktop comes in second though, displaying a user's favorite links front and center.

In this recipe, we'll place a shortcut to our Sample.txt file on the user's desktop. As we've discussed previously, who will see this shortcut depends on the value of the Package element's InstallScope attribute. When it's set to perMachine, all users will see the shortcut. When set to perUser, it will be installed only for the current user.

Getting ready

To prepare for this recipe, perform the following steps:

Create a new setup project and name it DesktopShortcutInstaller.

Include a text file named Sample.txt in the project and add a Component element to the Product.wxs file:

<ComponentGroup Id="ProductComponents" 
                Directory="INSTALLFOLDER">
  <Component Id="cmpSampleTXT" 
             Guid="{EB57CD24-8DEE-41EC...

WiX Cookbook

By : Nicholas Matthew Ramirez

WiX Cookbook

By: Nicholas Matthew Ramirez

Overview of this book

Related Content you might be interested in

Current Title:

WiX Cookbook

Placing a shortcut on the desktop

Getting ready