Implementar soluciones de Office

Artículo
08/10/2011

Puede implementar soluciones de Office mediante las tecnologías de implementación ClickOnce o Windows Installer (MSI). Las soluciones de Office usan la tecnología ClickOnce implementada en Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office y .NET Framework 3.5. Esto difiere ligeramente de la funcionalidad disponible en las aplicaciones de Windows Forms, que solo utiliza la funcionalidad de .NET Framework. ClickOnce está diseñado para simplificar la implementación y el mantenimiento de las soluciones porque las soluciones ClickOnce se instalan con privilegios de usuario.

Se aplica a: la información de este tema se aplica a los proyectos de nivel de documento y los proyectos de nivel de aplicación para Microsoft Office 2010 y 2007 Microsoft Office System. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.

Si utiliza Windows Installer para distribuir los archivos, también deberá cumplir los requisitos de seguridad del Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office y de ClickOnce para que los usuarios puedan ejecutar sus soluciones de Microsoft Office. Para obtener más información acerca del modelo de seguridad para las soluciones de Office, vea Asegurar las soluciones de Office.

La ventaja principal de usar Windows Installer es implementar las soluciones de Office para todos los usuarios, en lugar de solo para el usuario actual. Para obtener más información sobre la implementación de las soluciones de Office con Windows Installer, vea Implementar una solución de Office mediante Windows Installer.

Para obtener información general acerca de ClickOnce, vea Seguridad e implementación ClickOnce.

El proceso de implementación implica las consideraciones siguientes:

Requisitos de las soluciones de Office.
Implementar una solución de Office.
Instalar una solución de Office.
Actualizar una solución de Office.
Implementación durante el desarrollo.
Caché de ClickOnce.

Requisitos de las soluciones de Office

Para que puedan ejecutarse las soluciones de Microsoft Office, se deben instalar algunos componentes en el equipo, como .NET Framework 3.5 y el Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office. A menudo puede implementar estos componentes junto con la solución. Para obtener una lista de componentes necesarios, vea Requisitos previos de las soluciones de Office para su implementación y Cómo: Instalar los requisitos previos en equipos de usuarios finales para ejecutar las soluciones de Office.

Además, debe tener en cuenta cómo confiar en las soluciones. Para obtener información acerca de la seguridad, vea Asegurar las soluciones de Office.

Implementar una solución de Office

Al implementar una solución de Office, puede utilizar el Asistente para publicación o la página de propiedades Publicar para configurar los siguientes valores de implementación:

Número de versión
Requisitos previos
Intervalos de actualización

Después de configurar estos valores de implementación, Visual Studio publica los archivos de la solución en la ubicación de publicación.

Si está implementando con un CD o una unidad extraíble, deje Ubicación de instalación en blanco y establezca Actualizaciones en Nunca. Para obtener más información, consulte Cómo: Implementar una solución de Office mediante ClickOnce y Publicar soluciones de Office.

Instalar una solución de Office

Una vez copiada la solución en la ubicación de instalación, los usuarios finales pueden descargarla e instalarla. Puede instalar las soluciones de varias maneras: ejecutando el programa de instalación, abriendo el manifiesto de implementación (archivo .vsto) o abriendo el documento. Para obtener más información, vea Cómo: Instalar una solución de Office ClickOnce y Cómo: Desinstalar una solución de Office ClickOnce.

Si los usuarios abren el manifiesto de implementación para instalar la solución, podría tener que configurar el servidor IIS para reconocer el tipo MIME de .vsto. Para obtener más información, vea Cómo: Preparar IIS para el desarrollo de soluciones de Office.

Implementación avanzada

Si desea crear un programa de instalación personalizada para la solución de Office, puede ejecutar directamente el instalador (VSTOInstaller.exe) de Office. Para obtener más información, vea Personalizar la instalación de soluciones de Office.

Asimismo, los proyectos de nivel de aplicación y de documento se pueden implementar en un solo paquete y las soluciones combinadas se pueden instalar y desinstalar como un grupo. Por ejemplo, si la compañía de software Contoso desarrolla un complemento de Outlook y una hoja de cálculo de Excel, se podrán instalarlos y desinstalarlos juntos como soluciones de Office de Contoso a través de la opción Agregar o quitar programas en Windows XP o Programas y características en Windows Vista. Para obtener más información, vea Tutorial: Implementar varias soluciones de Office en un instalador de ClickOnce único para .NET Framework 4.

Si necesita realizar acciones adicionales después de la instalación, puede personalizar la instalación mediante un proceso denominado acción posterior a la implementación. Por ejemplo, puede copiar documentos o libros en el equipo del usuario final, crear claves del Registro adicionales o modificar un archivo de configuración. Para obtener más información, vea Tutorial: Copiar un documento en el equipo del usuario final tras una instalación de ClickOnce.

Actualizar una solución de Office

Puede configurar una solución para buscar actualizaciones en los intervalos especificados e instalar las actualizaciones automáticamente. La configuración predeterminada para las actualizaciones automática es cada siete días. Una vez establecido este intervalo e instalada la solución, no se puede cambiar el intervalo sin instalar una actualización. Si los usuarios desean forzar una actualización fuera de los intervalos normales de actualización, se puede actualizar manualmente la solución de Office.

Puede implementar las actualizaciones mediante el Asistente para publicación. El Asistente para publicación genera un nuevo manifiesto de aplicación y copia los archivos de la solución en la misma ubicación de publicación que la versión anterior. Las actualizaciones son opcionales y los usuarios pueden cancelar cualquier actualización de la solución durante la descarga sin que se vea afectada la ejecución del complemento.

La acción de publicación también actualiza el manifiesto de implementación para señalar a la ubicación de la nueva versión de la solución. Cuando la solución instalada del usuario final busque actualizaciones en el intervalo especificado, descargará e instalará la versión que se haya implementado más recientemente. Puede actualizar las versiones de una solución si actualiza los archivos de manifiesto y de solución en la ubicación de implementación. Para obtener más información, consulte Cómo: Actualizar soluciones de Office implementadas.

Para revertir a una versión anterior de una solución de Office, vea Cómo: Revertir una solución de ClickOnce Office a una versión anterior.

En los casos en los que se haya cambiado la ubicación de la publicación, es posible cambiar la ruta de acceso en el programa de instalación sin necesidad de volver a Visual Studio para usar la página Asistente para publicación o Publicar del Diseñador de proyectos. Para obtener más información, consulte Cómo: Cambiar la ruta de instalación de una solución de Office.

Puede editar de forma manual los manifiestos de aplicación e implementación de las soluciones de Office. La herramienta de generación y edición de manifiestos (mage.exe) debe volver a firmar los manifiestos de aplicación e implementación una vez que se modifiquen los manifiestos. Para obtener más información, vea Cómo: Cambiar propiedades de implementación.

Implementación durante el desarrollo

Si para probar el complemento de nivel de aplicación, publica e instala la solución en el equipo de desarrollo, desinstale la solución antes de volver a publicar o realizar otros cambios en el código y vuelva a realizar la prueba presionando F5. Al instalar una solución publicada, el ensamblado del complemento se instala en la memoria caché de ClickOnce. El programa de instalación también crea claves del Registro para que la aplicación de Office pueda buscar y cargar el ensamblado. Dado que al volver a generar la solución se actualizan las claves del Registro, es necesario desinstalar la primera versión antes de publicar o ejecutar la segunda versión.

Para probar su implementación en el equipo de desarrollo, cree otra cuenta de usuario para instalar y probar con ella el complemento de nivel de aplicación.

Si desarrolla varias soluciones de Office, se ejecutarán todos los complementos de Office porque una compilación se considera una instalación. Se recomienda ejecutar el comando Limpiar solución del menú Generar antes de cerrar una solución.

Caché de ClickOnce

Las soluciones para Office de ClickOnce se instalan en la memoria caché de aplicaciones de ClickOnce o en la memoria caché global de ensamblados (GAC). La memoria caché de ClickOnce es una familia de directorios ocultos que contiene todos los archivos de la solución, incluidos los ensamblados, los archivos de configuración, la configuración de la aplicación y del usuario y los directorios de datos. Las soluciones para Office de ClickOnce utilizan la misma memoria caché que las aplicaciones de ClickOnce para Windows Forms. Mientras se trabaja desde la memoria caché de ClickOnce, se pueden abrir vínculos a otras ubicaciones de Internet o de red, y la solución almacenada en caché también puede funcionar en modo sin conexión. Para las personalizaciones en el nivel del documento, el documento no se instala en la memoria caché de ClickOnce y puede ubicarse en el equipo de un usuario o en un recurso compartido de archivos de red. Para obtener más información acerca de la memoria caché de ClickOnce, vea Información general sobre la memoria caché de ClickOnce.

También puede almacenar los ensamblados en la GAC. Si las soluciones de Office tienen una acción posterior a la implementación que debe realizarse después de cada instalación, puede almacenar dicha acción en la GAC. Por ejemplo, las acciones posteriores a la implementación que deben ejecutarse después de la instalación de cada plantilla de Visio pueden almacenarse en la GAC.

Migración de datos al actualizar soluciones

Las soluciones de Office migran los datos almacenados en la memoria caché de una versión a la siguiente durante una actualización.

Si está ejecutando una instancia de una versión anterior de una solución durante una actualización, no se migrarán los cambios que haga en los datos almacenados en la memoria caché de la instancia que se ejecuta durante la actualización. Para asegurarse de que los datos se migran correctamente, cierre todas las instancias de una solución antes de actualizarla.

Archivo de datos

Los archivos con las extensiones .xml, .mdb y .mdf se copian automáticamente en el directorio de datos de la aplicación. Estos archivos de datos no se pueden configurar mediante el cuadro de diálogo Archivos de aplicación. Para buscar el directorio de datos, utilice la propiedad DataDirectory. Para obtener más información, vea Obtener acceso local o remoto a los datos en aplicaciones ClickOnce.

Para buscar los archivos en otro directorio mediante la reflexión, llame al método GetExecutingAssembly y, a continuación, utilice las propiedades CodeBase o EscapedCodeBase para obtener la ruta de acceso al directorio. A continuación, podrá utilizar la ruta de acceso completa para buscar los archivos.