How to: Install Prerequisites with a ClickOnce Application

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

Deployment in Visual Studio

All ClickOnce applications require that the correct version of the .NET Framework is installed on a computer before they can be run; many applications have other prerequisites as well. When publishing a ClickOnce application, you can choose a set of prerequisite components to be packaged along with your application. At installation time, a check will be performed for each prerequisite to determine if it already exists; if not it will be installed prior to installing the ClickOnce application.

Instead of packaging and publishing prerequisites, you can also specify a download location for the components. For example, rather than including prerequisites with every application that you publish, you might use a centralized file share or Web location that contains the installers for all of your prerequisites—at install time, the components will be downloaded and installed from that location.

Prerequisites are managed in the Prerequisites dialog box, accessible from the Publish pane of the Project Designer.

Note:
In addition to the predetermined list of prerequisites, you can add your own components to the list. For more information, see Adding Custom Prerequisites.

To specify prerequisites to install with a ClickOnce application

With a project selected in Solution Explorer, on the Project menu click Properties.
Select the Publish pane.
Click the Prerequisites button to open the Prerequisites dialog box.
In the Prerequisites dialog box, make sure that the Create setup program to install prerequisite components check box is selected.
In the Prerequisites list, check the components that you wish to install, and then click OK.
The selected components will be packaged and published along with your application.

To specify a different download location for prerequisites

With a project selected in Solution Explorer, on the Project menu click Properties.
Select the Publish pane.
Click the Prerequisites button to open the Prerequisites dialog box.
In the Prerequisites dialog box, make sure that the Create setup program to install prerequisite components check box is selected.
In the Specify the install location for prerequisites section, select Download prerequisites from the following location.
Select a location from the drop-down list, or enter a URL, file path, or FTP location, and then click OK.
Note:
You must make sure that installers for the specified components exist at the specified location.

Note:
You must make sure that installers for the specified components exist at the specified location.

Tags

: Add a tag

Flag as ContentBug

Updating the publish location URL in the bootstrapper (setup.exe)

jenlouie | Edit | Show History

The prerequisite bootstrapper (setup.exe) has a number of arguments that allow you to update it without having to regenerate the entire deployment package.

If you are planning on moving your ClickOnce package to a new server, this is important to note. If you're updating the -url, -componentsurl, or -homesite tags, you'll need to use the undocumented -dest flag.

-? : Show usage dialog.
-url or -componentsurl : Show the stored URL and components URL for this setup.
-url=<location> : Sets the URL source to the specified location.
-componentsurl=<location> : Sets the location to download prerequisites from. If it's blank, the prerequisites are downloaded from where the application is located or the homesite (if set).
-homesite=<true or false> : When set to true, downloads the components from their vendors' website, orverrides the components URL.
-dest=<name of new setup exe> : This is an undocumented flag. Use this when a new setup bootstrapper needs to be created with an updated URL, components URL, or homesite. You would do this by: 1) Copy setup.exe to foo.exe. 2) Run foo.exe to modify the original setup.exe: foo.exe /url=http://test/me /dest=setup.exe 3) Delete foo.exe.

To specify prerequisites to install with a ClickOnce application

To specify a different download location for prerequisites

Tasks

Concepts

Other Resources