An application manifest is an XML file that describes an application that is deployed using ClickOnce.
Application manifests have the following elements and attributes.
|
Element |
Description |
Attributes |
|---|---|---|
|
Required. Top-level element. |
manifestVersion |
|
|
Required. Identifies the primary assembly of the ClickOnce application. |
name version publicKeyToken processorArchitecture language |
|
|
Identifies the application security requirements. |
None |
|
|
Required. Identifies the application code entry point. |
name |
|
|
Required. Identifies each dependency required for the application to run. Optionally identifies assemblies that need to be preinstalled. |
None |
|
|
Optional. Identifies each nonassembly file that is used by the application. Can include Component Object Model (COM) isolation data associated with the file. |
name size group optional writeableType |
|
|
Optional. Identifies a file extension to be associated with the application. |
extension description progid defaultIcon |
The application manifest file identifies an application deployed using ClickOnce. For more information about ClickOnce, see ClickOnce Security and Deployment.
An application manifest is specific to a single version of a deployment. For this reason, application manifests should be stored separately from deployment manifests. The common convention is to place them in a subdirectory named after the associated version.
The application manifest always must be signed prior to deployment. If you change an application manifest manually, you must use mage.exe to re-sign the application manifest, update the deployment manifest, and then re-sign the deployment manifest. For more information, see Walkthrough: Manually Deploying a ClickOnce Application.
The name of an application manifest file should be the full name and extension of the application as identified in the assemblyIdentity element, followed by the extension .manifest. For example, an application manifest that refers to the Example.exe application would use the following file name syntax.
example.exe.manifest
The following code example shows an application manifest for a ClickOnce application.
<?xml version="1.0" encoding="utf-8"?> <asmv1:assembly xsi:schemaLocation="urn:schemas-microsoft-com:asm.v1 assembly.adaptive.xsd" manifestVersion="1.0" xmlns:asmv3="urn:schemas-microsoft-com:asm.v3" xmlns:dsig="http://www.w3.org/2000/09/xmldsig#" xmlns:co.v2="urn:schemas-microsoft-com:clickonce.v2" xmlns="urn:schemas-microsoft-com:asm.v2" xmlns:asmv1="urn:schemas-microsoft-com:asm.v1" xmlns:asmv2="urn:schemas-microsoft-com:asm.v2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:co.v1="urn:schemas-microsoft-com:clickonce.v1"> <asmv1:assemblyIdentity Application Deployment.exe" version="1.0.0.0" publicKeyToken="43cb1e8e7a352766" language="neutral" processorArchitecture="x86" type="win32" /> <application /> <entryPoint> <assemblyIdentity version="1.0.0.0" language="neutral" processorArchitecture="x86" /> <commandLine file="MyApplication.exe" parameters="" /> </entryPoint> <trustInfo> <security> <applicationRequestMinimum> <PermissionSet Unrestricted="true" SameSite="site" /> <defaultAssemblyRequest permissionSetReference="Custom" /> </applicationRequestMinimum> <requestedPrivileges xmlns="urn:schemas-microsoft-com:asm.v3"> <!-- UAC Manifest Options If you want to change the Windows User Account Control level replace the requestedExecutionLevel node with one of the following. <requestedExecutionLevel level="asInvoker" uiAccess="false" /> <requestedExecutionLevel level="requireAdministrator" uiAccess="false" /> <requestedExecutionLevel level="highestAvailable" uiAccess="false" /> If you want to utilize File and Registry Virtualization for backward compatibility then delete the requestedExecutionLevel node. --> <requestedExecutionLevel level="asInvoker" uiAccess="false" /> </requestedPrivileges> </security> </trustInfo> <dependency> <dependentOS> <osVersionInfo> <os majorVersion="4" minorVersion="10" buildNumber="0" servicePackMajor="0" /> </osVersionInfo> </dependentOS> </dependency> <dependency> <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true"> <assemblyIdentity version="4.0.20506.0" /> </dependentAssembly> </dependency> <dependency> <dependentAssembly dependencyType="install" allowDelayedBinding="true" codebase="MyApplication.exe" size="4096"> <assemblyIdentity version="1.0.0.0" language="neutral" processorArchitecture="x86" /> <hash> <dsig:Transforms> <dsig:Transform Algorithm="urn:schemas-microsoft-com:HashTransforms.Identity" /> </dsig:Transforms> <dsig:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" /> <dsig:DigestValue>DpTW7RzS9IeT/RBSLj54vfTEzNg=</dsig:DigestValue> </hash> </dependentAssembly> </dependency> <publisherIdentity issuerKeyHash="18312a18a21b215ecf4cdb20f5a0e0b0dd263c08" /><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> … </Signature></r:issuer></r:license></msrel:RelData></KeyInfo></Signature></asmv1:assembly>