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 vai detectá-las e instalá-las automaticamente. No entanto, o ClickOnce exige que sua solução seja instalada separadamente para cada usuário de um computador. Portanto, você deve considerar o uso de Windows Installer (. msi) se mais de um usuário executar sua solução no mesmo computador.

Neste tópico

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. Em Gerenciador de soluções, escolha o nó que é nomeado para seu projeto.

  2. Na barra de menus, escolha Project, Propriedades ProjectName.

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

    A guia publicar do designer de projeto

  4. Na caixa local da pasta de publicação (servidor FTP ou caminho do arquivo) , insira o caminho da pasta na qual você deseja que o Designer de projeto Copie os arquivos da solução.

    Você pode inserir qualquer um destes tipos de caminho.

    • 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 onde os usuários finais encontrarão sua solução.

    Se você ainda não souber o local, não insira nada nesse campo. Por padrão, o ClickOnce procura atualizações na pasta da qual seus 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é-requisitos está marcada.

  8. Na lista escolha os pré-requisitos a serem instalados , marque as caixas de seleção para Windows Installer 4,5 e o pacote de .NET Framework apropriado.

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

  9. Se sua solução tiver como alvo o .NET Framework 4,5, marque também a caixa de seleção Visual Studio 2010 Tools for Office Runtime .

    Observação

    Por padrão, essa caixa de seleção não aparece. Para mostrá-la, é preciso criar um pacote Bootstrapper. Consulte criar um pacote de bootstrapper para um suplemento do VSTO do Office 2013 com o Visual Studio 2012.

  10. Em especificar o local de instalação para os pré-requisitos, escolha uma das opções que aparecem e, em seguida, escolha o botão OK .

    A tabela a seguir descreve cada opção.

    Opção Descrição
    Baixar os pré-requisitos no site do fornecedor do componente É solicitado que o usuário baixe e instale esses pré-requisitos do fornecedor.
    Baixar os pré-requisitos no mesmo local do meu aplicativo O software de pré-requisito é instalado com a solução. Se você escolher essa opção, o Visual Studio copiará todos os pacotes do pré-requisito no local de publicação. Para que essa opção funcione, os pacotes do pré-requisito devem estar no computador de desenvolvimento.
    Baixar os pré-requisitos no seguinte local O Visual Studio copia todos os pacotes do pré-requisito no local que você especifica e os instala com a solução.

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

  11. Escolha o botão atualizações , especifique com que frequência você deseja que o suplemento ou a personalização do VSTO de cada usuário final Verifique 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 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, em seguida, escolha o botão OK .

  13. Escolha o botão Publicar agora .

    O Visual Studio adiciona as pastas e os arquivos a seguir à pasta de publicação que você especificou anteriormente neste procedimento.

    • A pasta arquivos de 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 que você publica. Cada subpasta específica da versão contém os arquivos a seguir.

    • Um manifesto de aplicativo.

    • Um manifesto de implantação.

    • Assemblies de personalização.

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

      Publicar estrutura de pastas

    Observação

    O ClickOnce acrescenta a extensão . Deploy a assemblies para que uma instalação segura do 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 no local de instalação que você especificou anteriormente neste procedimento.

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

Para que uma solução possa ser executada nos computadores dos usuários, você deve conceder confiança ou os usuários devem responder a uma solicitação de confiança quando instalam a solução. Para conceder confiança à solução, assine o manifesto usando um certificado que identifique um fornecedor conhecido e confiável. Consulte confiar na solução assinando os manifestos de implantação e de aplicativo.

Se você estiver implantando uma personalização em nível de 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 em nível de documento, abrindo o documento diretamente. Como uma prática recomendada, os usuários devem instalar a 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 desejarem 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 personalização no nível de documento

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

Como uma prática recomendada, os usuários devem abrir uma cópia do documento nos respectivos 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 o programa de instalação para copiar o documento nos computadores dos 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 na Web. No entanto, uma instalação segura do Serviços de Informações da Internet (IIS) bloqueará arquivos que têm a extensão . vsto . O tipo de MIME deve ser definido no IIS para que você possa implantar uma solução do Office usando o IIS.

Para adicionar o tipo de MIME .vsto ao IIS 6.0
  1. No servidor que está executando o IIS 6,0, escolha Iniciar > todos os programas > Ferramentas administrativas > serviços de informações da Internet (IIS) Manager.

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

  3. Na barra de menus, escolha > Propriedades da ação.

  4. Na guia cabeçalhos HTTP , escolha o botão tipos de 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 Serviço de Publicação na World Wide Web ou aguardar até que o processo de trabalho seja reciclado. Em seguida, você deve liberar o cache de disco do navegador e, em seguida, tentar abrir o arquivo . vsto novamente.

Para adicionar o tipo de MIME. vsto ao IIS 7,0
  1. No servidor que está executando o IIS 7,0, escolha Iniciar > todos os programas > acessórios.

  2. Abra o menu de atalho para o prompt de comando e escolha Executar como administrador.

  3. Na caixa abrir , digite o seguinte caminho e, em seguida, 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 Serviço de Publicação na World Wide Web ou deve aguardar até que o processo de trabalho seja reciclado. Em seguida, você deve liberar o cache de disco do navegador e, em seguida, tentar abrir o arquivo . vsto novamente.

Colocar 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 da solução no computador do usuário final para eles criando 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 sua solução. Você precisará criar uma classe que define a ação pós-implantação, compilar e publicar a solução, modificar o manifesto do aplicativo e assinar novamente o aplicativo e o manifesto de 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 no seu computador.

Criar uma classe que defina a ação de 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 Windows .

  3. No painel modelos , escolha o modelo biblioteca de classes .

  4. No campo nome , insira FileCopyPDA e, em seguida, escolha o botão OK .

  5. Em Gerenciador de soluções, escolha o projeto FileCopyPDA .

  6. Na barra de menus, escolha projeto > Adicionar referência.

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

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

    • Copia o documento na á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.

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

      Imports Microsoft.VisualStudio.Tools.Applications.Deployment
      Imports Microsoft.VisualStudio.Tools.Applications
      
      Public Class FileCopyPDA
          Implements IAddInPostDeploymentAction
      
          Sub Execute(ByVal args As AddInPostDeploymentActionArgs) Implements IAddInPostDeploymentAction.Execute
              Dim dataDirectory As String = "Data\ExcelWorkbook.xlsx"
              Dim file As String = "ExcelWorkbook.xlsx"
              Dim sourcePath As String = args.AddInPath
              Dim deploymentManifestUri As Uri = args.ManifestLocation
              Dim destPath As String = Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory)
              Dim sourceFile As String = System.IO.Path.Combine(sourcePath, dataDirectory)
              Dim destFile As String = System.IO.Path.Combine(destPath, file)
      
              Select Case args.InstallationStatus
                  Case AddInInstallationStatus.InitialInstall, AddInInstallationStatus.Update
                      System.IO.File.Copy(sourceFile, destFile)
                      ServerDocument.RemoveCustomization(destFile)
                      ServerDocument.AddCustomization(destFile, deploymentManifestUri)
                      Exit Select
                  Case AddInInstallationStatus.Uninstall
                      If System.IO.File.Exists(destFile) Then
                          System.IO.File.Delete(destFile)
                      End If
                      Exit Select
              End Select
          End Sub
      
      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;
                  }
              }
          }
      }
      

Compilar e publicar a solução

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

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

  3. Abra o menu de atalho para o projeto ExcelWorkbook e escolha Adicionar referência.

  4. Na caixa de diálogo Adicionar referência , escolha a guia projetos , escolha FileCopyPDA e, em seguida, escolha o botão OK .

  5. Em Gerenciador de soluções, escolha o projeto ExcelWorkbook .

  6. Na barra de menus, escolha projeto > nova pasta.

  7. Insira dados e, em seguida, escolha a tecla Enter .

  8. Em Gerenciador de soluções, escolha a pasta de dados .

  9. Na barra de menus, escolha projeto > Adicionar item existente.

  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, em seguida, escolha o botão Adicionar .

  11. Em Gerenciador de soluções escolha o arquivo de ExcelWorkbook.xlsx .

  12. Na janela Propriedades , altere a propriedade ação de compilação para conteúdo e a propriedade copiar para diretório de saída para copiar se mais recente.

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

    Estrutura do projeto da ação de pós-implantação.

  13. Publique o projeto ExcelWorkbook .

Modificar o manifesto de aplicativo

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

  2. Abra a pasta arquivos de aplicativos e, em seguida, abra a pasta que corresponde à versão publicada mais recente da sua solução.

  3. Abra o arquivo ExcelWorkbook.dll. manifest em um editor de texto como o bloco de notas.

  4. Depois do elemento </vstav3:update>, adicione o código a seguir. Para o atributo Class do <vstav3:entryPoint> elemento, use a seguinte sintaxe: NamespaceName. ClassName. No exemplo a seguir, os nomes de classe e o namespace são iguais, de modo que 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, em seguida, altere os diretórios para a pasta c:\publish\Application Files\ExcelWorkbook _ MostRecentPublishedVersion (por exemplo, arquivos c:\publish\Application \ ExcelWorkbook_1_0_0_4).

  3. Assine o manifesto de 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, em seguida, 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 sua 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 .

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

Você pode publicar sua personalização no nível de documento para os usuários finais usando o SharePoint. Quando os usuários acessam o site do SharePoint e abrem o documento, o runtime instala a solução automaticamente da pasta de rede compartilhada no computador local do usuário. Depois que a solução estiver localmente instalada, a personalização continuará funcionando mesmo que o documento seja copiado em qualquer lugar, como na área de trabalho, por exemplo.

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 de uma das abordagens a seguir:

    • 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 dos usuários.

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

    • Assegure-se de que cada usuário execute as etapas a seguir.

      1. No computador local, abra o Word ou o Excel, escolha a guia arquivo e, em seguida, 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 myItems. aspx.

      5. Marque a caixa de seleção as subpastas deste local também são confiáveis e, em seguida, escolha o botão OK .

        Quando os usuários abrem o documento no site do SharePoint, ele é aberto e a personalização é instalada. Os usuários podem copiar o documento na respectiva área de trabalho. A personalização ainda será executada porque as propriedades no 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 lotes para instalar a solução sem interação do usuário. Esses cenários funcionarão melhor se os pré-requisitos já estiverem instalados nos computadores dos usuários finais.

Como parte do processo de instalação personalizada, chame a ferramenta do 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 a 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 localizar o caminho para essa ferramenta.

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

Parâmetro Definição
/Install ou /I Instale a solução. Você deve seguir essa opção com o caminho de um manifesto de implantação. Você pode especificar um caminho no computador local, um compartilhamento de arquivos UNC (Convenção de nomenclatura universal). Você pode especificar um caminho local (C:\FolderName\PublishFolder), um caminho relativo (publicar \) ou um local totalmente qualificado (\ \ServerName\FolderName ou http://ServerName/nome_da_pasta).
/Uninstall ou /U Desinstale a solução. Você deve seguir essa opção com o caminho de um manifesto de implantação. Você pode especificar que um caminho pode estar no computador local, um compartilhamento de arquivos UNC. Você pode especificar um caminho local (c:\FolderName\PublishFolder), um caminho relativo (publicar \) ou um local totalmente qualificado (\ \ServerName\FolderName ou http://ServerName/nome_da_pasta).
/Silent ou /S Instale ou desinstale sem solicitar a interação do usuário ou sem exibição de mensagens. Se for necessário um prompt de confiança, a personalização não será instalada ou atualizada.
/Ajuda ou /? Exiba as informações da Ajuda.

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

Código do Erro Definição
0 A solução foi instalada ou desinstalada com êxito, ou a Ajuda do VSTOInstaller foi exibida.
-100 Uma ou mais opções de linha de comando não são válidas ou foram definidas mais de uma vez. Para obter mais informações, digite "vstoinstaller/?" ou consulte criar um instalador personalizado para uma solução de ClickOnce Office.
-101 Uma ou mais opções de linha de comando não são válidas. Para obter mais informações, insira "vstoinstaller /?".
-200 O URI do manifesto de implantação não é válido. Para obter mais informações, insira "vstoinstaller /?".
-201 Não foi possível instalar a solução porque o manifesto de implantação não é válido. Consulte manifestos de implantação para soluções do Office.
-202 Não foi possível instalar a solução porque a seção Ferramentas do Visual Studio do Office do manifesto do aplicativo não é válida. Consulte manifestos do aplicativo para soluções do Office.
-203 A solução não pôde ser instalada porque ocorreu um erro de download. Verifique o URI ou o local do arquivo de rede do manifesto de implantação e tente novamente.
-300 A solução não pôde ser instalada porque ocorreu uma exceção de segurança. Consulte proteger soluções do Office.
-400 Não foi possível instalar a solução.
-401 Não foi possível desinstalar a solução.
-500 A operação foi cancelada porque a solução não pôde ser instalada ou desinstalada, ou o manifesto de implantação não pôde ser baixado.

Publicar uma atualização

Para atualizar uma solução, você a publica novamente usando o Designer de projeto ou o Assistente de publicação e, em seguida, copia a solução atualizada para o local de instalação. Ao copiar os arquivos no local da instalação, verifique se substituiu 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

É possível adicionar ou alterar o caminho de instalação depois que uma solução é publicada. Talvez seja conveniente alterar o caminho de instalação por um ou mais dos seguintes motivos:

  • O programa de instalação foi compilado antes que o caminho de instalação fosse conhecido.

  • Os arquivos da solução foram copiados em 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, é preciso atualizar o programa de instalação e, em seguida, os usuários devem executá-lo. Para personalização no nível de documento, os usuários também devem atualizar uma propriedade no respectivo documento para que ele aponte para o novo local.

Observação

Se não quiser solicitar que os usuários atualizem suas propriedades de documento, você poderá pedir que os usuários obtenham o documento atualizado do local de instalação.

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

  1. Abra uma janela de prompt de comando e, em seguida, altere os diretórios para a pasta de instalação.

  2. Execute o programa de instalação e inclua o parâmetro /url, 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 que desejar:

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

    Observação

    Se uma mensagem for exibida informando que a assinatura do executável será invalidada, o certificado que foi usado para assinar a solução não é mais válida e o editor é desconhecido. Consequentemente, os usuários precisarão confirmar que confiam na origem da solução para que possam instalá-la.

    Observação

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

    Para personalizações em nível de documento, os usuários devem abrir o documento e, em seguida, 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.

    Guia informações no Excel

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

    Propriedades avançadas no Excel.

  3. Na guia personalizado da lista propriedades , escolha _AssemblyLocation, como mostra a ilustração a seguir.

    A propriedade AssemblyLocation.

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

  4. Antes do identificador, insira o caminho totalmente qualificado do documento, seguido por uma barra, no identificador de caminho de formato | (por exemplo, file://servername/FolderName/filename|74744e4b-e4d6-41eb-84f7-ad20346fe2d9.

    Para obter mais informações sobre como formatar esse identificador, consulte visão geral de propriedades de documento personalizadas.

  5. Escolha o botão OK e, em seguida, 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. Localize a subpasta da versão para a qual deseja fazer a reversão.

  4. Copie o manifesto de implantação dessa subpasta na pasta de publicação 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, substituindo o manifesto de implantação específico da versão por OutlookAddIn1_1_0_0_1 que já estava lá.

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

    Publicar estrutura de pastas

    Da 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 do cache do ClickOnce.

Observação

Os dados locais são salvos para apenas uma versão anterior de uma solução. Se você reverter duas versões, os dados locais não serão mantidos. Para obter mais informações sobre dados locais, consulte acessar dados locais e remotos em aplicativos ClickOnce.

Consulte também