Creating Bootstrapper Packages

The Setup program is a generic installer that can be configured to detect and install redistributable components such as Windows Installer (.msi) files and executable programs. The installer is also known as a bootstrapper. It is programmed through a set of XML manifests that specify the metadata to manage the installation of the component.

The bootstrapper first detects whether any of the prerequisites are already installed. If prerequisites are not installed, first the bootstrapper shows the license agreements. Second, after the end-user accepts the license agreements, the installation begins for the prerequisites. Otherwise, if all the prerequisites are detected, the bootstrapper just starts the application installer.

Creating Custom Packages

You can generate the manifests by using the XML Editor in Visual Studio. For more information, see How to: Create a Package Manifest and How to: Create a Product Manifest. To see an example of creating a bootstrapper package, see Walkthrough: Creating a Custom Bootstrapper to Show a Privacy Prompt.

To create a bootstrapper package, you have to supply the redistributable in the form of an EXE or MSI file.to the Bootstrapper Manifest Generator. Then, the Bootstrapper Manifest Generator creates the following files:

  • The product manifest, product.xml, which contains any language-neutral metadata for the package. This contains metadata common to all the localized versions of the redistributable component.

  • The package manifest, package.xml, which contains language-specific metadata; it typically contains localized error messages. A component must have at least one package manifest for each localized version of that component.

After these files are created, put the product manifest file into a folder named for the custom bootstrapper. The package manifest file goes into a folder named for the locale. For example, if the package manifest file is for English redistribution, put the file into a folder called en. Repeat this process for each locale, such as ja for Japanese and de for German. The final custom bootstrapper package could have the following folder structure.

CustomBootstrapperPackage

product.xml

CustomBootstrapper.msi

de

eula.rtf

package.xml

en

eula.rtf

package.xml

ja

eula.rtf

package.xml

Finally, copy the redistributable files into the bootstrapper folder location. For more information, see How to: Create a Localized Bootstrapper Package.

\Program Files\Microsoft SDKs\Windows\v8.0A\Bootstrapper\Packages

You can also determine the bootstrapper folder location from the Path value in the following registry key:

HKLM\Software\Microsoft\GenericBootstrapper\11.0

On 64 bit systems, use the following registry key:

HKLM\Software\Wow6432Node\Microsoft\GenericBootstrapper\11.0

Each redistributable component appears in its own subfolder under the packages directory. The product manifest and redistributable files are put into this subfolder. Localized versions of the component and package manifests are put in subfolders named according to Culture Name.

After these files are copied into the bootstrapper folder, the bootstrapper package automatically appears in the Visual Studio prerequisites dialog box. If your custom bootstrapper package does not appear, close and then reopen the Prerequisites Dialog Box. For more information, see Prerequisites Dialog Box.

The following table shows the properties that are automatically populated by the bootstrapper.

Property

Description

ApplicationName

The name of the application.

ProcessorArchitecture

The processor and bits-per-word of the platform targeted by an executable. Values include the following:

  • Intel

  • IA64

  • AMD64

Version9x

The version number for Microsoft Windows 95, Windows 98, or Windows ME operating systems. The syntax of the version is Major.Minor.ServicePack.

VersionNT

The version number for the Windows NT, Windows 2000, Windows XP, Windows Vista, Windows Server 2008, or Windows 7 operating systems. The syntax of the version is Major.Minor.ServicePack.

VersionMSI

The version of the Windows Installer assembly (msi.dll) run during the installation.

AdminUser

This property is set if the user has administrator privileges. Values are true or false.

InstallMode

The installation mode indicates where the component needs to be installed from. Values include the following:

  • HomeSite - prerequisites are installed from the vendor's Web site.

  • SpecificSite - prerequisites are installed from the location that you select.

  • SameSite - prerequisites are installed from the same location as the application.

Separating Redistributables from Application Installations

You can prevent your redistributable files from being deployed in Setup projects. To do this, create a redistributable list in the RedistList folder in your .NET Framework directory:

%ProgramFiles%\Microsoft.NET\RedistList

The redistributable list is an XML file that you should name using the following format: Company Name.Component Name.RedistList.xml. So, for example, if the component is called Datawidgets made by Acme, use Acme.DataWidgets.RedistList.xml. An example of the redistributable list's contents might resemble this:

<?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>

See Also

Tasks

How to: Install Prerequisites with a ClickOnce Application

Reference

Prerequisites Dialog Box

Product and Package Schema Reference

Other Resources

Use the Visual Studio 2005 Bootstrapper to Kick-Start Your Installation