MageUI.exe Application Manifest Tab

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

The Application Manifest tab displays the contents of an application manifest. The application manifest describes all files included with the deployment, and the permissions required for the application to run on the client.

The Application Manifest tab contains the following tabs.

UI Element

Description

Name

Specifies identifying information about this deployment.

Description

Specifies publisher, product, and support information.

Application Options

Specifies whether this is a browser application, and whether this manifest is the source of trust information.

Files

Specifies all of the files that constitute this deployment.

Permissions Required

Specifies the minimum permission set required by the application to run on a client.

Name Tab

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

UI Element

Description

Name

Required. The name of the application 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, which is the default format of all managed assemblies. Change this field if you have pre-compiled the assemblies in your application for a specific architecture. For more information about pre-compilation, see Ngen.exe (Native Image Generator).

Culture

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

Public key token

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

Description Tab

This information is usually provided within the deployment manifest. These fields can only be modified if the Use Application Manifest Trust Information check box is selected on the Application Options tab.

UI Element

Description

Publisher

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

Product

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

Support Location

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

Application Options Tab

UI Element

Description

Windows Presentation Foundation Browser Application

Specifies whether this is a WPF application that runs in the browser as a XAML browser application (XBAP).

Use Application Manifest Trust Information

Specifies whether this manifest contains trust information.

Files Tab

UI Element

Description

Application directory

The directory in which the application's files reside. Use the ellipses () button to select the directory.

Populate

Adds all of the files in the application directory and subdirectories to the application manifest. If MageUI.exe finds a single executable file in the directory, it automatically marks this as the Entry Point, which is the file first executed when the ClickOnce application is launched on the client.

Application Files

Lists all of the files in the application. Each file has three editable attributes, discussed below.

File Type

File Type can be one of four values:

  • None.

  • Entry Point. The application's primary executable. Only one executable file can be marked as the entry point.

  • Data File. A file, such as an XML file, that supplies data to the application.

  • Icon File. An application icon, such as appears on the desktop or in the corner of an application's window.

Optional

Files marked optional are not downloaded on initial install or update, but may be downloaded at run time using the System.Deployment On-Demand API. For more information, see Walkthrough: Downloading Assemblies on Demand with the ClickOnce Deployment API Using the Designer.

Group

A label for a set of optional files. You can apply a Group label to a set of files, and use the On-Demand API to download a batch of files with a single API call.

Permissions Required Tab

Use the Permissions Required tab if you need to grant your application more access to the local computer than is granted by default. For more information, see Securing ClickOnce Applications.

UI Element

Description

Permission set type

The minimum permission set required by this application to run on the client. For a description of these permission sets and which permissions they do or do not demand, see Named Permission Sets.

Details

The XML created for the application manifest to represent the permission set. Unless you have a good understanding of the application manifest XML format, you should not edit this XML manually. For more information, see ClickOnce Application Manifest.

See Also

Reference

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

MageUI.exe Deployment Manifest Tab

ClickOnce Application Manifest

Concepts

ClickOnce Security and Deployment