Implantando uma solução do Office usando o Windows Installer

  • Artigo

Aprender como criar um arquivo do Windows Installer (.msi) para sua solução de Office 2013 ou de Office 2010 usando Visual Studio 2012.

Usando Visual Studio 2012 para criar um arquivo do Windows Installer, você pode implantar uma solução de Office 2013 ou de Office 2010 que requer acesso administrativo no computador do usuário final.Por exemplo, você pode usar um arquivo para instalar os usuários vez de uma solução somente de um computador.Você também pode implantar uma solução do Office usando ClickOnce, mas essa solução deve ser instalado separadamente para cada usuário do computador.

Para exibir uma lista completa de diferenças entre a implantação do Windows Installer e implantação de ClickOnce, consulte Escolhendo uma estratégia de implantação.

Neste tópico

  • Baixar exemplos

  • Obter edição limitada de InstallShield

  • Decida como conceder a confiança a solução

  • Crie um projeto de configuração

  • Adicione a saída do projeto

  • Adicione os manifestos de implantação e do aplicativo

  • Configurar os componentes dependentes como pré-requisitos

  • Especificar onde instalar a solução no computador do usuário

  • Configure an add-in

  • Configurar uma personalização de um documento nível

  • Compilar o projeto de configuração

Para obter mais informações sobre como implantar uma solução do Office usando ClickOnce, consulte Implantando uma solução do Office usando o ClickOnce.

Para obter informações sobre como criar um arquivo do Windows Installer usando Visual Studio 2010, consulte Implantar ferramentas do Visual Studio 2010 para a solução do Office usando Windows Installer.

Baixar exemplos

Este tópico refere-se aos exemplos carregável.

Exemplo

Descrição

ExcelAddIn

Um suplemento do excel que você possa instalar em um computador que executa uma versão de 32 bits ou 64 bits do Office.

ExcelWorkbook

Uma personalização de um documento nível do excel que você possa instalar em um computador que executa uma versão de 32 bits ou 64 bits do Office.

Decida como conceder a confiança a solução

Antes que uma solução pode executar em computadores de usuário, você deve conceder ou em confiança das seguintes maneiras, ou os usuários devem responder a um aviso de confiança quando instalar a solução.

ObservaçãoObservação

Para personalizações de um documento nível, o local do documento também deve ser confiável.Para obter mais informações, consulte Concedendo confiança aos documentos.

Obter edição limitada de InstallShield

Você pode criar um arquivo do Windows Installer usando a edição limitada de InstallShield (ILHA), que está livre se você instalou o Visual Studio.A ILHA substitui a funcionalidade dos modelos de projeto para a configuração e implantação que as versões anteriores do Visual Studio ofereceram.

Para obter edição limitada de InstallShield

  1. Na barra de menu, escolha Arquivo, Novo, Projeto.

    A Caixa de diálogo Novo Projeto é exibida.

  2. No painel de modelos, expanda Outros tipos de projetos, e então escolha o modelo de Instalação e implantação .

  3. Na lista de tipos de projeto para Instalação e implantação, escolha Habilitar edição limitada de InstallShield, escolha o botão de OK .

    Aparece uma página que fornece informações sobre como obter edição limitada de InstallShield.

  4. Na página, escolha o link de Vá para o site de download .

  5. Na página de download para edição limitada de InstallShield, insira as informações necessárias nos campos apropriados, e clique no link de Baixar Agora .

    Depois que você baixa, instalar, e ativa o produto, o modelo de Edição limitada Projeto de InstallShield aparece no Visual Studio.

Crie um projeto de configuração

  1. Em Visual Studio, abra o projeto do Office que você deseja implantar.

    Os exemplos do suplemento ao nível que estão associados com este tópico contêm um projeto que é chamado ExcelAddIn.Exemplos de personalização de um documento nível contêm um projeto que é chamado ExcelWorkbook.Este tópico fará referência para o projeto do Office em sua solução usando um desses dois nomes.

  2. Na barra de menu, escolha Arquivo, Adicionar, Novo Projeto.

    A caixa de diálogo Adicionar novo projeto será aberto.

  3. No painel de modelos, expanda Outros tipos de projetos, e então escolha o modelo de Instalação e implantação .

  4. Na lista de tipos de projeto para Instalação e implantação, escolha Edição limitada Projeto de InstallShield, nomeie o projeto, e clique no botão de OK .

    O projeto de instalação de InstallShield que você criou aparecerá na sua solução.

    Os exemplos deste tópico contêm um projeto de instalação que é chamado OfficeAddInSetup.Este tópico fará referência para o projeto de configuração em sua solução usando o mesmo nome.

Adicione a saída do projeto

Você configura o projeto de OfficeAddInSetup incluir a saída do projeto do Office.Para projetos do suplemento ao aplicativo, a saída do projeto são o conjunto de solução somente.Para projetos de personalização de um documento nível, a saída do projeto incluem não apenas o assembly da solução mas também o documento próprio.

Para adicionar a saída do projeto

  1. Em Gerenciador de Soluções, expanda o nó de projeto OfficeAddInSetup , escolha o arquivo de Assistente de Projeto , que mostra a ilustração a seguir.

    Arquivo de Assistente de projeto no Solution Explorer

  2. Na barra de menus, escolha Modo de Visualização, Abrir.

  3. Na parte inferior da página de Projeta o assistente , escolha o botão de Arquivos do Aplicativo , que mostra a ilustração a seguir.

    Botão arquivos do aplicativo.

  4. Na página Arquivos do Aplicativo, escolha o botão Adicionar saídas do projeto.

  5. Na caixa de diálogo Seletor de saída do Visual Studio , selecione a caixa de seleção Saída Primária , escolha o botão de OK .

Adicione os manifestos de implantação e do aplicativo

  1. Na página de Arquivos do Aplicativo , escolha o botão de Adicionar Arquivos .

  2. Na caixa de diálogo Abrir , vá para o diretório de saída do projeto de ExcelAddIn .

    Geralmente, o diretório de saída é a subpasta bin \ release do diretório raiz do projeto, dependendo da configuração de compilação que você escolher.

  3. No diretório de saída, escolha os arquivos de ExcelAddIn.vsto e de ExcelAddIn.dll.manifest , escolha o botão de Abrir .

    A página de Arquivos do Aplicativo agora contém o arquivo de saída do projeto, o manifesto de implantação, e o manifesto do aplicativo, como mostra a ilustração a seguir.

    Os arquivos de saída de seu projeto de instalação.

Configurar os componentes dependentes como pré-requisitos

Em seu aplicativo de configuração, você deve incluir não somente os seguintes componentes mas também todos os outros componentes que são necessários para sua solução é executado.

  • A versão do.NET Framework que sua solução do Office se destina.

  • Microsoft Visual Studio 2010 Tools for Office Runtime.

Cc442767.collapse_all(pt-br,VS.110).gifAdicione o .NET Framework 4 ou o .NET Framework 4.5 como um pré-requisito

  1. Em Gerenciador de Soluções, expanda o nó de projeto OfficeAddInSetup , expanda o nó de Especificar dados de aplicativo , escolha o arquivo de Redistributables , que mostra a ilustração a seguir.

    Os arquivos redistribuíveis no Solution Explorer

  2. Na barra de menus, escolha Modo de Visualização, Abrir.

    A página de Redistributables abre.

  3. Na lista de componentes redistribuíveis apropriado, selecione a caixa de seleção para a versão do.NET Framework que sua solução se destina.

    Por exemplo, se sua solução propriedades .NET Framework 4.5, selecione a caixa de seleção Microsoft .NET Framework 4.5 Completo .Uma caixa de diálogo pode parecer perguntando se você deseja instalar o componente redistribuível, que requer InstallShield antes de adicionar o componente como um pré-requisito.Se esta caixa de diálogo não aparece, o componente já existe em seu computador.

  4. Se esta caixa de diálogo aparece, escolha o botão de Sim para baixar o componente redistribuível.

    ObservaçãoObservação

    Uma mensagem de erro pode especificar que o download falhou.Você geralmente pode ignorar esse erro.Para verificar se você baixa com êxito o arquivo, procurar o seguinte diretório no computador:

    Para sistemas operacionais de 32 bits: %ProgramFiles%InstallShield 2012SpringLE \ \ \ Microsoft \ SetupPrerequisites.redeVersão\ \ \FullOrClient

    Para sistemas operacionais de 64 bits: %ProgramFiles x (%)InstallShield 2012SpringLE \ \ \ Microsoft \ SetupPrerequisites.redeVersão\ \ \FullOrClient

    Se o arquivo não está em nenhum desses diretórios, você deve baixá-lo e colocá-lo no diretório apropriado.

    Para baixar o .NET Framework 4, consulte https://download.microsoft.com/download/9/5/A/95A9616B-7A37-4AF6-BC36-D6EA96C8DAAE/dotNetFx40_Full_x86_x64.exe

    Para baixar o cliente do .NET Framework 4, consulte https://download.microsoft.com/download/5/6/2/562A10F9-C9F4-4313-A044-9C94E0A8FAC8/dotNetFx40_Client_x86_x64.exe

    Para baixar o .NET Framework 4.5, consulte https://download.microsoft.com/download/b/a/4/ba4a7e71-2906-4b2d-a0e1-80cf16844f5f/

    ObservaçãoObservação

    Para localizar o URL de qualquer pré-requisitos que seja listado na página de Redistributables , abra o arquivo %ProgramFiles%apropriado de .prq no InstallShield 2012SpringLE \ \ \ \ SetupPrerequisites pasta no seu computador.Em cada arquivo de .prq, o URL aparece no atributo de URL do elemento de <file> .

Cc442767.collapse_all(pt-br,VS.110).gifAdicione o 2010 Visual Studio Tools for Office Runtime

A página de Redistributables contém um item que é chamado Tempo de Execução do Microsoft VSTO 2010, mas refere-se a uma versão anterior do tempo de execução.Portanto, você deve criar manualmente um arquivo de configuração que faz referência a versão mais recente.Você deve então coloque esse arquivo no mesmo diretório que os arquivos de configuração para todos os outros itens que aparecem na página de Redistributables .

Para adicionar o 2010 Visual Studio Tools for Office Runtime como um pré-requisito

  1. Bloco de Notas, abra e dimensionamento no seguinte XML em um arquivo 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>

  2. Gerar GUID usando o programa de Gerador de GUID no seu computador.

    Para localizar o programa de Gerador de GUID no seu computador, abra o menu de Iniciar e o tipo Gerador de GUID na caixa de pesquisa.

  3. No programa de Gerador de GUID , escolha o botão de opção de Formato de Registro , escolha o botão de Copiar , escolha o botão de Sair .

  4. No Bloco De Notas, substitua o texto Your GUID goes here colando GUID em seu lugar.

    O elemento de <properties> do arquivo é semelhante ao seguinte.

    <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>

  5. Na barra de menus em Bloco De Notas, escolha Arquivo, Salvar.

  6. Na caixa de diálogo Salvar como , vá para a pasta de Área de Trabalho .

  7. Na lista de Salvar como tipo , escolha Todos os Arquivos (*.*)(*.*).

  8. Na caixa de Nome do Arquivo , entre em Ferramentas do Visual Studio 2010 para Office Runtime.prq, escolha o botão de Salvar .

    ObservaçãoObservação

    Certifique-se de adicionar .prq no final do nome de arquivo para identificar este arquivo como um arquivo necessário.

  9. Feche o Bloco De Notas.

  10. De sua pasta de Área de Trabalho , copie as ferramentas do Visual Studio 2010 para o arquivo do Office Runtime.prq a um dos diretórios no seu computador.

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

    Para sistemas operacionais de 64 bits: %ProgramFiles x (%)InstallShield \ \ \ \ SetupPrerequisites 2012SpringLE

  11. Na página de Redistribuível do projeto de InstallShield, escolha o botão de Atualizar para atualizar a lista de componentes redistribuíveis, como mostra a ilustração a seguir.

    Botão Atualizar.

  12. Na lista de componentes redistribuíveis, selecione a caixa de seleção Visual Studio 2010 Tools for Office Runtime .

    Uma caixa de diálogo pode parecer perguntando se você deseja instalar o componente redistribuível.Se esta caixa de diálogo não aparece, você pode ir para a seção Especificar onde instalar a solução no computador do usuário deste tópico.

  13. Se esta caixa de diálogo aparece, escolha o botão de Sim para baixar o componente redistribuível.

  14. ObservaçãoObservação

    Uma mensagem de erro pode especificar que o download falhou.Você pode ignorar esse erro.Para verificar se você baixa com êxito o arquivo, procurar o seguinte diretório no computador:

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

    Para sistemas operacionais de 64 bits: %ProgramFiles x (%)InstallShield 2012SpringLE \ \ \ \ \ VSTOR SetupPrerequisites
    Observação importanteImportante

    InstallShield pode ter baixado uma versão anterior do tempo de execução.Para certificar-se de que você tem a versão mais recente, baixar a versão mais recente do Visual Studio 2010 Microsoft Download CenterTools for Office do Runtime, e colocá-lo no diretório apropriado.

Especificar onde instalar a solução no computador do usuário

  1. Em Gerenciador de Soluções, expanda o nó de OfficeAddInSetup , expanda o nó de Organize sua configuração , escolha o arquivo de Informações Gerais .

  2. Na barra de menus, escolha Modo de Visualização, Abrir.

  3. Na lista de propriedades, escolha o botão de Procurar próximo à propriedade de INSTALLDIR .

  4. Na caixa de diálogo Definir INSTALLDIR , escolha uma pasta no computador do usuário onde você deseja instalar a solução.

    ObservaçãoObservação

    Você também pode criar subpastas na caixa de diálogo Definir INSTALLDIR abrindo o menu de atalho para qualquer pasta na lista.

Configurar um suplemento ao nível

Esta seção se aplica somente se you'redeploying um suplemento ao aplicativo.Se você estiver implantando um personalização de um documento nível imediatamente, você pode ir para a seção Configurar uma personalização de um documento nível .

Você deve criar chaves do Registro para ativar o aplicativo do Office descobrir e carregar o suplemento.O local da chave do Registro depende do aplicativo do Office.Para obter mais informações, consulte Entradas de registro de suplementos em nível de aplicativo.

Para configurar o Registro

  1. Em Gerenciador de Soluções, expanda o nó de projeto OfficeAddInSetup , expanda o nó de Organize sua configuração , escolha o arquivo de Informações Gerais .

  2. Na barra de menus, escolha Modo de Visualização, Abrir.

    As propriedades do projeto de instalação aparecem.

  3. Na lista para a propriedade de AllUSERS , especifique se você deseja esta solução a ser instalado para todos os usuários do computador ou apenas para o usuário instalando a solução.

    Para instalar a solução para todos os usuários, escolha ALLUSERS=1 (instalação por computador).

  4. Em Gerenciador de Soluções, escolha o nó do Assistente de Projeto .

    Na barra de menus, escolha Modo de Visualização, Abrir.

  5. Na parte inferior da página de Projeta o assistente , escolha o botão de Registro de Aplicativo , que mostra a ilustração a seguir.

    O botão de registro do aplicativo.

    A página de Registro de Aplicativo aparece.

  6. Sob Você deseja configurar os dados de Registro que seu aplicativo instalado?, escolha o botão de opção de Sim .

  7. Na lista do O modo de Registro do computador de destino , escolha HKEY_USER_SELECTABLE.

    A pasta de HKEY_USER_SELECTABLE é instalada em seção apropriada do Registro baseado em que você escolheu para a propriedade de ALLUSERS anteriormente neste procedimento.Se você definir essa propriedade como ALLUSERS=1 (instalação por computador), sua solução é instalado em seção do Registro de HKEY_LOCAL_MACHINE.

  8. Abra o menu de atalho para a pasta de HKEY_USER_SELECTABLE , escolha Novo, escolha Chave.

    Uma pasta que é chamada Nova chave nº aparece sob a pasta de HKEY_USER_SELECTABLE .

  9. Renomear uma nova pasta Software.

  10. Abra o menu de atalho para a pasta de Software , escolha Novo, escolha Chave.

    Uma pasta que é chamada Nova chave nº aparece sob a pasta de Software .

  11. Renomear uma nova pasta Microsoft, e continue a criar subpastas até que representa a hierarquia principal inteira.

    A hierarquia principal inteira é HKEY_USER_SELECTABLE\Software\Microsoft\Office\Excel\Addins\SampleCompany.ExcelAddIn.

    Se você estiver criando um instalador para versões de 64 bits do Office, a hierarquia inteira é HKEY_USER_SELECTABLE\Software\Wow6432Node\Microsoft\Office\Excel\Addins\SampleCompany.ExcelAddIn.

    A ilustração a seguir mostra a hierarquia das chaves quando você tiver terminado este exercício.

    A hierarquia de chave do registro.

    ObservaçãoObservação

    Como prática recomendada, inicie o nome do suplemento com o nome da empresa.Esta convenção aumenta a possibilidade que será a chave exclusiva e reduz a possibilidade de conflito com um suplemento de outro fornecedor.Suplementos que tem o mesmo nome pode, por exemplo, substituir teclas de cada um do registro.Essa abordagem não pode garantir que será a chave exclusiva mas pode reduzir conflitos de nome possíveis.

  12. Abra o menu de atalho para a chave de SampleCompany.ExcelAddIn , escolha Novo, escolha Valor da cadeia de caracteres.

    O novo valor de cadeia de caracteres aparece na lista dos os dados de Registro do computador de destino .O nome do valor da cadeia de caracteres é realçado para que você possa o renomear.

  13. Renomeie o valor à descrição.

  14. Repita este processo para criar os seguintes valores.

    Tipo de valor

    Nome

    Valor de cadeia de caracteres

    FriendlyName

    Valor de DWORD

    LoadBehavior

    Valor de cadeia de caracteres

    Manifesto

  15. Abra o menu de atalho para o valor de Descrição , escolha Modificar.

    A caixa de diálogo Editar Dados aparece.

  16. Na caixa de texto Dados do valor , digite o suplemento ao excel demonstração, escolha o botão de OK .

    Esta descrição aparece quando o usuário abre o aplicativo do Office, abre a caixa de diálogo Opções e, em seguida, no painel de Suplementos , escolher o suplemento.

  17. Abra o menu de atalho para o valor de FriendlyName , escolha Modificar.

    A caixa de diálogo Editar Dados aparece.

  18. Na caixa de texto Dados do valor , digite o suplemento ao excel demonstração, escolha o botão de OK .

    Essa cadeia de caracteres aparece na caixa de diálogo Suplementos de COM no aplicativo do Office.Por padrão, o valor da cadeia de caracteres é a identificação do suplemento

  19. Abra o menu de atalho para o valor de LoadBehavior , escolha Modificar.

    A caixa de diálogo Editar Dados aparece.

  20. Na caixa de texto Dados do valor , digite 3, e clique no botão de OK .

    Um valor de 3 carrega o suplemento quando o aplicativo for iniciado.Para obter mais informações sobre os valores de LoadBehavior, consulte Entradas de registro de suplementos em nível de aplicativo.

  21. Abra o menu de atalho para o valor de Manifesto , escolha Modificar.

    A caixa de diálogo Editar Dados aparece.

  22. Na caixa de texto Dados do valor , entre em INSTALLDIR file:/// [] ExcelAddIn.vsto|vstolocal, escolha o botão de OK .

    O Visual Studio 2010 Tools for Office Runtime usa esse caminho para localizar o manifesto de implantação.A parte de [INSTALLDIR] desse caminho é uma macro que mapeia a INSTALLDIR a propriedade na página de propriedades de Informações Gerais do projeto de configuração de InstallShield.Esta propriedade especifica o local no computador de destino para instalar o suplemento.O sufixo de |vstolocal garante que sua solução é carregada a pasta de instalação, não o cache de ClickOnce.

    A ilustração a seguir mostra como seus valores aparecem depois que você concluir este exercício.

    Valores do registro para o projeto de instalação do suplemento

Observação importanteImportante

Se você criar uma região do formulário personalizado em um suplemento para Outlook, você deve criar mais entradas do Registro para registrar a região com Outlook.Para obter mais informações, consulte Entradas do Registro para regiões do Outlook.

Configurar uma personalização de um documento nível

Esta seção se aplica somente se você estiver implantando um personalização de um documento nível.Se você estiver implantando um suplemento ao aplicativo, você pode ir imediatamente à seção de Compilar o projeto de configuração .

Personalizações de um documento nível não usam chaves do Registro.Em vez disso, as propriedades personalizadas do documento contêm o local de manifesto de implantação.

Para alterar propriedades personalizadas, você cria um programa que remove a personalização de um documento nível do documento, altere as propriedades adequadas, adequado e então anexe novamente a personalização do documento.Você então cria uma ação personalizada que executa o programa, e ação que você adiciona ao seu projeto de configuração.

Para criar um programa que modificar as propriedades do documento

  1. Na barra de menu, escolha Arquivo, Adicionar, Novo Projeto.

    A caixa de diálogo Adicionar Novo Projeto é exibida.

  2. No painel de modelos, sob o nó para o idioma que você deseja usar, escolha a pasta de Janelas .

  3. Na lista de tipos de projeto para Janelas, escolha o modelo de Aplicativo de Console .

  4. Nomeie o projeto SetExcelDocumentProperties, escolha o botão de OK .

  5. Em Gerenciador de Soluções, escolha o botão de Mostrar todos os arquivos , abra o menu de atalho para o nó de projeto SetExcelDocumentProperties , escolha Adicionar Referência.

  6. Na caixa de diálogo Referenciar o gerenciador , escolha o guia de Extensões , selecione a caixa de seleção ao lado dos seguintes conjuntos, escolha o botão de OK .

    • Microsoft.VisualStudio.Tools.Applications.Runtime

    • Microsoft.VisualStudio.Tools.Applications.ServerDocument

  7. Em Gerenciador de Soluções, escolha o arquivo de Module.vb (para aplicativos C#) ou o arquivo Module1.vb (para aplicativos do Visual Basic).

  8. Na barra de menus, escolha Modo de Visualização, Abrir.

  9. Substitua o conteúdo do arquivo inteiro com o código a seguir.

    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);
            }
        }
    }
}

  10. Compilar o projeto.

Para adicionar uma ação personalizada que executa seu programa

  1. Em Gerenciador de Soluções, expanda o nó de projeto OfficeAddInSetup , escolha o arquivo de Assistente de Projeto , que mostra a ilustração a seguir.

    Arquivo de Assistente de projeto no Solution Explorer

  2. Na barra de menus, escolha Modo de Visualização, Abrir.

  3. Na parte inferior da página de Projeta o assistente , escolha o botão de Arquivos do Aplicativo , que mostra a ilustração a seguir.

    Botão arquivos do aplicativo.

  4. Na página Arquivos do Aplicativo, escolha o botão Adicionar saídas do projeto.

    A caixa de diálogo Seletor de saída do Visual Studio aparece.

  5. Sob o nó de SetExcelDocumentProperties , selecione a caixa de seleção Saída Primária , escolha o botão de OK .

  6. Em Gerenciador de Soluções, no nó de OfficeAddInSetup , expanda o nó de Defina requisitos e ações de configuração , e escolha a pasta de Ações personalizadas .

  7. Na barra de menus, escolha Modo de Visualização, Abrir.

    Uma lista de eventos aparece em um painel ao lado da tela.

    ObservaçãoObservação

    Apenas alguns eventos que aparecem na lista estão disponíveis em edição limitada de InstallShield.Nesse procedimento, você executará o programa usando o evento de Após a caixa de diálogo com êxito completo de configuração .

  8. Na lista de eventos, em Ações personalizadas durante a instalação, abra o menu de atalho para o evento de Após a caixa de diálogo com êxito completo de configuração , escolha Novo EXE.

    Uma ação personalizada que é chamada NewCustomAction1 aparece no evento de Após a caixa de diálogo com êxito completo de configuração .Um conjunto de propriedades para a ação personalizada em um painel aparece ao lado de eventos.

    Observação importanteImportante

    Dois eventos de Após a caixa de diálogo com êxito completo de configuração aparecem na lista de eventos.Certifique-se de que você escolher a instância do evento de Após a caixa de diálogo com êxito completo de configuração que aparece sob o nó de Ações personalizadas durante a instalação .

  9. Na lista para a propriedade de Local de origem , escolha Instalado com o produto.

  10. Escolha o botão de Procurar próximo à propriedade de Nome do Arquivo .

  11. Na caixa de diálogo Procurar um arquivo de destino , navegue até o arquivo de SetExcelDocumentProperties.Primary.output , escolha o botão de Abrir .

    O local do arquivo depende da pasta que você especificou para a propriedade de INSTALLDIR do projeto de instalação.Por exemplo, se você definir essa propriedade para uma pasta que é chamada [PersonalFolder] DemoWorkbookApp, você pode localizar o arquivo de SetExcelDocumentProperties.Primary.output procurando a ] [De ProgramFilesFolder \ DemoWorkbookApp.

    Nas próximas etapas, você terá a identificação de solução do documento e passar no ID como um parâmetro para o aplicativo de console.Você também irá passar o local do documento, de manifesto de implantação, e o assembly do documento.

  12. Abra o menu de atalho para o aplicativo para o projeto de ExcelWorkbook , escolha Abrir pasta no Windows Explorer ou Abrir pasta no Gerenciador de Arquivos dependendo do sistema operacional.

    A pasta que contém sua solução aberta.

  13. Abra o arquivo de projeto de sua solução em Bloco De Notas.Para projetos Visual Basic, o nome do arquivo é ExcelWorkbook.vbproj.Para projetos C#, o nome do arquivo é ExcelWorkbook.csproj.

  14. No arquivo de projeto, a pesquisa para o elemento de <SolutionID> , copiar seu valor para a área de transferência, e então fecha Bloco De Notas.

    Você passa esse valor no aplicativo de console como um parâmetro.

  15. Na página de propriedades de NewCustomAction1, defina a propriedade de Linha de comando para a seguinte linha de texto.

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

  16. Substitua o Your Solution ID com a identificação de solução que você copiou na área de transferência.

    Observação importanteImportante

    Testar o instalador para verificar que o aplicativo de console que esta ação personalizada executa pode acessar documentos no diretório [] INSTALLDIR.Algumas pastas no computador do usuário podem exigir acesso administrativo (por exemplo, o diretório arquivos de programas.)Se você estiver implantando sua solução a um diretório que requer acesso administrativo, você deve abrir a caixa de diálogo Propriedades de arquivo setup.exe, escolher o guia de Compatibilidade e em seguida, selecione a caixa de seleção Executar o programa como o administrador antes de distribuir o instalador.Se você não deseja que os usuários para executar o programa de instalação com permissões administrativas, defina a propriedade [] INSTALLDIR a um diretório para que o usuário provavelmente terá acesso já, como o diretório de Documentos .Para obter mais informações, consulte a seção Especificar onde instalar a solução no computador do usuário deste tópico.

Compilar o projeto de configuração

  1. Em Gerenciador de Soluções, expanda o nó de Prepare para a versão , escolha o arquivo de Liberações .

  2. Na barra de menus, escolha Modo de Visualização, Abrir.

    O gerenciador de Compilações abre em um painel lateral de modo que você possa escolher o tipo de versão que você deseja criar.

  3. No gerenciador de Compilações , escolha a pasta de SingleImage .

  4. No painel ao lado do gerenciador de Compilações , escolha o guia de Setup.exe .

  5. Na página de propriedades de Setup.exe , da lista de Local dos pré-requisitos de InstallShield , escolha Extrair Setup.exe.

  6. Na barra de menu, escolha Compilar, Gerenciador de Configurações.

  7. Na lista de Configuração da solução ativa , escolha SingleImage.

  8. Na tabela de Contextos projeto , na coluna de Configuração de projeto de OfficeAddInSetup , escolha SingleImage, escolha o botão de Fechar .

  9. Na barra de menus, escolha Compilar, Compilação OfficeAddInSetup.

    Após a compilação for concluída, você pode localizar o arquivo setup.exe de projeto de OfficeAddInSetup no seguinte local: OfficeAddInSetupProjectRoot\OfficeAddInSetup\Express\SingleImage\DiskImages\DISK1\

Consulte também

Referência

Entradas de registro de suplementos em nível de aplicativo

Conceitos

Visão geral sobre propriedades de documento personalizado

Concedendo confiança para soluções do Office

Concedendo confiança aos documentos

Outros recursos

Pré-requisitos da solução para implantação do Office

Implantando uma solução do Office

Implantar ferramentas do Visual Studio 2010 para a solução do Office usando Windows Installer