Manifiestos de aplicación para soluciones de Office
Un manifiesto de aplicación es un archivo XML que describe los ensamblados que se cargan en una solución de Microsoft Office. Las herramientas de desarrollo de Microsoft Office en Visual Studio usan el esquema de manifiesto de aplicación ClickOnce definido en la referencia del manifiesto de aplicación ClickOnce.
Los manifiestos de aplicación para las soluciones de Office usan los siguientes atributos y elementos ClickOnce.
| Elemento | Descripción | Atributos |
|---|---|---|
| <Elemento assembly> (aplicación ClickOnce) | Necesario. Elemento de nivel superior. | manifestVersion |
| <Elemento assemblyIdentity> (aplicación ClickOnce) | Necesario. Identifica el ensamblado principal de la aplicación ClickOnce. | name version publicKeyToken processorArchitecture lenguaje |
| <Elemento trustInfo> (aplicación ClickOnce) | Identifica los requisitos de seguridad de la aplicación. | None |
| <Elemento entryPoint> (aplicación ClickOnce) | Necesario. Identifica el punto de entrada del código de aplicación para la ejecución. | name dependencyName customHostSpecified |
| <Elemento dependency> (Aplicación ClickOnce) | Necesario. Identifica cada dependencia necesaria para que se ejecute la aplicación. Identifica opcionalmente los ensamblados que se tienen que preinstalar. | None |
| <Elemento file> (aplicación ClickOnce) | Necesario. Identifica cada archivo que no es de ensamblado y que se usa por la aplicación. Puede incluir datos de aislamiento del modelo de objetos componentes (COM) asociados al archivo. | name size |
Los manifiestos de aplicación para soluciones de Office tienen el siguiente elemento en el espacio de nombres co.v1 .
<entryPoint>
<co.v1:customHostSpecified />
</entryPoint>
Estos manifiestos de aplicación también tienen los siguientes elementos y atributos en el espacio de nombres vstav3 .
<addIn>
<entryPointsCollection>
<entryPoints>
<entryPoint>
</entryPoint>
</entryPoints>
</entryPointsCollection>
<update></update>
<postActions>
<postAction>
<postActionData>
</postActionData>
<postAction>
</postActions>
<application>
<customizations>
<customization>
</customization>
</customizations>
</application
</addIn>
| Elemento | Descripción | Atributos |
|---|---|---|
| <Elemento customHostSpecified> (Desarrollo de Office en Visual Studio) | Necesario. Marca el manifiesto de manera específica como solución de Office. | None |
| <Elemento addin> (Desarrollo de Office en Visual Studio) | Necesario. Almacena los puntos de entrada en un espacio de nombres único. | None |
| <Elemento entryPointsCollection> (Desarrollo de Office en Visual Studio) | Necesario. Agrupa todos los ensamblados para una o más soluciones de Office. | id |
| <Elemento entryPoints> (Desarrollo de Office en Visual Studio) | Necesario. Agrupa todos los ensamblados para ejecutar una solución de Office. | None |
| <Elemento entryPoint> (Desarrollo de Office en Visual Studio) | Necesario. Identifica el ensamblado para ejecutarlo en una solución de Office. | class Contrato |
| <Elemento update> (Desarrollo de Office en Visual Studio) | Necesario. Configura las actualizaciones para la solución. | enabled expiration |
| <Elemento postActions> (Desarrollo de Office en Visual Studio) | Opcional. Agrupa todas las acciones posteriores a la implementación, que se ejecutan tras la instalación de las soluciones de Office. | None |
| <Elemento postAction> (Desarrollo de Office en Visual Studio) | Opcional. Identifica una acción posteriores a la implementación. | None |
| <Elemento postActionData> (Desarrollo de Office en Visual Studio) | Opcional. Configura los datos para una acción posterior a la implementación. | None |
| <Elemento application> (Desarrollo de Office en Visual Studio) | Necesario. Ajusta la información específica de la aplicación en un solo nodo. | None |
| <Elemento customizations> (Desarrollo de Office en Visual Studio) | Necesario. Almacena toda la información específica de host de aplicación en un espacio de nombres independiente. | None |
| <Elemento customization> (Desarrollo de Office en Visual Studio) | Necesario. Almacena la información específica de host de aplicación en un espacio de nombres independiente. | xmlns |
| <Elemento document> (Desarrollo de Office en Visual Studio) | Solo necesario para soluciones de nivel de documento. Almacena información específica de la personalización. | solutionId |
| <Elemento appAddin> (Desarrollo de Office en Visual Studio) | Solo necesario para soluciones de nivel de aplicación. Almacena información específica de la personalización. | application loadBehavior keyName |
| <Elemento friendlyName> (Desarrollo de Office en Visual Studio) | Opcional. Almacena el nombre del complemento de VSTO que aparece en la lista de complementos instalados de VSTO. | None |
| <elemento description> (Desarrollo de Office en Visual Studio) | Solo es necesario para complementos de VSTO. Almacena la descripción que aparece en la lista de programas instalados. | None |
| <Elemento formRegions> (Desarrollo de Office en Visual Studio) | Solo es obligatorio para los complementos de VSTO de Outlook que incluyan áreas del formulario. | None |
| <Elemento formRegion> (Desarrollo de Office en Visual Studio) | Solo es obligatorio para los complementos de VSTO de Outlook que incluyan áreas del formulario. | Nombre |
| <Elemento vstoRuntime> (Desarrollo de Office en Visual Studio) | Necesario. Describe una versión específica del tiempo de ejecución de Visual Studio Tools para Office admitida con la solución de Office. | release version supportUrl |
Comentarios
Puede editar manualmente manifiestos de implementación y aplicación en soluciones de Office. Después, debe volver a firmar la aplicación y los manifiestos de implementación mediante el Herramienta de generación y edición de manifiestos (mage.exe y mageui.exe). Para obtener más información, vea Procedimientos para volver a firmar manifiestos de aplicación e implementación.
Ubicación de los archivos
Un manifiesto de aplicación es específico de una versión única de una solución. Por este motivo, los manifiestos de aplicación deben almacenarse por separado de los manifiestos de implementación. Visual Studio coloca los archivos específicos de la versión en un subdirectorio denominado después de la versión asociada en el subdirectorio Archivos de aplicación de la carpeta publish.
Sintaxis de los nombres de archivo
El nombre de un archivo de manifiesto de aplicación debe ser el nombre completo y la extensión de la aplicación como se identifica en el elemento assemblyIdentity, seguido del .manifest de extensión. Por ejemplo, un manifiesto de aplicación que hace referencia a la personalización de OutlookAddIn1.dll usaría la siguiente sintaxis de nombre de archivo.
OutlookAddIn1.dll.manifest