Implementar una solución de Office mediante Windows Installer

Artículo
03/22/2013

Obtenga información sobre cómo crear un archivo de Windows Installer (.msi) para la solución de Office 2013 o de Office 2010 mediante Visual Studio 2012.

Mediante Visual Studio 2012 para crear un archivo de Windows Installer, puede implementar una solución de Office 2013 o de Office 2010 que requiere acceso administrativo en el equipo del usuario final.Por ejemplo, puede utilizar un archivo para instalar usuarios de una solución sólo una vez por todas de un equipo.También puede implementar una solución de Office mediante ClickOnce, pero esa solución se debe instalar por separado para cada usuario del equipo.

Para mostrar una lista completa de diferencias entre Windows Installer y la implementación ClickOnce, vea Elegir una estrategia de implementación.

En este tema

Descargue los ejemplos
Obtener InstallShield Limited edition
Decida cómo conceder confianza a la solución
Cree un proyecto de instalación
Agregue el resultado del proyecto
Agregue la los manifiestos de implementación y aplicación
Configurar los módulos subordinados como requisitos previos
Especifique dónde instalar la solución en el equipo del usuario
Configure an add-in
Configure una personalización de nivel de documento
Compile el proyecto de instalación

Para obtener más información sobre cómo implementar una solución de Office mediante ClickOnce, vea Implementar una solución de Office mediante ClickOnce.

Para obtener información sobre cómo crear un archivo de Windows Installer mediante Visual Studio 2010, vea El implementar Visual Studio 2010 tools para la solución de Office Con Windows Installer.

Descargue los ejemplos

Este tema hace referencia a los ejemplos descargables siguientes.

Ejemplo	Descripción
ExcelAddIn	Un complemento de Excel que se puede instalar en un equipo que ejecuta un de 32 o una versión de 64 bits de Office.
ExcelWorkbook	Una personalización de nivel de documento de Excel que se puede instalar en un equipo que ejecuta un de 32 o una versión de 64 bits de Office.

Decida cómo conceder confianza a la solución

Antes de que una solución pueda ejecutarse en los equipos de los usuarios, debe conceder confianza en o de las siguientes formas, o los usuarios deben responder al mensaje relativo a la confianza cuando instala la solución.

Firme los manifiestos utilizando un certificado que identifica conocido y un editor de confianza.Para obtener más información, vea Confirmando la solución firmar la aplicación y los manifiestos de implementación.
Instala la solución en el directorio archivos de programa en el equipo del usuario.

[!NOTA]

Para las personalizaciones de nivel de documento, la ubicación del documento también debe ser de confianza.Para obtener más información, vea Otorgar confianza a los documentos.

Obtener InstallShield Limited edition

Puede crear un archivo de Windows Installer mediante InstallShield Limited edition (ISLE), que está disponible si ha instalado Visual Studio.ISLE reemplaza la funcionalidad de las plantillas de proyecto para la configuración y la implementación de las versiones anteriores de Visual Studio proporcionados.

Para obtener InstallShield Limited edition

En la barra de menú, elija Archivo, Nuevo, Proyecto.

Aparece el cuadro de diálogo Nuevo proyecto.
En el panel de plantillas, expanda Otros tipos de proyectos, y después elija la plantilla Instalación e implementación.
En la lista de tipos de proyecto para Instalación e implementación, elija habilitar installshield limited edition, y elija el botón Aceptar.

Aparece una página que proporciona información sobre cómo obtener InstallShield Limited edition.
En la página, elija el vínculo Vaya al sitio Web de descarga de.
En la página de descarga de InstallShield Limited edition, escriba la información necesaria en los campos correspondientes, y elija el vínculo Descarga ahora.

Después de descargar, instalar y, active el producto, la plantilla Proyecto de InstallShield Limited edition aparece en Visual Studio.

Cree un proyecto de instalación

En Visual Studio, abra el proyecto de Office que desea implementar.

Los ejemplos de complementos de nivel de aplicación asociados a este tema contiene un proyecto denominado ExcelAddIn.Los ejemplos de personalizaciones de nivel de documento contiene un proyecto denominado ExcelWorkbook.Este tema hará referencia al proyecto de Office en la solución mediante uno de los dos nombres.
En la barra de menús, elija Archivo, Agregar y Nuevo proyecto.

El cuadro de diálogo Agregar nuevo proyecto se abre.
En el panel de plantillas, expanda Otros tipos de proyectos, y después elija la plantilla Instalación e implementación.
En la lista de tipos de proyecto para Instalación e implementación, elija Proyecto de InstallShield Limited edition, asigne al proyecto, y elija el botón Aceptar.

El proyecto de instalación de InstallShield que acaba de crear aparece en la solución.

Los ejemplos de este tema contienen un proyecto de instalación que se denomine OfficeAddInSetup.Este tema hará referencia al proyecto de instalación de la solución con el mismo nombre.

Agregue el resultado del proyecto

Configure el proyecto OfficeAddInSetup de incluir el resultado del proyecto de Office.Para los proyectos de complemento de nivel de aplicación, el resultado del proyecto es el ensamblado de la solución solo.Para los proyectos de personalización de nivel de documento, el resultado del proyecto incluye no sólo el ensamblado pero también el documento propio de la solución.

Para agregar resultados del proyecto

En Explorador de soluciones, expanda el nodo del proyecto OfficeAddInSetup y, a continuación el archivo Asistente de proyectos, en la siguiente ilustración.
En la barra de menú, elija Vista, Abrir.
En la parte inferior de la página Asistente de proyectos, elija el botón Archivos de aplicación, en la siguiente ilustración.
En la página Archivos de aplicación, elija el botón Agregar resultados del proyecto.
En el cuadro de diálogo del Selector de salida de Visual Studio, active la casilla Salida principal, y después elija el botón Aceptar.

Agregue la los manifiestos de implementación y aplicación

En la página Archivos de aplicación, elija el botón Agregar archivos.
En el cuadro de diálogo Abrir, vaya al directorio de salida del proyecto ExcelAddIn.

Normalmente, el directorio de resultados es la subcarpeta bin \ release del directorio raíz del proyecto, dependiendo de la configuración de compilación que elija.
En el directorio de resultados, elija los archivos de ExcelAddIn.vsto y de ExcelAddIn.dll.manifest, y elija el botón Abrir.

La página Archivos de aplicación ahora contiene el archivo de salida del proyecto, el manifiesto de implementación, y el manifiesto de aplicación, como muestra la siguiente ilustración.

Configurar los módulos subordinados como requisitos previos

En la aplicación de instalación, debe incluir no solo los componentes siguientes pero también cualquier otro componente necesario para ejecutar la solución.

La versión de .NET Framework de destino de la solución de Office.
Las herramientas de Microsoft Visual Studio 2010 para el tiempo de ejecución de Office.

Agregue .NET Framework 4 o .NET Framework 4,5 como requisito previo

En Explorador de soluciones, expanda el nodo del proyecto OfficeAddInSetup, expanda el nodo Especifique los datos de la aplicación y, a continuación el archivo Redistributables, en la siguiente ilustración.
En la barra de menú, elija Vista, Abrir.

La página Redistributables se abre.
En la lista de componentes redistribuibles, seleccione adecuado la casilla para la versión de.NET Framework de destino de la solución.

Por ejemplo, si la solución tiene como destino .NET Framework 4.5, active la casilla .NET Framework 4,5 de Microsoft .NET completo.Un cuadro de diálogo puede parecer que preguntaba si desea instalar el componente redistribuible, que InstallShield requiere para poder agregar el componente como requisito previo.Si no aparece este cuadro de diálogo, el componente ya existe en el equipo.
Si aparece este cuadro de diálogo, elija el botón Sí para descargar el componente redistribuible.

[!NOTA]

Un mensaje de error podría especificar que se descarga.Puede omitir normalmente este error.Para comprobar si se descargara correctamente el archivo, vaya al directorio siguiente en el equipo:

Para sistemas operativos de 32 bits: %ProgramFiles%\InstallShield\2012SpringLE\SetupPrerequisites\Microsoft.red \Versión\FullOrClient\

Para sistemas operativos de 64 bits: %ProgramFiles (x86) %\InstallShield\2012SpringLE\SetupPrerequisites\Microsoft.red \Versión\FullOrClient\

Si el archivo no está en ninguno de los directorios, debe descargarlo y colocarlo en el directorio adecuado.

Para descargar .NET Framework 4, vea https://download.microsoft.com/download/9/5/A/95A9616B-7A37-4AF6-B C36 - D6EA96 C8 DAAE/dotNetFx40_Full_x86_x64.exe

Para descargar al cliente .NET Framework 4, vea https://download.microsoft.com/download/5/6/2/562A10F9- C9 F4-4313-A044-9 C94 E0A8FA C8 /dotNetFx40_Client_x86_x64.exe

Para descargar .NET Framework 4,5, vea https://download.microsoft.com/download/b/a/4/ba4a7e71-2906-4b2d-a0e1-80cf16844f5f/

[!NOTA]

Para adaptar la dirección URL de cualquier requisito previo que aparecen en la página Redistributables, abra el archivo adecuado de .prq en %ProgramFiles%\InstallShield\2012SpringLE\SetupPrerequisites \ directorio en el equipo.En cada archivo de .prq, la dirección URL aparece en el atributo de URL de elemento de <file>.

Agregue Visual Studio 2010 Tools para Office Runtime

La página Redistributables contiene un elemento denominado Tiempo de ejecución de Microsoft VSTO 2010, pero hace referencia a una versión anterior del runtime.Por consiguiente, debe crear manualmente un archivo de configuración que hace referencia a la versión más reciente.Deberá poner el archivo en el mismo directorio que los archivos de configuración para todos los otros elementos que aparecen en la página Redistributables.

Para agregar Visual Studio 2010 Tools para Office Runtime como requisito previo

Abra el Bloc de notas y, a continuación pegue el siguiente código XML en un archivo de texto.

<?xml version="1.0" encoding="UTF-8"?>
<SetupPrereq>
<conditions>
    <condition Type="32" Comparison="2" Path="HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4R" FileName="Version" ReturnValue="10.0.40303" Bits="2"></condition>
</conditions>
<files>
    <file LocalFile="&lt;ISProductFolder&gt;\SetupPrerequisites\VSTOR\vstor_redist.exe" URL="https://go.microsoft.com/fwlink/?LinkId=140384" CheckSum="b6639489e159b854b6dc43d5cb539043" FileSize="0,40023024"></file>
</files>
<execute file="vstor_redist.exe" returncodetoreboot="1641,3010" requiresmsiengine="1">
</execute>
<properties Id="Your GUID goes here" Description="This prerequisite installs the most recent version of the Microsoft Visual Studio 2010 Tools for Office Runtime." >
</properties>

</SetupPrereq>

Generar GUID mediante el programa Generador GUID en el equipo.

Para buscar el programa Generador GUID en el equipo, abra el menú y el tipo Generador GUIDInicio en el cuadro buscar.
En el programa Generador GUID, elija el botón de opción Formato de registro, elija el botón copiar, y elija el botón Salir.

En el Bloc de notas, reemplace el texto Your GUID goes here pegando GUID en su lugar.

El elemento de <properties> de archivo es similar al siguiente.

<properties Id="{87989B73-21DC-4403-8FD1-0C68A41A6D8C}" Description="This prerequisite installs the most recent version of the Microsoft Visual Studio 2010 Tools for Office Runtime." >
</properties>

En la barra de menús en Bloc de notas, elija Archivo, Guardar.
En el cuadro de diálogo guardar como, vaya a Escritorio la carpeta.
En la lista Guardar como tipo, elija Todos los archivos (*.*)(*.*).
En el cuadro Nombre del archivo, escriba en Visual Studio 2010 tools para Office Runtime.prq, y elija el botón Guardar.

[!NOTA]

Asegúrese de agregar .prq al final del nombre de archivo para identificar este archivo como necesario.
Cierre el Bloc de notas.
De la carpeta Escritorio, copie las herramientas de Visual Studio 2010 para el archivo de Office Runtime.prq a uno de los directorios siguientes en el equipo.

Para sistemas operativos de 32 bits: %ProgramFiles%\InstallShield\2012SpringLE\SetupPrerequisites \

Para sistemas operativos de 64 bits: %ProgramFiles (x86) %\InstallShield\2012SpringLE\SetupPrerequisites \
En la página Redistribuible de proyecto de InstallShield, elija el botón Actualizar para actualizar la lista de componentes redistribuibles, como muestra la siguiente ilustración.
En la lista de componentes redistribuibles, active la casilla Visual Studio 2010 Tools para Office Runtime.

Un cuadro de diálogo puede parecer que preguntaba si desea instalar el componente redistribuible.Si no aparece este cuadro de diálogo, puede pasar a la sección de Especifique dónde instalar la solución en el equipo del usuario de este tema.
Si aparece este cuadro de diálogo, elija el botón Sí para descargar el componente redistribuible.

[!NOTA]

Un mensaje de error podría especificar que se descarga.Puede omitir este error.Para comprobar si se descargara correctamente el archivo, vaya al directorio siguiente en el equipo:

Para sistemas operativos de 32 bits: %ProgramFiles%\installshield\2012springle\setupprerequisites\ \InstallShield\2012SpringLE\SetupPrerequisites\ VSTOR \

Para sistemas operativos de 64 bits: %ProgramFiles (x86) %\installshield\2012springle\setupprerequisites\ \InstallShield\2012SpringLE\SetupPrerequisites\ VSTOR \

Importante
InstallShield podría haber descargado una versión anterior del runtime.Para asegurarse de que tiene la versión más reciente, descargue la versión más reciente de Visual Studio 2010 Tools para Office Runtime de Centro de descarga de Microsoft, y la coloca en el directorio adecuado.

Especifique dónde instalar la solución en el equipo del usuario

En Explorador de soluciones, expanda el nodo OfficeAddInSetup, expanda el nodo Organice la configuración y, a continuación el archivo Información general.
En la barra de menú, elija Vista, Abrir.
En la lista de propiedades, elija el botón examinar junto a la propiedad INSTALLDIR.
En el cuadro de diálogo Establezca INSTALLDIR, elija una carpeta en el equipo del usuario donde desea instalar la solución.

[!NOTA]

También puede crear subdirectorios en el cuadro de diálogo Establezca INSTALLDIR abriendo el menú contextual para cualquier carpeta de la lista.

Configure un complemento de nivel de aplicación

Esta sección solo se aplica si you'redeploying un complemento de nivel de aplicación.Si está implementando una personalización de nivel de documento, puede pasar a ir a la sección de Configure una personalización de nivel de documento.

Debe crear claves del Registro para que la aplicación de Office detecte y cargue el complemento.La ubicación de la clave del Registro depende de la aplicación de Office.Para obtener más información, vea Entradas del Registro de complementos de nivel de aplicación.

Para configurar el registro

En Explorador de soluciones, expanda el nodo del proyecto OfficeAddInSetup, expanda el nodo Organice la configuración y, a continuación el archivo Información general.
En la barra de menú, elija Vista, Abrir.

Las propiedades del proyecto de instalación aparecen.
En la lista para la propiedad AllUSERS, especifique si desea que esta solución que se instalará para todos los usuarios del equipo o sólo para el usuario que instala la solución.

Para instalar la solución para todos los usuarios, elija ALLUSERS=1 (instalación de Por- equipo).
En Explorador de soluciones, elija el nodo Asistente de proyectos.

En la barra de menú, elija Vista, Abrir.
En la parte inferior de la página Asistente de proyectos, elija el botón Registro de la aplicación, en la siguiente ilustración.

La página Registro de la aplicación aparece.
En ¿Desea configurar los datos del Registro que la aplicación instalará?, elija el botón de radio en Sí.
En la lista Vista del registro del equipo de destino, elija HKEY_USER_SELECTABLE.

La carpeta HKEY_USER_SELECTABLE está instalada en el subárbol adecuada de registro basada en lo que eligió para la propiedad ALLUSERS anteriormente en este procedimiento.Si establece esta propiedad en ALLUSERS=1 (instalación de Por- equipo), la solución se instala en el subárbol del registro HKEY_LOCAL_MACHINE.
Abrir el menú contextual para la carpeta HKEY_USER_SELECTABLE, elija Nueva y, a continuación Clave.

Una carpeta que se denomina Nueva clave " aparecen en la carpeta HKEY_USER_SELECTABLE.
Cambie el nombre de la nueva carpeta Software.
Abrir el menú contextual para la carpeta Software, elija Nueva y, a continuación Clave.

Una carpeta que se denomina Nueva clave " aparecen en la carpeta Software.
Cambie el nombre de la nueva carpeta Microsoft, y continúe creando subcarpetas hasta que representan la jerarquía clave completa.

La jerarquía clave completa es HKEY_USER_SELECTABLE\Software\Microsoft\Office\Excel\Addins\SampleCompany.ExcelAddIn.

Si está creando un instalador para las versiones de 64 bits de Office, la jerarquía completa es HKEY_USER_SELECTABLE\Software\Wow6432Node\Microsoft\Office\Excel\Addins\SampleCompany.ExcelAddIn.

La siguiente ilustración muestra la jerarquía de claves cuando haya completado este procedimiento.

[!NOTA]

Como procedimiento recomendado, inicie el nombre del complemento con el nombre de la compañía.Esta convención aumenta la probabilidad de que la clave será única y reduce la posibilidad de conflicto con un complemento de otro proveedor.Agregar- INS que tiene el mismo nombre puede, por ejemplo, sobrescribe las teclas de cada uno del registro.Este enfoque no puede garantizar que la clave será única pero puede reducir conflictos potenciales de nombre.
Abrir el menú contextual para la clave SampleCompany.ExcelAddIn, elija Nueva y, a continuación Valor de cadena.

El nuevo valor de cadena aparece en la lista los datos de Registro del equipo de destino.El valor de cadena se resalta de modo que pueda cambiarle el nombre.
Cambie el valor a la descripción.
Repita este proceso para crear los siguientes valores.

Tipo de valor

Nombre

Valor de cadena

FriendlyName

Valor DWORD

LoadBehavior

Valor de cadena

Manifiesto
Abrir el menú contextual para el valor Descripción y, a continuación Modificar.

El cuadro de diálogo Datos de edición aparece.
En el cuadro de texto Datos del valor, escriba en el complemento de demostración de Excel, y elija el botón Aceptar.

Esta descripción se produce cuando el usuario abra la aplicación de Office, abra el cuadro de diálogo opciones y, a continuación, en el panel Complementos, elija el complemento.
Abrir el menú contextual para el valor FriendlyName y, a continuación Modificar.

El cuadro de diálogo Datos de edición aparece.
En el cuadro de texto Datos del valor, escriba en el complemento de demostración de Excel, y elija el botón Aceptar.

Esta cadena aparece en el cuadro de diálogo Complementos COM en la aplicación de Office.De forma predeterminada, el valor de la cadena es la identificación del complemento
Abrir el menú contextual para el valor LoadBehavior y, a continuación Modificar.

El cuadro de diálogo Datos de edición aparece.
En el cuadro de texto Datos del valor, escriba 3 y, a continuación elija el botón Aceptar.

Un valor de 3 carga el complemento cuando se inicia la aplicación.Para obtener más información sobre los valores de LoadBehavior, vea Entradas del Registro de complementos de nivel de aplicación.
Abrir el menú contextual para el valor Manifiesto y, a continuación Modificar.

El cuadro de diálogo Datos de edición aparece.
En el cuadro de texto Datos del valor, escriba en file:/// [INSTALLDIR] ExcelAddIn.vsto|vstolocal, y a continuación elija el botón Aceptar.

Visual Studio 2010 Tools para Office Runtime utiliza esta ruta para buscar el manifiesto de implementación.La parte de [INSTALLDIR] de esta ruta de acceso es una macro que asigna a INSTALLDIR la propiedad en la página de propiedades Información general del proyecto de instalación de InstallShield.Esta propiedad especifica la ubicación en el equipo de destino para instalar el complemento.El sufijo de |vstolocal garantiza que la solución cargada de la carpeta de instalación, no la memoria caché de ClickOnce.

La ilustración siguiente se muestra cómo aparecen los valores después de completar este procedimiento.

Tipo de valor	Nombre
Valor de cadena	FriendlyName
Valor DWORD	LoadBehavior
Valor de cadena	Manifiesto

Importante
Si crea un área de formulario personalizada en un complemento para Outlook, debe crear varias entradas del Registro para registrar la región con Outlook.Para obtener más información, vea Entradas del Registro para las áreas de formulario de Outlook.

Configure una personalización de nivel de documento

Esta sección solo se aplica si está implementando una personalización de nivel de documento.Si está implementando un complemento de nivel de aplicación, puede pasar inmediatamente a la sección de Compile el proyecto de instalación.

Las personalizaciones de Documento- nivel no utilizan las claves del Registro.En su lugar, las propiedades de documento personalizadas contienen la ubicación del manifiesto de implementación.

Para modificar las propiedades personalizadas, se crea un programa que quite la personalización de nivel de documento del documento, modificar las propiedades adecuadas y, a continuación reata personalización al documento.Después debe crear una acción personalizada que ejecute el programa, y agrega esa acción al proyecto de instalación.

Para crear un programa que modifica propiedades de documento

En la barra de menús, elija Archivo, Agregar y Nuevo proyecto.

Aparecerá el cuadro de diálogo Agregar nuevo proyecto.
En el panel plantillas, bajo el nodo del lenguaje que desea usar, elija la carpeta Windows.
En la lista de tipos de proyecto para Windows, elija la plantilla Aplicación de consola.
Asigne al proyecto SetExcelDocumentProperties, y elija el botón Aceptar.
En Explorador de soluciones, elija el botón mostrar todos los archivos, abra el menú contextual para el nodo del proyecto SetExcelDocumentProperties, y elija Agregar referencia.
En el cuadro de diálogo Administrador de referencias, elija la ficha Extensiones, y seleccione la casilla junto a los siguientes ensamblados, y después elija el botón Aceptar.
- Microsoft.VisualStudio.Tools.Applications.Runtime
- Microsoft.VisualStudio.Tools.Applications.ServerDocument
En Explorador de soluciones, elija el archivo Program.cs (para las aplicaciones de C#) o el archivo Module1.vb (para aplicaciones de Visual Basic).
En la barra de menú, elija Vista, Abrir.

Reemplace el contenido del archivo completo con el código siguiente.

Imports Microsoft.VisualStudio.Tools.Applications.Runtime
Imports Microsoft.VisualStudio.Tools.Applications

Module Module1

    Sub Main()

        Dim assemblyLocation As String = ""
        Dim solutionID As Guid
        Dim deploymentManifestLocation As Uri = Nothing
        Dim documentLocation As String = ""
        Dim nonpublicCachedDataMembers As String() = Nothing

        Dim CommandLineArgs As  _
            System.Collections.ObjectModel.ReadOnlyCollection(Of String) = _
            My.Application.CommandLineArgs

        For i As Integer = 0 To CommandLineArgs.Count - 1

            Console.WriteLine(CommandLineArgs(i))
            Dim oArugment As String() = CommandLineArgs(i).Split("=")

            Select Case oArugment(0)

                Case "/assemblyLocation"
                    assemblyLocation = oArugment(1)

                Case "/deploymentManifestLocation"
                    If Not Uri.TryCreate(oArugment(1), UriKind.Absolute, _
                                         deploymentManifestLocation) Then
                        MsgBox("Error creating URI")
                    End If

                Case "/documentLocation"
                    documentLocation = oArugment(1)

                Case "/solutionID"
                    solutionID = Guid.Parse(oArugment(1))
            End Select
        Next
        Try
            ServerDocument.RemoveCustomization(documentLocation)
            ServerDocument.AddCustomization(documentLocation, assemblyLocation, _
                                            solutionID, deploymentManifestLocation, _
                                            True, nonpublicCachedDataMembers)

            Console.WriteLine("Insallation Location Modified Successfully")

        Catch ex As System.IO.FileNotFoundException
            Console.WriteLine("The specified document does not exist.")
            Console.ReadLine()


        Catch ex As System.IO.IOException
            Console.WriteLine("The specified document is read-only.")
            Console.ReadLine()


        Catch ex As InvalidOperationException

            Console.WriteLine("The customization could not be removed.\n" &
                ex.Message)
            Console.ReadLine()


        Catch ex As DocumentNotCustomizedException
            Console.WriteLine("The document could not be customized.\n" &
                ex.Message)
            Console.ReadLine()

        End Try
    End Sub

End Module

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Microsoft.VisualStudio.Tools.Applications.Runtime;
using Microsoft.VisualStudio.Tools.Applications;

namespace SetExcelDocumentProperties
{
    class Program
    {
        static void Main(string[] args)
        {
            string assemblyLocation = "";
            Guid solutionID = new Guid();
            Uri deploymentManifestLocation = null;
            string documentLocation = "";
            string[] nonpublicCachedDataMembers = null;

            for (int i = 0; i <= args.Count() - 1; i++)
            {
                Console.WriteLine(args[i]);
                string[] oArugment = args[i].Split('=');

                switch (oArugment[0])
                {
                    case "/assemblyLocation":
                        assemblyLocation = oArugment[1];
                        break;
                    case "/deploymentManifestLocation":
                        if (!Uri.TryCreate(oArugment[1], UriKind.Absolute, out deploymentManifestLocation))
                        {
                            Console.WriteLine("Error creating URI");
                        }
                        break;
                    case "/documentLocation":
                        documentLocation = oArugment[1];
                        break;
                    case "/solutionID":
                        solutionID = Guid.Parse(oArugment[1]);
                        break;
                }
            }
            try
            {
                ServerDocument.RemoveCustomization(documentLocation);
                ServerDocument.AddCustomization(documentLocation, assemblyLocation,
                                            solutionID, deploymentManifestLocation,
                                            true, out nonpublicCachedDataMembers);

            }
            catch (System.IO.FileNotFoundException)
            {
                Console.WriteLine("The specified document does not exist.");
            }
            catch (System.IO.IOException)
            {
                Console.WriteLine("The specified document is read-only.");
            }
            catch (InvalidOperationException ex)
            {
                Console.WriteLine("The customization could not be removed.\n" +
                    ex.Message);
            }
            catch (DocumentNotCustomizedException ex)
            {
                Console.WriteLine("The document could not be customized.\n" +
                    ex.Message);
            }
        }
    }
}

Compile el proyecto.

Para agregar una acción personalizada que ejecuta el programa

En Explorador de soluciones, expanda el nodo del proyecto OfficeAddInSetup y, a continuación el archivo Asistente de proyectos, en la siguiente ilustración.
En la barra de menú, elija Vista, Abrir.
En la parte inferior de la página Asistente de proyectos, elija el botón Archivos de aplicación, en la siguiente ilustración.
En la página Archivos de aplicación, elija el botón Agregar resultados del proyecto.

El cuadro de diálogo Selector de salida de Visual Studio aparece.
Bajo el nodo SetExcelDocumentProperties, active la casilla Salida principal, y después elija el botón Aceptar.
En Explorador de soluciones, en el nodo OfficeAddInSetup, expanda el nodo Definir los requisitos de instalación y las acciones y, a continuación la carpeta Acciones personalizadas.
En la barra de menú, elija Vista, Abrir.

Una lista de eventos aparece en un panel al lado de la pantalla.

[!NOTA]

Sólo algunos eventos que aparecen en esta lista están disponibles en InstallShield Limited edition.En este procedimiento, ejecutará el programa mediante el evento Después de diálogo correcto completo configuración.

En la lista de eventos, en Acciones personalizadas durante la instalación, abra el menú contextual para el evento Después de diálogo correcto completo configuración, y después elija Nuevo EXE.

Una acción personalizada que se denomina NewCustomAction1 aparece bajo el evento Después de diálogo correcto completo configuración.Un conjunto de propiedades para la acción personalizada aparece en un panel junto a los eventos.

Importante
Dos eventos Después de diálogo correcto completo configuración aparecen en la lista de eventos.Asegúrese de elegir la instancia del evento Después de diálogo correcto completo configuración que aparece bajo el nodo Acciones personalizadas durante la instalación.

En la lista para la propiedad Ubicación de origen, elija Instalado con el Producto.
Elija el botón examinar junto a la propiedad Nombre del archivo.
En el cuadro de diálogo Busque un archivo de destino, vaya al archivo SetExcelDocumentProperties.Primary.output, y elija el botón Abrir.

La ubicación de este archivo depende de la carpeta que especificó para la propiedad INSTALLDIR del proyecto de instalación.Por ejemplo, si establece la propiedad en una carpeta que se denomina [PersonalFolder] DemoWorkbookApp, puede encontrar el archivo SetExcelDocumentProperties.Primary.output busque [ProgramFilesFolder] \DemoWorkbookApp.

En los pasos siguiente, obtendrá el identificador de la solución del documento y después pasa ese identificador como parámetro a la aplicación de consola.También pasará la ubicación del documento, el manifiesto de implementación, y el ensamblado del documento.
Abra el menú contextual de la aplicación para el proyecto ExcelWorkbook y, a continuación Abrir carpeta en el Explorador de Windows o Abrir carpeta en el Explorador de archivos dependiendo del sistema operativo.

La carpeta que contiene la solución se abre.
Abra el archivo de proyecto de la solución en el Bloc de notas.Para los proyectos de Visual Basic, el nombre de archivo es ExcelWorkbook.vbproj.Para los proyectos de C#, el nombre de archivo es ExcelWorkbook.csproj.
En el archivo de proyecto, la búsqueda del elemento de <SolutionID>, copie el valor en el portapapeles, y cierra el Bloc de notas.

Pasa este valor en la aplicación de consola como parámetro.

En la página de propiedades NewCustomAction1, establezca la propiedad Línea de comandos en la siguiente línea de texto.

/assemblyLocation="[INSTALLDIR]ExcelWorkbook.dll" /deploymentManifestLocation="[INSTALLDIR]ExcelWorkbook.vsto" /documentLocation="[INSTALLDIR]ExcelWorkbook.xlsx" /solutionID="Your Solution ID"

Reemplace Your Solution ID con el identificador de la solución que copió en el portapapeles.

Importante
Pruebe el instalador para comprobar que la aplicación de consola que esta acción personalizada se ejecuta puede tener acceso a documentos en el directorio [INSTALLDIR].Algunos directorios en el equipo del usuario pueden requerir acceso administrativo (por ejemplo, el directorio archivos de programa).Si implementa la solución en un directorio que requiere acceso administrativo, debe abrir el cuadro de diálogo propiedades del archivo setup.exe, elija la ficha Compatibilidad, y seleccione la casilla Ejecute este programa como administrador antes de que se distribuye el instalador.Si no desea que los usuarios para ejecutar el programa de instalación con permisos administrativos, establezca la propiedad [INSTALLDIR] en un directorio en el que el usuario tenga probablemente acceso ya, como el directorio Documentos.Para obtener más información, vea la sección Especifique dónde instalar la solución en el equipo del usuario de este tema.

Pruebe el instalador para comprobar que la aplicación de consola que esta acción personalizada se ejecuta puede tener acceso a documentos en el directorio [INSTALLDIR].Algunos directorios en el equipo del usuario pueden requerir acceso administrativo (por ejemplo, el directorio archivos de programa).Si implementa la solución en un directorio que requiere acceso administrativo, debe abrir el cuadro de diálogo propiedades del archivo setup.exe, elija la ficha Compatibilidad, y seleccione la casilla Ejecute este programa como administrador antes de que se distribuye el instalador.Si no desea que los usuarios para ejecutar el programa de instalación con permisos administrativos, establezca la propiedad [INSTALLDIR] en un directorio en el que el usuario tenga probablemente acceso ya, como el directorio Documentos.Para obtener más información, vea la sección Especifique dónde instalar la solución en el equipo del usuario de este tema.

Compile el proyecto de instalación

En Explorador de soluciones, expanda el nodo Preparar el inicio y, a continuación el archivo Versiones.
En la barra de menú, elija Vista, Abrir.

El explorador Compilaciones abre en un panel de para poder elegir el tipo de inicio que desee crear.
En el explorador Compilaciones, elija la carpeta SingleImage.
En el panel al lado del explorador Compilaciones, elija la ficha Setup.exe.
En la página de propiedades Setup.exe, la lista Ubicación de los requisitos previos de InstallShield, elija Extraer Setup.exe.
En la barra de menú, elija Compilación, Administrador de configuración.
En la lista Configuración de soluciones activas, elija SingleImage.
En la tabla Contextos de proyecto, en la columna Configuración de proyectos OfficeAddInSetup, elija SingleImage, y elija el botón Cerrar.
En la barra de menú, elija Compilación, Compilación OfficeAddInSetup.

Después de la compilación finalice, puede buscar el archivo setup.exe de proyectos OfficeAddInSetup en la ubicación siguiente: OfficeAddInSetupProjectRoot\OfficeAddInSetup\Express\SingleImage\DiskImages\DISK1\

Vea también

Compartir a través de