Implantar uma solução do Office usando o ClickOnce

Você pode implantar sua solução do Office em menos etapas se usar o ClickOnce. Se você publicar atualizações, sua solução as detectará e instalará automaticamente. No entanto, o ClickOnce requer que você instale sua solução separadamente para cada usuário de um computador. Portanto, você deve considerar o uso do Windows Installer (.msi) se mais de um usuário executar sua solução no mesmo computador.

Neste tópico

• Publicar a solução

• Decidir como você deseja conceder confiança à solução

• Ajudar os usuários a instalar a solução

• Coloque o documento de uma solução no computador do usuário final (somente personalizações no nível do documento)

• Coloque o documento de uma solução em um servidor que executa o SharePoint (somente personalizações no nível do documento)

• Criar um instalador personalizado

• Publicar uma atualização

• Alterar o local de instalação de uma solução

• Reverter uma solução para uma versão anterior

  Para obter mais informações sobre como implantar uma solução do Office criando um arquivo do Windows Installer, consulte Implantar uma solução do Office usando o Windows Installer.

Publicar a solução

Você pode publicar sua solução usando o Assistente de Publicação ou o Designer de Projeto. Neste procedimento, você usará o Designer de Projeto porque ele fornece o conjunto completo de opções de publicação. Consulte o Assistente de Publicação (desenvolvimento do Office no Visual Studio).

Para publicar a solução

1. No Gerenciador de Soluções, escolha o nó nomeado para seu projeto.

2. Na barra de menus, escolha Project, ProjectNameProperties.

3. No Designer de Projeto, escolha a guia Publicar , que a ilustração a seguir mostra.

   

4. Na caixa Local da Pasta de Publicação (servidor ftp ou caminho do arquivo), insira o caminho da pasta em que você deseja que o Designer de Projeto copie os arquivos da solução.

   Você pode inserir qualquer um dos seguintes tipos de caminhos.

   • Um caminho local (por exemplo, C:\FolderName\FolderName).

   • Um caminho UNC (Convenção de Nomenclatura Uniforme) para uma pasta em sua rede (por exemplo, \\ServerName\FolderName).

   • Um caminho relativo (por exemplo, PublishFolder\, que é a pasta na qual o projeto é publicado por padrão).

5. Na caixa URL da Pasta de Instalação , insira o caminho totalmente qualificado do local em que os usuários finais encontrarão sua solução.

   Se você ainda não souber o local, não insira nada neste campo. Por padrão, o ClickOnce procura atualizações na pasta da qual os usuários instalam a solução.

6. Escolha o botão Pré-requisitos .

7. Na caixa de diálogo Pré-requisitos , verifique se a caixa de seleção Criar programa de instalação para instalar componentes de pré-requisito está marcada.

8. Na lista Escolher quais pré-requisitos instalar, marque as caixas de seleção do Windows Installer 4.5 e o pacote apropriado do .NET Framework.

   Por exemplo, se a solução for direcionada ao .NET Framework 4.5, marque as caixas de seleção para Windows Installer 4.5 e Microsoft .NET Framework 4.5 Full.

9. Se a solução for direcionada ao .NET Framework 4.5, marque também a caixa de verificação Ferramentas do Visual Studio 2010 para Office Runtime.

   Observação

   Por padrão, essa caixa de seleção não aparece. Para mostrar essa caixa de seleção, você deve criar um pacote Bootstrapper. Consulte Criar um pacote Bootstrapper para um Add-in VSTO do Office 2013 com o Visual Studio 2012.

10. Em Especificar o local de instalação para pré-requisitos, escolha uma das opções exibidas e escolha o botão OK .

    A tabela a seguir descreve cada opção.

    Opção	Description
    Baixar pré-requisitos do site do fornecedor de componentes	O usuário é solicitado a baixar e instalar esses pré-requisitos do fornecedor.
    Baixar pré-requisitos do mesmo local que meu aplicativo	O software necessário é instalado com a solução. Se você escolher essa opção, o Visual Studio copiará todos os pacotes de pré-requisitos para o local de publicação para você. Para que essa opção funcione, os pacotes de pré-requisito devem estar no computador de desenvolvimento.
    Baixe os pré-requisitos no local a seguir	O Visual Studio copia todos os pacotes de pré-requisitos para o local especificado e os instala com a solução.

    Consulte a caixa de diálogo Pré-requisitos.

11. Escolha o botão Atualizações, especifique a frequência que cada Suplemento VSTO ou personalização do usuário final deve verificar se há atualizações e, em seguida, escolha o botão OK.

    Observação

    Se você estiver implantando usando um CD ou uma unidade removível, escolha o botão de opção Nunca verificar se há atualizações .

    Para obter informações sobre como publicar uma atualização, consulte Publicar uma atualização.

12. Escolha o botão Opções , examine as opções na caixa de diálogo Opções e escolha o botão OK .

13. Escolha o botão Publicar Agora .

    O Visual Studio adiciona as pastas e arquivos a seguir à pasta de publicação especificada anteriormente neste procedimento.

    • A pasta Arquivos do Aplicativo .

    • O programa de instalação.

    • Um manifesto de implantação que aponta para o manifesto de implantação da versão mais recente.

      A pasta Arquivos de Aplicativo contém uma subpasta para cada versão publicada. Cada subpasta específica da versão contém os arquivos a seguir.

    • Um manifesto do aplicativo.

    • Um manifesto de implantação.

    • Conjuntos de customização.

      A ilustração a seguir mostra a estrutura da pasta de publicação de um Suplemento VSTO do Outlook.

      

    Observação

    O ClickOnce acrescenta a extensão .deploy a assemblies para que uma instalação segura dos Serviços de Informações da Internet (IIS) não bloqueie os arquivos devido a uma extensão não segura. Quando o usuário instala a solução, o ClickOnce remove a extensão .deploy .

14. Copie os arquivos da solução para o local de instalação especificado anteriormente neste procedimento.

Decidir como você deseja conceder confiança à solução

Antes que uma solução possa ser executada em computadores de usuário, você deve conceder confiança ou os usuários devem responder a um prompt de confiança ao instalar a solução. Para conceder confiança à solução, assine os manifestos usando um certificado que identifique um publicador conhecido e confiável. Veja Confie na solução assinando os manifestos de aplicativo e de implantação.

Se você estiver implantando uma personalização no nível do documento e quiser colocar o documento em uma pasta no computador do usuário ou disponibilizar o documento em um site do SharePoint, verifique se o Office confia no local do documento. Consulte Conceder confiança a documentos.

Ajudar os usuários a instalar a solução

Os usuários podem instalar a solução executando o programa de instalação, abrindo o manifesto de implantação ou durante a personalização no nível do documento, abrindo o documento diretamente. Como prática recomendada, os usuários devem instalar sua solução usando o programa de instalação. As outras duas abordagens não garantem que o software de pré-requisito esteja instalado. Se os usuários quiserem abrir o documento do local de instalação, eles deverão adicioná-lo à lista de locais confiáveis na Central de Confiabilidade do aplicativo do Office.

Abrindo o documento de uma customização em nível de documento

Os usuários podem abrir o documento de uma personalização no nível do documento diretamente do local de instalação ou copiando o documento para o computador local e abrindo a cópia.

Como prática recomendada, os usuários devem abrir uma cópia do documento em seus computadores para que vários usuários não tentem abrir a mesma cópia ao mesmo tempo. Para impor essa prática, você pode configurar seu programa de instalação para copiar o documento para computadores usuários. Consulte Colocar o documento de uma solução no computador do usuário final (somente personalizações no nível do documento).

Instalar a solução abrindo o manifesto de implantação de um site do IIS

Os usuários podem instalar uma solução do Office abrindo o manifesto de implantação a partir da web. No entanto, uma instalação protegida dos Serviços de Informações da Internet (IIS) bloqueará arquivos que têm a extensão .vsto . O tipo MIME deve ser definido no IIS antes de implantar uma solução do Office usando o IIS.

Para adicionar o tipo MIME .vsto ao IIS 6.0

1. No servidor que está executando o IIS 6.0, escolha Iniciar>Todos os ProgramasGerenciador de>> deInformações da Internet (IIS).

2. Escolha o nome do computador, a pasta Sites da Web ou o site que você está configurando.

3. Na barra de menus, escolhaPropriedades da >.

4. Na guia Cabeçalhos HTTP , escolha o botão Tipos MIME .

5. Na janela Tipos MIME, escolha o botão Novo.

6. Na janela Tipo MIME , insira .vsto como a extensão, insira application/x-ms-vsto como o tipo MIME e aplique as novas configurações.

   Observação

   Para que as alterações entrem em vigor, você deve reiniciar o World Wide Web Publishing Service ou aguardar a reciclagem do processo de trabalho. Em seguida, você deve liberar o cache de disco do navegador e tentar abrir o arquivo .vsto novamente.

Para adicionar o tipo MIME .vsto ao IIS 7.0

1. No servidor que está executando o IIS 7.0, escolha Iniciar>Todos os Acessórios de Programas>.

2. Abra o menu de atalho do Prompt de Comando e escolha Executar como administrador.

3. Na caixa Abrir , insira o caminho a seguir e escolha o botão OK .

   %windir%\system32\inetsrv
   

4. Insira o comando a seguir e aplique as novas configurações.

   set config /section:staticContent /+[fileExtension='.vsto',mimeType='application/x-ms-vsto']
   

   Observação

   Para que as alterações entrem em vigor, você deve reiniciar o World Wide Web Publishing Service ou aguardar a reciclagem do processo de trabalho. Em seguida, você deve liberar o cache de disco do navegador e tentar abrir o arquivo .vsto novamente.

Coloque o documento de uma solução no computador do usuário final (somente personalizações no nível do documento)

Você pode copiar o documento técnico da sua solução para o computador do usuário final ao criar uma ação pós-implantação. Dessa forma, o usuário não precisa copiar manualmente o documento do local de instalação para o computador depois de instalar a solução. Você precisará criar uma classe que defina a ação pós-implantação, crie e publique a solução, modifique o manifesto do aplicativo e assine novamente o manifesto do aplicativo e da implantação.

Os procedimentos a seguir pressupõem que o nome do projeto seja ExcelWorkbook e que você publique a solução em uma pasta criada chamada C:\publish em seu computador.

Criar uma classe que define a ação pós-implantação

1. Na barra de menus, escolha Arquivo>Adicionar>Novo Projeto.

2. Na caixa de diálogo Adicionar Novo Projeto , no painel Modelos Instalados , escolha a pasta do Windows .

3. No painel Modelos , escolha o modelo da Biblioteca de Classes .

4. No campo Nome , insira FileCopyPDA e escolha o botão OK .

5. No Gerenciador de Soluções, escolha o projeto FileCopyPDA .

6. Na barra de menus, escolha Project>Add Reference.

7. Na guia .NET , adicione referências a Microsoft.VisualStudio.Tools.Applications.Runtime e Microsoft.VisualStudio.Tools.Applications.ServerDocument.

8. Renomeie a classe como FileCopyPDA, e substitua o conteúdo do arquivo pelo código. Esse código executa as seguintes tarefas:

   • Copia o documento para a área de trabalho do usuário.

   • Altera a propriedade _AssemblyLocation de um caminho relativo para um caminho totalmente qualificado para o manifesto de implantação.

   • Excluirá o arquivo se o usuário desinstalar a solução.

     • C#
     • VB

     using Microsoft.VisualStudio.Tools.Applications.Deployment;
     using Microsoft.VisualStudio.Tools.Applications;
     using System.IO;
     
     namespace FileCopyPDA
     {
         public class FileCopyPDA : IAddInPostDeploymentAction
         {
             public void Execute(AddInPostDeploymentActionArgs args) 
             {
                 string dataDirectory = @"Data\ExcelWorkbook.xlsx";
                 string file = @"ExcelWorkbook.xlsx";
                 string sourcePath = args.AddInPath;
                 Uri deploymentManifestUri = args.ManifestLocation;
                 string destPath = Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory);
                 string sourceFile = System.IO.Path.Combine(sourcePath, dataDirectory);
                 string destFile = System.IO.Path.Combine(destPath, file);
     
                 switch (args.InstallationStatus)
                 {
                     case AddInInstallationStatus.InitialInstall:
                     case AddInInstallationStatus.Update:
                         File.Copy(sourceFile, destFile);
                         ServerDocument.RemoveCustomization(destFile);
                         ServerDocument.AddCustomization(destFile, deploymentManifestUri);
                         break;
                     case AddInInstallationStatus.Uninstall:
                         if (File.Exists(destFile))
                         {
                             File.Delete(destFile);
                         }
                         break;
                 }
             }
         }
     }
     

   ---

Criar e publicar a solução

1. No Gerenciador de Soluções, abra o menu de atalho do projeto FileCopyPDA e escolha Compilar.

2. Abra o menu de atalho do projeto ExcelWorkbook e escolha Compilar.

3. Abra o menu de atalho do projeto ExcelWorkbook e, em seguida, escolha Adicionar Referência.

4. Na caixa de diálogo Adicionar Referência , escolha a guia Projetos , escolha FileCopyPDA e escolha o botão OK .

5. No Gerenciador de Soluções, escolha o projeto ExcelWorkbook .

6. Na barra de menus, escolha Project>New Folder.

7. Insira Dados e, em seguida, escolha a chave Enter.

8. No Gerenciador de Soluções, escolha a pasta Dados .

9. Na barra de menus, escolha Project>Add Existing Item.

10. Na caixa de diálogo Adicionar Item Existente , navegue até o diretório de saída do projeto ExcelWorkbook , escolha o arquivo ExcelWorkbook.xlsx e escolha o botão Adicionar .

11. No Gerenciador de Soluções , escolha o arquivo ExcelWorkbook.xlsx .

12. Na janela Propriedades, altere a propriedade Ação de Build para Conteúdo e a propriedade Copiar para Diretório de Destino para Copiar se for mais recente.

    Quando você concluir essas etapas, seu projeto será semelhante à ilustração a seguir.

    

13. Publicar o projeto ExcelWorkbook.

Modificar o manifesto do aplicativo

1. Abra o diretório da solução, c:\publish, usando o Explorador de Arquivos.

2. Abra a pasta Arquivos de Aplicativo e abra a pasta que corresponde à versão publicada mais recente da solução.

3. Abra o arquivo .manifestExcelWorkbook.dll em um editor de texto, como o Bloco de Notas.

4. Após o elemento </vstav3:update>, adicione o código a seguir. Para o atributo de classe do <vstav3:entryPoint> elemento, use a seguinte sintaxe: NamespaceName.ClassName. No exemplo a seguir, os nomes de namespace e classe são os mesmos, portanto, o nome do ponto de entrada resultante é FileCopyPDA.FileCopyPDA.

   <vstav3:postActions>
     <vstav3:postAction>
       <vstav3:entryPoint
         class="FileCopyPDA.FileCopyPDA">
         <assemblyIdentity
           name="FileCopyPDA"
           version="1.0.0.0"
           language="neutral"
           processorArchitecture="msil" />
       </vstav3:entryPoint>
       <vstav3:postActionData>
       </vstav3:postActionData>
     </vstav3:postAction>
   </vstav3:postActions>
   

Assinar novamente os manifestos de aplicativo e implantação

1. Na pasta %USERPROFILE%\Documents\Visual Studio 2013\Projects\ExcelWorkbook\ExcelWorkbook , copie o arquivo de certificado ExcelWorkbook_TemporaryKey.pfx e cole-o na pasta PublishFolder\Application Files\ExcelWorkbook_MostRecentPublishedVersion .

2. Abra o prompt de comando do Visual Studio e altere os diretórios para a pasta c:\publish\Application Files\ExcelWorkbook_MostRecentPublishedVersion (por exemplo, c:\publish\Application Files\ExcelWorkbook_1_0_0_4).

3. Assine o manifesto do aplicativo modificado executando o seguinte comando:

   mage -sign ExcelWorkbook.dll.manifest -certfile ExcelWorkbook_TemporaryKey.pfx
   

   A mensagem "ExcelWorkbook.dll.manifest assinado com êxito" é exibida.

4. Altere para a pasta c:\publish e atualize e assine o manifesto de implantação executando o seguinte comando:

   mage -update ExcelWorkbook.vsto -appmanifest "Application Files\Ex
   celWorkbookMostRecentVersionNumber>\ExcelWorkbook.dll.manifest" -certfile "Application Files\ExcelWorkbookMostRecentVersionNumber>\ExcelWorkbook_TemporaryKey.pfx"
   

   Observação

   No exemplo anterior, substitua MostRecentVersionNumber pelo número de versão da versão publicada mais recentemente da solução (por exemplo, 1_0_0_4).

   A mensagem "ExcelWorkbook.vsto assinado com êxito" é exibida.

5. Copie o arquivo ExcelWorkbook.vsto para o diretório c:\publish\Application Files\ExcelWorkbook_MostRecentVersionNumber .

Coloque o documento de uma solução em um servidor que executa o SharePoint (somente personalizações no nível do documento)

Você pode publicar sua personalização no nível do documento para os usuários finais usando o SharePoint. Quando os usuários vão ao site do SharePoint e abrem o documento, o runtime instala automaticamente a solução da pasta de rede compartilhada no computador local do usuário. Depois que a solução for instalada localmente, a personalização ainda funcionará mesmo se o documento for copiado em outro lugar, como a área de trabalho.

Para colocar o documento em um servidor que está executando o SharePoint

1. Adicione o documento da solução a uma biblioteca de documentos em um site do SharePoint.

2. Execute as etapas para uma das seguintes abordagens:

   • Use a Ferramenta de Configuração do Office para adicionar o servidor que está executando o SharePoint à Central de Confiabilidade no Word ou excel em todos os computadores de usuário.

     Consulte as políticas e as configurações de segurança no Office 2010.

   • Verifique se cada usuário executa as etapas a seguir.

     1. No computador local, abra o Word ou o Excel, escolha a guia Arquivo e escolha o botão Opções .

     2. Na caixa de diálogo Central de Confiabilidade , escolha o botão Locais Confiáveis .

     3. Marque a caixa de seleção Permitir Locais Confiáveis na minha rede (não recomendado) e, em seguida, escolha o botão Adicionar novo local .

     4. Na caixa Caminho , insira a URL da biblioteca de documentos do SharePoint que contém o documento que você carregou (por exemplo, http://SharePointServerName/TeamName/ProjectName/DocumentLibraryName).

        Não adicione o nome da página da Web padrão, como default.aspx ou AllItems.aspx.

     5. Marque a caixa Subpastas deste local também são confiáveis e escolha o botão OK.

        Quando os usuários abrem o documento no site do SharePoint, o documento é aberto e a personalização é instalada. Os usuários podem copiar o documento para a área de trabalho. A customização ainda será executada porque as propriedades do documento apontam para o local de rede do documento.

Criar um instalador personalizado

Você pode criar um instalador personalizado para sua solução do Office, em vez de usar o programa de instalação criado para você ao publicar a solução. Por exemplo, você pode usar um script de entrada para iniciar a instalação ou pode usar um arquivo em lote para instalar a solução sem interação do usuário. Esses cenários funcionarão melhor se os pré-requisitos já estiverem instalados em computadores de usuário final.

Como parte do processo de instalação personalizado, chame a ferramenta de instalador para soluções do Office (VSTOInstaller.exe), que é instalada no seguinte local por padrão:

%commonprogramfiles%\microsoft shared\VSTO\10.0\VSTOInstaller.exe

Se a ferramenta não estiver nesse local, você poderá usar o HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath ou HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath chave do Registro para encontrar o caminho para essa ferramenta.

Você pode usar os parâmetros a seguir com VSTOinstaller.exe.

Quando você executa VSTOinstaller.exe, os códigos de erro a seguir podem aparecer.

Publicar uma atualização

Para atualizar uma solução, publique-a novamente usando o Designer de Projeto ou o Assistente de Publicação e copie a solução atualizada para o local de instalação. Ao copiar os arquivos para o local de instalação, certifique-se de substituir os arquivos anteriores.

Na próxima vez que a solução verificar uma atualização, ela encontrará e carregará a nova versão automaticamente.

Alterar o local de instalação de uma solução

Você pode adicionar ou alterar o caminho de instalação após a publicação de uma solução. Talvez você queira alterar o caminho de instalação por um ou mais dos seguintes motivos:

• O programa de instalação foi compilado antes do caminho de instalação ser conhecido.

• Os arquivos da solução foram copiados para um local diferente.

• O servidor que hospeda os arquivos de instalação tem um novo nome ou local.

  Para alterar o caminho de instalação de uma solução, você deve atualizar o programa de instalação e, em seguida, os usuários devem executá-lo. Para personalizações no nível do documento, os usuários também devem atualizar uma propriedade em seu documento para apontar para a nova localização.

Para alterar o caminho de instalação no programa de instalação

1. Abra uma janela do Prompt de Comando e altere os diretórios para a pasta de instalação.

2. Execute o programa de instalação e inclua o /url parâmetro, que usa o novo caminho de instalação como uma cadeia de caracteres.

   O exemplo a seguir mostra como alterar o caminho de instalação para um local no site da Fabrikam, mas você pode substituir essa URL pelo caminho desejado:

   setup.exe /url="http://www.fabrikam.com/newlocation"
   

   Observação

   Se uma mensagem for exibida e indicar que a assinatura do executável será invalidada, o certificado usado para assinar a solução não será mais válido e o publicador será desconhecido. Como resultado, os usuários precisarão confirmar que confiam na origem da solução antes de poderem instalá-la.

   Observação

   Para exibir o valor atual da URL, execute setup.exe /url.

   Para personalizações no nível do documento, os usuários devem abrir o documento e atualizar sua propriedade _AssemblyLocation. As etapas a seguir descrevem como os usuários podem executar essa tarefa.

Para atualizar a propriedade _AssemblyLocation em um documento

1. Na guia Arquivo , escolha Informações, que a ilustração a seguir mostra.

   

2. Na lista Propriedades , escolha Propriedades Avançadas, que a ilustração a seguir mostra.

   

3. Na guia Personalizado na lista Propriedades, escolha _AssemblyLocation, como mostra a ilustração a seguir.

   

   A caixa Valor contém o identificador de manifesto de implantação.

4. Antes do identificador, insira o caminho totalmente qualificado do documento, seguido por uma barra, no formato Caminho|Identificador (por exemplo, File://ServerName/FolderName/FileName|74744e4b-e4d6-41eb-84f7-ad20346fe2d9).

   Para obter mais informações sobre como formatar esse identificador, consulte a visão geral das propriedades do documento personalizado.

5. Escolha o botão OK e salve e feche o documento.

6. Execute o programa de instalação sem o parâmetro /url para instalar a solução no local especificado.

Reverter uma solução para uma versão anterior

Ao reverter uma solução, você reverte os usuários para uma versão anterior dessa solução.

Para reverter uma solução

1. Abra o local de instalação da solução.

2. Na pasta de publicação de nível superior, exclua o manifesto de implantação (o arquivo .vsto ).

3. Encontre o subdiretório da versão que você deseja reverter.

4. Copie o manifesto de implantação dessa subpasta para a pasta de publicação de nível superior.

   Por exemplo, para reverter uma solução chamada OutlookAddIn1 da versão 1.0.0.1 para a versão 1.0.0.0, copie o arquivo OutlookAddIn1.vsto da pasta OutlookAddIn1_1_0_0_0 . Cole o arquivo na pasta de publicação de nível superior, sobrepondo o manifesto de implantação da versão específica para OutlookAddIn1_1_0_0_1 que já estava lá.

   A ilustração a seguir mostra a estrutura da pasta de publicação neste exemplo.

   

   Na próxima vez que um usuário abrir o aplicativo ou o documento personalizado, a alteração do manifesto de implantação será detectada. A versão anterior da solução do Office é executada no cache ClickOnce.

Conteúdo relacionado

• Implantar uma solução do Office
• Publicar soluções do Office
• Como publicar uma solução do Office usando o ClickOnce
• Como instalar uma solução do ClickOnce Office
• Como publicar uma solução do Office no nível do documento em um servidor do SharePoint usando o ClickOnce
• Criar um instalador personalizado para uma solução do Office ClickOnce