Deployment Manifests for Office Solutions (2003 System)
The information in this topic applies only to the specified Visual Studio Tools for Office projects and versions of Microsoft Office.
For more information, see Features Available by Application and Project Type.
Microsoft Office version
A deployment manifest is an XML file that describes the deployment settings of a Visual Studio Tools for Office solution and identifies the current application version to deploy.
Visual Studio Tools for Office uses a subset of the deployment manifest schema defined for ClickOnce. Only the elements and attributes listed in this table are supported for Visual Studio Tools for Office solutions. Any elements and attributes that are part of the ClickOnce schema but are not listed here are ignored, with no error raised.
Visual Studio Tools for Office deployment manifests have the following elements and attributes.
Required. Top-level element.
Required. Identifies the application manifest for the solution.
Required. Provides application information used to create a shell presence and the Add or Remove Programs item in Control Panel.
Required. Identifies the version of the solution to install for the deployment and the location of the application manifest.
Optional. Identifies the attributes used for the deployment of updates and exposure to the system.
The deployment manifest file identifies the current version of a solution. It references the application manifest, which describes the solution and all of the files contained within the current version. When you make a new version of a solution available, you must update the deployment manifest to refer to the new application manifest. When the solution runs, the runtime detects that the deployment manifest has a new version. The new application manifest specified in the deployment manifest is downloaded to replace the older one.
The MSBuild task GenerateDeployManifest generates the deployment manifest in the output folder. This task is invoked by the Publish Wizard, and also when you build a Visual Studio Tools for Office project from the command line and specify a Publish target. For more information, see GenerateDeploymentManifest Task.
Application and deployment manifests in Visual Studio Tools for Office solutions are not signed, as ClickOnce manifests are. The manifests cannot be validated before they are used.
Some of the fields in application and deployment manifests that are generated by the publish tools are not used in Visual Studio Tools for Office solutions, including some fields that identify properties of the assembly such as size and version.
The following code example illustrates a deployment manifest for a Visual Studio Tools for Office solution.
<?xml version="1.0" encoding="utf-8"?> <asmv1:assembly xsi:schemaLocation= "urn:schemas-microsoft-com:asm.v1 assembly.adaptive.xsd" manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v2" xmlns:asmv1="urn:schemas-microsoft-com:asm.v1" xmlns:asmv2="urn:schemas-microsoft-com:asm.v2" xmlns:xrml="http://www.xrml.org/schema/2001/11/xrml2core" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <assemblyIdentity name="ExcelApplication1.application" version="220.127.116.11" publicKeyToken="0000000000000000" language="neutral" processorArchitecture="msil" xmlns="urn:schemas-microsoft-com:asm.v1" /> <description asmv2:publisher="MS .NET" asmv2:product="ExcelApplication1" xmlns="urn:schemas-microsoft-com:asm.v1">Deployment manifest description here.</description> <deployment install="false" /> <dependency> <dependentAssembly codebase="ExcelApplication1_18.104.22.168\ ExcelApplication1.manifest" size="2518" hash="0DE6E54FDCF3334A23D627402EF65668CBFB8587" hashalg="SHA1"> <assemblyIdentity name="ExcelApplication1.manifest" version="22.214.171.124" /> <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> qws6Ku5WQeMv12bE1W5deGkSHcY= </dsig:DigestValue> </hash> </dependentAssembly> </dependency> </asmv1:assembly>