MageUI.exe Deployment Manifest Tab

This topic describes the Deployment Manifest tab for the graphical Manifest Generation and Editing Tool (MageUI.exe).

The Deployment Manifest tab contains the following tabs.

UI Element

Description

Name

Specifies identifying information about this deployment.

Description

Specifies publisher, product, and support information.

Deployment Options

Specifies additional information about the deployment, such as the application type and the start location.

Update Options

Specifies how often ClickOnce should check for application updates.

Application Reference

Specifies the application manifest for this deployment.

Name Tab

The Name tab is displayed when you first create or open a deployment manifest. It uniquely identifies the deployment, and optionally specifies a valid target platform.

UI Element

Description

Name

Required. The name of the deployment manifest. Usually the same as the file name.

Version

Required. The version number of the deployment in the form N.N.N.N. Only the first major build number is required. For example, for version 1.0 of an application, valid values would include 1, 1.0, 1.0.0, and 1.0.0.0.

Processor

Optional. The machine architecture on which this deployment can run. The default is msil, or Microsoft Intermediate Language, the default format of all managed assemblies. Change this field if you have compiled the assemblies in your application for a specific architecture.

Culture

Optional. The two-part ISO country/region code in which this application runs. The default is neutral.

Public key token

Optional. The public key with which this deployment manifest has been signed. If this is a new or unsigned manifest, this field will appear as Unsigned.

Description Tab

UI Element

Description

Publisher

Required. The name of the person or organization responsible for the application. This value is used as the Start menu folder name.

Product

Required. The full product name. If you selected Install Locally for the Application Type element on the Deployment Options tab, this name will be what appears in the Start menu link and in Add or Remove Programs for this application.

Support Location

Optional. The URL from which customers can obtain help and support for the application.

Deployment Options Tab

UI Element

Description

Application Type

Optional. Specifies whether this application installs itself to the client computer (Install Locally), runs online (Online Only), or is a WPF application that runs in the browser (WPF Browser Application). The default is Install Locally.

Start Location

Optional. The URL from which the application should actually be started. Useful when deploying an application from a CD that should update itself from the Web.

Include Start Location (ProviderURL) in the manifest

Optional. Specifies the URL which ClickOnce will examine for application updates.

Automatically run application after installing

Required. Specifies that the ClickOnce application should run immediately after the initial installation from a URL. The default is the check box is selected.

Allow URL parameters to be passed to application

Required. Permits the transfer of parameter data to the ClickOnce application through a query string appended to the deployment manifest's URL. The default is the check box is cleared.

Use .deploy file extension

Required. When selected, all files in the application manifest must have the .deploy extension. The default is the check box is cleared.

Update Options Tab

The Update Options tab only contains options mentioned here when the Application Type selection box on the Name tab is set to Install Locally.

UI Element

Description

This application should check for updates

Specifies whether ClickOnce should check for application updates. If this check box is not selected, the application will not check for updates unless you update it programmatically by using the APIs in the System.Deployment.Application namespace.

Choose when the application should check for updates

Provides two options for update checks:

  • Before the application starts. The update check is performed prior to application execution.

  • After the application starts. The update check begins once the main form of the application has initialized, and will run the next time the application starts.

Update check frequency

Determines how often ClickOnce should check for updates:

  • Check every time the application runs. ClickOnce will perform an update check every time the user opens the application.

  • Check every: Select a time interval and a unit (hours, days, or weeks) that must elapse before checking for updates.

Specify a minimum required version for this application

Optional. Specifies that a specific version of your application is a required installation, preventing your users from working with an earlier version.

Version

Required if Specify a minimum required version for this application check box is selected. The version number supplied must be of the form N.N.N.N. Only the first major build number is required. For example, for version 1.0 of an application, valid values would include 1, 1.0, 1.0.0, and 1.0.0.0.

Application Reference Tab

The Application Reference tab contains the same fields as the Name tab described earlier in this topic. The one exception is the following field.

UI Element

Description

Select Manifest

Allows you to choose the application manifest. All of the other fields on this page will populate when you choose an application manifest.

See Also

Reference

MageUI.exe (Manifest Generation and Editing Tool, Graphical Client)

MageUI.exe Application Manifest Tab

ClickOnce Deployment Manifest

Concepts

ClickOnce Security and Deployment