Implementar complementos de nivel de aplicación (2003 System)

  • Artículo

Actualización: noviembre 2007

Se aplica a

La información de este tema sólo se aplica a los proyectos y versiones especificados de Visual Studio Tools para Office de Microsoft Office.

Tipo de proyecto

  • Proyectos de nivel de aplicación

Versión de Microsoft Office

  • Microsoft Office 2003

Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto.

La implementación de un complemento de Microsoft Office 2003 creado con Visual Studio Tools para Office generalmente implica trabajar con los archivos siguientes:

  • El ensamblado de complemento primario y todos los ensamblados dependientes, como recursos, satélites o bibliotecas auxiliares.

  • El manifiesto de aplicación.

  • El manifiesto de implementación (cuando corresponde).

Cuando implemente la solución, tenga en cuenta las siguientes instrucciones básicas:

Para implementar el complemento, realice estos pasos:

  • Copie el manifiesto de aplicación que genera el proceso de compilación y las entradas necesarias del Registro en cada equipo cliente.

  • Copie los ensamblados del complemento (y opcionalmente el manifiesto de implementación) a la ubicación de implementación.

La ubicación de implementación puede ser una carpeta local en el equipo cliente o una ubicación remota, como por ejemplo, un recurso compartido de red. Para obtener más información, vea Modelos de implementación (2003 System) y Cómo: Implementar soluciones de Office (2003 System).

Nota:

No hay ninguna opción de implementación que permita a los usuarios finales utilizar el cuadro de diálogo Complementos COM en aplicaciones de Microsoft Office 2003 para instalar un complemento creado con Visual Studio Tools para Office.

Utilizar el proyecto de instalación

Cuando se crea un proyecto de complemento mediante Visual Studio Tools para Office, se agrega automáticamente a la solución un proyecto de instalación. Si desea implementar directamente la solución en el equipo cliente, puede utilizar este proyecto de instalación para generar un archivo de Windows Installer (.msi). El instalador copia los archivos de solución al equipo cliente y crea las entradas del Registro necesarias para ejecutar el complemento. Para obtener más información sobre el proyecto de instalación, vea Proyectos de instalación para complementos de nivel de aplicación (2003 System). Para obtener más información sobre las entradas del Registro necesarias, vea Entradas del Registro de complementos de nivel de aplicación.

Limitaciones del proyecto de instalación

El proyecto de instalación predeterminado tiene varias limitaciones:

  • De forma predeterminada, el proyecto de instalación no establece la directiva de seguridad. El ensamblado del complemento y cualquier ensamblado al que se haga referencia deben disponer de plena confianza para que se ejecute el complemento. Se puede agregar un paso al proyecto de instalación con el fin de configurar una directiva de seguridad o bien un administrador puede establecer la directiva de seguridad correspondiente. Para obtener más información, vea Requisitos de seguridad para ejecutar las soluciones de Office (2003 System).

  • De forma predeterminada, el proyecto de instalación no comprueba, ni instala, el motor en tiempo de ejecución de Visual Studio Tools para Office ni el ensamblado de interoperabilidad primario (PIA) para la aplicación de Microsoft Office. Si estos componentes no están instalados en el equipo del usuario final, el complemento no se ejecutará. Para obtener más información sobre los requisitos previos, vea Cómo: Preparar equipos de usuarios finales para ejecutar soluciones de Office (2003 System).

Utilizar el asistente para publicación

Si desea habilitar las actualizaciones de ensamblado automáticas, puede utilizar el Asistente para publicación. El Asistente para publicación crea un manifiesto de implementación para la solución y copia todos los archivos necesarios en la ubicación de implementación.

El comando Publicar del menú de acceso directo del proyecto del Explorador de soluciones inicia el Asistente para publicación. Se identifica la ubicación de la carpeta en la cual desea publicar la solución y el asistente copia el manifiesto de implementación en dicha carpeta. El asistente también copia los ensamblados y un manifiesto de aplicación actualizado en una subcarpeta de la carpeta de implementación principal. El nombre de la subcarpeta contiene un número de versión. Si la opción Incrementar revisión automáticamente con cada lanzamiento está activada en el panel Publicar del Diseñador de proyectos, se creará una nueva subcarpeta cada vez que publique la solución. Las versiones anteriores siguen estando disponibles. Los manifiestos de aplicación e implementación garantizan que la solución siempre utiliza el ensamblado correcto. Para obtener más información, vea Manifiestos de implementación y aplicación en soluciones de Office, Cómo: Implementar archivos de soluciones mediante el Asistente para publicación (2003 System) e Página Publicar, Diseñador de proyectos (2007 System).

Limitaciones del Asistente para publicación

El Asistente para publicación tiene varias limitaciones:

  • El Asistente para publicación no crea las entradas del Registro necesarias para ejecutar el complemento. Si utiliza el Asistente para publicación para implementar un complemento, debe crear manualmente esas entradas del Registro, por ejemplo mediante un archivo de Registro (.reg). El Asistente para publicación tampoco sobrescribe ni elimina las entradas del Registro que se crean en el equipo de desarrollo cuando se genera un proyecto. Para obtener más información sobre la generación de proyectos, vea Información general acerca del proceso de compilación de soluciones de Office. Para obtener más información sobre las entradas del Registro necesarias, vea Entradas del Registro de complementos de nivel de aplicación.

  • El Asistente para publicación no concede plena confianza al ensamblado en la directiva de seguridad del usuario final. El ensamblado del complemento y cualquier ensamblado al que se haga referencia deben disponer de plena confianza para que se ejecute el complemento. Para obtener más información, vea Requisitos de seguridad para ejecutar las soluciones de Office (2003 System).

Actualizar ensamblados implementados (control de versiones)

Si implementa una solución denominada OutlookAddin1 en la carpeta C:\DeployFolder, la estructura de archivos tendrá la apariencia siguiente:

C:\DeployFolder

Esta carpeta contiene el archivo y la subcarpeta siguientes:

  • El manifiesto de implementación (OutlookAddin1.application).

    C:\DeployFolder\OutlookAddin1_1.0.0.0

    Esta carpeta contiene los siguientes archivos:

    • Los ensamblados.

    • El manifiesto de aplicación (OutlookAddin1.dll.manifest).

    • Una copia del manifiesto de implementación.

Si actualiza el ensamblado y vuelve a publicar la solución, la estructura de directorios tendrá la apariencia siguiente:

C:\DeployFolder

Esta carpeta contiene el archivo y las subcarpetas siguientes:

  • El manifiesto de implementación (se actualiza para indicar el manifiesto de aplicación en C:\DeployFolder\OutlookAddin1_1.0.0.1).

    C:\DeployFolder\OutlookAddin1_1.0.0.0

    Esta carpeta contiene los siguientes archivos:

    • Los ensamblados originales.

    • El manifiesto de aplicación original.

    • El manifiesto de implementación original.

    C:\DeployFolder\OutlookAddin1_1.0.0.1

    Esta carpeta contiene los siguientes archivos:

    • Los ensamblados actualizados.

    • El manifiesto de aplicación actualizado.

    • Una copia del manifiesto de implementación actualizado.

Esta estructura se repetirá cada vez que actualice el ensamblado del complemento.

Usar MSBuild desde la línea de comandos

Puede utilizar MSBuild en el símbolo de sistema para publicar su solución. Cuando utiliza MSBuild en el símbolo del sistema, puede publicar sus archivos de solución en una ubicación y modificar simultáneamente el manifiesto de aplicación y el manifiesto de aplicación actualizado para que señale a una ubicación diferente. Si desea ejecutar MSBuild en el símbolo del sistema para publicar su solución, utilice la sintaxis siguiente.

msbuild.exe /target:Publish /property:UpdateUrl=<update location> /property:PublishDir=<publish location> <project file>

Por ejemplo, si desea publicar un proyecto de C# denominado OutlookAddin1 en la carpeta compartida \\PublishServer\PublishFolder, pero en el futuro espera mover el manifiesto de implementación, el manifiesto de aplicación actualizado y el ensamblado de complemento a la carpeta compartida \\DeploymentServer\DeploymentFolder, debe ejecutar el siguiente comando.

msbuild.exe /target:Publish /property:PublishDir=\\PublishServer\PublishFolder\ /property:UpdateUrl=\\DeploymentServer\DeploymentFolder\ C:\OutlookAddin1\OutlookAddin1.csproj

Para obtener más información sobre el uso de MSBuild en el símbolo del sistema, vea Generar aplicaciones ClickOnce desde la línea de comandos.

Implementar complementos en Windows Vista

Si los usuarios finales ejecutan la solución en Windows Vista, debe tener en cuenta las restricciones de seguridad de Windows Vista al instalar la implementación, o los usuarios no podrán instalar las actualizaciones.

Si utiliza el Asistente para publicación para publicar las actualizaciones del complemento en una ubicación HTTP o de red, los equipos de los usuarios finales que ejecuten Windows Vista sólo podrán cargar las actualizaciones de ensamblado bajo las condiciones siguientes:

  • El manifiesto de aplicación se instala en una carpeta del equipo del usuario final que pueda modificar una aplicación con permisos estándar.

    O bien,

  • El usuario ejecuta la aplicación de Microsoft Office con permisos de administrador.

Al publicar una actualización a un complemento, el motor en tiempo de ejecución de Visual Studio Tools para Office intenta copiar el manifiesto de aplicación actualizado en el equipo del usuario final la próxima vez que el usuario abre la aplicación. El motor en tiempo de ejecución utiliza a continuación la información en el manifiesto actualizado para cargar el ensamblado actualizado. En Windows Vista, las aplicaciones que se ejecutan con permisos estándar no pueden sobrescribir los archivos de determinadas carpetas, incluyendo %ProgramFiles%. Por tanto, si el manifiesto de aplicación se instala en una carpeta que requiere permisos de administrador, la aplicación sólo puede cargar el ensamblado actualizado si el usuario ejecuta la aplicación como un administrador. Alternativamente, el usuario puede ejecutar la aplicación con permisos estándar si el manifiesto de aplicación se instala en una carpeta que no requiere permisos de administrador, como %UserProfile%.

Nota:

De forma predeterminada, el proyecto de instalación que se crea con proyectos de complemento instala el manifiesto de la aplicación en %CommonProgramFiles%.

Manifiestos de aplicación e implementación

Los manifiestos de aplicación e implementación permiten actualizar un complemento con el ensamblado más reciente. Para obtener más información, vea Manifiestos de implementación y aplicación en soluciones de Office.

Es posible cambiar el manifiesto de aplicación o implementación de una solución varias veces durante el período de duración de la solución. Existen dos razones principales para actualizar los manifiestos:

Vea también

Conceptos

Implementar soluciones de Office (2003 System)

Proyectos de instalación para complementos de nivel de aplicación (2003 System)

Proyectos de instalación e implementación

Referencia

Entradas del Registro de complementos de nivel de aplicación