MageUI.exe Deployment Manifest Tab

  • Article

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

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

  • Name
    Displays identifying information about this deployment.
  • Description
    Displays publisher and support information.
  • Deployment Options
    Provides additional information about the deployment, such as where to obtain product support.
  • Update Options
    Determines the update location, and how often ClickOnce should check for application updates.
  • Application Reference
    Provides a pointer to the application manifest for this deployment.

Name Panel—UI Element List

  • 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. You would only change this field if you have pre-compiled the assemblies in your application for a specific architecture. For more information about pre-compilation, see Native Image Generator (Ngen.exe).
  • Culture
    Optional. The two-part ISO country/region code in which this application runs. Defaults to 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 Panel—UI Element List

  • Publisher
    Required. The name of the person or organization responsible for the application.
  • Product
    Required. The full product name. If you selected Install Locally for the Application Type element on the Name tab, this name will be what appears in the Start menu link and in the Add or Remove Programs dialog box for this application.
  • Support Location
    Optional. The URL from which customers can obtain Help and support for the application.

Deployment Options Panel—UI Element List

  • Application Type
    Optional. Determines whether this application installs itself to the client computer (Install Locally) or runs online (Online Only). Default is Install Locally.
  • Launch 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.
  • Automatically run application after installing
    Required. Tells ClickOnce to run the application immediately after the initial installation. Default is with the check box 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. Default is with the check box cleared.
  • Use .deploy file extension
    Required. Default is with the check box cleared.

Update Options Panel—UI Element List

This tab contains none of the options mentioned previously unless the Application Type selection box on the Name tab is set to Install Locally.

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

  • Choose when the update check should happen
    Provides two options for update checks:

    • In the background, after the app starts. The update check is delayed until the main form of the application has initialized.

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

    These options are only available if This application should check for updates check box is selected.

  • Update Check Frequency
    Determines how often ClickOnce should check for updates:

    • Every time the application starts. ClickOnce will perform an update check every time the user opens the application.

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

    These options are only available if the This application should check for updates check box is selected.

  • 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 Panel—UI Elements

This panel contains the same fields as the Name Panel described in the previous section. The one exception is the following field.

  • Select Manifest
    The application manifest to use to prepopulate all of the other fields on this page.

See Also

Reference

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