Implantando uma solução do Office usando o ClickOnce

Você pode implantar sua solução de Office 2013 ou de Office 2010 em menos etapas se você usar ClickOnce.Se você publicar atualizações, sua solução e instalar automaticamente detectar-as-&z -- &z.No entanto, o ClickOnce requer que você instale sua solução separada para cada usuário de um computador.Como consequência, você deve considerar usar Windows Installer (.msi) se mais de um usuário executará sua solução no mesmo computador.

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

Neste tópico

  • Publicar a solução

  • Decida como você deseja conceder a relação à solução

  • Help users install the solution

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

  • Coloque o documento de uma solução em um servidor que esteja executando o SharePoint (personalizações da nível somente)

  • Criar um instalador personalizado

  • Publish an update

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

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

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

Publicar a solução

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

Para publicar a solução

  1. Em Gerenciador de Soluções, escolha o nó que é chamado para seu projeto.

  2. Na barra de menu, escolha Projeto, ProjectName Propriedades.

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

    Na guia publish do Project Designer

  4. Na caixa de Local da Pasta de Publicação (site, servidor FTP ou caminho do arquivo) , digite o caminho da pasta onde você deseja Designer de Projeto para copiar os arquivos de solução.

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

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

    • UM URL (por exemplo, https://www.contoso.com/mySolution/).

    • Um caminho de (UNC) convenção de nomeclatura de uniforme para uma pasta em sua rede (por exemplo, \ \ \ FolderName ServerName).

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

  5. Na caixa de URL da Pasta de Instalação , digite o caminho totalmente qualificado do local onde os usuários finais localizarão sua solução.

    Se você não souber o local ainda não, digite algo neste campo.Por padrão, o ClickOnce procurar atualizações na pasta de que os usuários instalar a solução.

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

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

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

    Por exemplo, se sua solução tem como alvo .NET Framework 4.5, marque as caixas de seleção para Windows Installer 4.5 e Microsoft .NET Framework 4.5 Completo.

  9. Se sua solução destino do .NET Framework 4.5, também selecione a caixa de seleção de Visual Studio 2010 Tools for Office Runtime .

    ObservaçãoObservação

    Por padrão, esta caixa de seleção não aparece.Para exibir esta caixa de seleção, você deve criar um pacote Bootstrapper de.Consulte Criando um pacote Bootstrapper de para um suplemento ao Office 2013 VSTO com Visual Studio 2012.

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

    A tabela a seguir descreve cada opção.

    Opção

    Descrição

    Baixe pré-requisitos do site do fornecedor do componente

    O usuário for solicitado para baixar e instalar esses pré-requisitos do fornecedor.

    Baixe pré-requisitos do mesmo local que meu aplicativo

    O software de pré-requisito é instalado com a solução.Se você escolher essa opção, o Visual Studio copia todos os pacotes de pré-requisito para o local de publicação para você.Esta opção para que funcione, pacotes necessários devem estar no computador de desenvolvimento.

    Pré-requisitos de download de seguinte local

    O Visual Studio copia todos os pacotes de pré-requisito para o local que você especificar e instalá-los com a solução.

    Consulte Caixa de diálogo de pré-requisitos.

  11. Escolha o botão de Atualizações , geralmente você deseja especificar como o suplemento ou personalização de cada usuário final para verificar se há atualizações, e então escolha o botão de OK .

    ObservaçãoObservação

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

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

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

  13. Escolha o botão de Publicar Agora .

    O Visual Studio adiciona as seguintes pastas e arquivos na pasta de publicação que você especificou anteriormente neste procedimento.

    • A pasta de 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 de Arquivos do Aplicativo contém uma subpasta para cada versão que você publica.Cada subpasta de versão específica contém os seguintes arquivos.

    • Um manifesto de aplicativo.

    • Um manifesto de implantação.

    • Assemblies de personalização.

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

    Publicar estrutura de pastas

    ObservaçãoObservação

    ClickOnce acrescenta a extensão de .deploy aos conjuntos de modo que uma instalação protegida de Serviços de Informações da Internet (IIS) não bloqueie os arquivos devido a uma extensão não seguro.Quando o usuário instala a solução, ClickOnce remove a extensão de .deploy.

  14. Copiar os arquivos de solução para o local de instalação que você especificou anteriormente neste procedimento.

Decida como você deseja conceder a relação à solução

Antes que uma solução pode executar em computadores de usuário, você deve concedê-lo confiança ou usuários devem responder a um aviso de confiança quando instalar a solução.Para conceder a relação à solução, assinar os manifestos usando um certificado que identifica conhecido e um fornecedor confiável.Consulte Confiar na solução assinar os manifestos de aplicativo e implantação.

Se você estiver implantando um nível da personalização e você deseja colocar o documento em uma pasta no computador do usuário ou para fazer o documento disponível em um site da web do SharePoint, certifique-se de que o Office confie o local do documento.Consulte Concedendo confiança aos documentos.

Os usuários da ajuda 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 no caso de uma personalização da nível de usuário, abrindo o documento diretamente.Como prática recomendada, os usuários devem instalar sua solução usando o programa de instalação.Outras duas abordagens não se asseguram de que o software de pré-requisito está instalado.Se os usuários desejam abrir o documento do local de instalação, deve adicioná-la à lista de locais confiáveis no centro de confiança de aplicativo do Office.

Bb772100.collapse_all(pt-br,VS.110).gifAbrindo o documento de uma personalização da nível

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

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

Bb772100.collapse_all(pt-br,VS.110).gifInstalando a solução abrindo a implantação manifesto de um site da web do IIS

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

Para adicionar o .vsto MIME digite ao IIS 6.0

  1. No servidor que está executando o IIS 6.0, escolha Iniciar, Todos os Programas, Ferramentas administrativas, Gerenciador de Serviços de Informações da Internet (IIS).

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

  3. Na barra de menu, escolha Ação, Propriedades.

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

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

  6. Na janela de Tipo MIME , entre em .vsto como a extensão, entre em application/x-ms-vsto como o tipo MIME, e então aplicar as novas configurações.

    ObservaçãoObservação

    Para que as alterações tenham efeito, você deve reiniciar o serviço ou a espera de publicação do World Wide Web para que o processo de trabalho recicle-se.Você deve liberar no cache de disco do navegador e depois tentar abrir o arquivo novamente de .vsto.

Para adicionar o .vsto MIME digite 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 Prompt de comando, e então escolha Executar como administrador.

  3. Na caixa de Abrir , digite o seguinte caminho, e então escolha o botão de OK .

    %windir%\system32\inetsrv 
    
  4. Digite o seguinte comando, e então aplicar as novas configurações.

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

    Para que as alterações tenham efeito, você deve reiniciar o serviço de publicação do World Wide Web, você deve esperar que o processo de trabalho para reciclagem.Você deve liberar no cache de disco do navegador e depois tentar abrir o arquivo novamente de .vsto.

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

Você pode copiar o documento de sua solução no computador do usuário final para eles criando uma ação de pré implantação.Dessa forma, o usuário não precisa copiar o documento do local de instalação para seu computador depois de instalar a solução.Você precisará criar uma classe que define a ação de pré implantação, compilação e publique a solução, alterar o manifesto do aplicativo, e novamente o sinal o manifesto do aplicativo e de implantação.

Os procedimentos seguintes assumem que o nome do projeto é ExcelWorkbook e que você publica a solução ao diretório de C:\publish no seu computador.

Bb772100.collapse_all(pt-br,VS.110).gifCrie uma classe que define a ação de pré implantação

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

  2. Na caixa de diálogo de Adicionar novo projeto , Modelos Instalados no painel de, escolha a pasta de Janelas .

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

  4. No campo de Nome , entre em FileCopyPDA, e então escolha o botão de OK .

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

  6. Na barra de menus, escolha Projeto, Adicionar Referência.

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

  8. Renomeie a classe para FileCopyPDAe em seguida, substitua o conteúdo do arquivo com o código.Esse código executa as seguintes tarefas:

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

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

    • Exclui o arquivo se o usuário desinstala 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;
                }
            }
    

Bb772100.collapse_all(pt-br,VS.110).gifCriar e publicar a solução

  1. Em Gerenciador de Soluções, abra o menu de atalho para o projeto de FileCopyPDA , e então escolha Compilar.

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

  3. Abra o menu de atalho para o projeto de ExcelWorkbook , e então escolha Adicionar Referência.

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

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

  6. Na barra de menu, escolha Projeto, Nova Pasta.

  7. Insira dados, e escolha a tecla ENTER.

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

  9. Na barra de menu, escolha Projeto, Adicionar item existente.

  10. Na caixa de diálogo de Adicionar item existente , vá para o diretório de saída para o projeto de ExcelWorkbook , escolha o arquivo de ExcelWorkbook.xlsx , e então escolha o botão de Adicionar .

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

  12. Na janela de Propriedades , altere a propriedade de Ação de Compilação para Conteúdo e a propriedade de Copiar para Diretório de Saída para Copiar se mais recente.

    Quando você tiver terminado essas etapas, o projeto será semelhante a ilustração a seguir.

    Estrutura do projeto da ação de implantação do post.

  13. Publicar o projeto de ExcelWorkbook .

Bb772100.collapse_all(pt-br,VS.110).gifModifique o manifesto do aplicativo

  1. Abra o diretório de c:\publish usando Explorador de Arquivos.

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

  3. Abra o arquivo de ExcelWorkbook.dll.manifest em um editor de texto como o Bloco De Notas.

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

Bb772100.collapse_all(pt-br,VS.110).gifNovamente assinar os manifestos de aplicativo e implantação

  1. Na pasta de %USERPROFILE% \ documents \ Visual Studio 2012 \ projects \ \ ExcelWorkbook ExcelWorkbook , copie o arquivo de certificado de ExcelWorkbook_TemporaryKey.pfx , e cole-o na pasta de PublishFolder \ \ ExcelWorkbook arquivos de aplicativoMostRecentPublishedVersion .

  2. Abrir o prompt de comando do Visual Studio em seguida, altere diretórios à pasta arquivos de c:\publish\Application \ ExcelWorkbookMostRecentPublishedVersion (por exemplo, arquivos de c:\publish\Application \ ExcelWorkbook_1_0_0_4).

  3. Assinar alterado o manifesto do aplicativo execute o seguinte comando:

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

    A mensagem “ExcelWorkbook.dll.manifest assinados com êxito” aparece.

  4. Vá para a pasta de c:\publish , e então atualizar-se e assinar-se 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çãoObservação

    No exemplo anterior, substitua MostRecentVersionNumber com o número de versão de lançamento recentemente publicado de sua solução (por exemplo, 1_0_0_4).

    A mensagem “ExcelWorkbook.vsto assinados com êxito” aparece.

  5. Copie o arquivo de ExcelWorkbook.vsto para o diretório arquivos de c:\publish\Application \ ExcelWorkbookMostRecentVersionNumber .

Coloque o documento de uma solução em um servidor que esteja executando o SharePoint (personalizações da nível somente)

Você pode publicar sua personalização da nível aos usuários finais usando o SharePoint.Quando os usuários vão para o site do SharePoint e abre o documento, o tempo de execução instala automaticamente a solução da pasta compartilhada de rede para o computador local do usuário.Após a solução é instalada localmente, personalização ainda funcionará mesmo se o documento é copiado em outro lugar, como a área de trabalho.

Para colocar o documento em um servidor que esteja executando o SharePoint

  1. Adicione o documento de solução a uma biblioteca de documentos em um site da web 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 para o centro de confiança em Word ou do excel em todos os computadores de usuário.

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

    • Certifique-se de que cada usuário execute as seguintes etapas.

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

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

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

      4. Na caixa de Caminho , digite a URL de 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 ou AllItems.aspx default.aspx.

      5. Selecione a caixa de seleção de As subpastas deste local também são confiáveis , e então escolha o botão de OK .

        Quando os usuários abra o documento de site web do SharePoint, o documento abre, e a personalização está instalado.Os usuários podem copiar o documento para a área de trabalho.A personalização ainda será executado como propriedades no ponto de documento 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 que é criado para você quando você publica a solução.Por exemplo, você pode usar um script de logon para iniciar a instalação, ou você pode usar um arquivo em lotes para instalar a solução sem interação do usuário.Esses cenários funcionam melhor se os pré-requisitos estiverem instalados em computadores de usuário final.

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

compartilhado de %commonprogramfiles% \ microsoft \ VSTO \ 10,0 \ VSTOInstaller.exe

Se a ferramenta não está naquele local, você pode usar a chave de Registro de HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath para localizar o caminho para a ferramenta.

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

Parâmetro

Definição

/Install ou /I

Instalar a solução.Você deve seguir esta opção com o caminho para um manifesto de implantação.Você pode especificar um caminho no computador local, um compartilhamento de (UNC) convenção de nomenclatura universal de, ou em um site de HTTP/HTTPS.Você pode especificar um caminho local (C:\FolderName\PublishFolder), um caminho relativo (Publicar \), ou um local totalmente qualificado (\ \ \ FolderName ServerName ou https://ServerName/FolderName).

/Uninstall ou /U

Desinstalar a solução.Você deve seguir esta opção com o caminho para um manifesto de implantação.Você pode especificar um caminho pode estar no computador local, um compartilhamento de UNC, ou em um site de HTTP/HTTPS.Você pode especificar um caminho local (c:\FolderName\PublishFolder), um caminho relativo (Publicar \), ou um local totalmente qualificado (\ \ \ FolderName ServerName ou https://ServerName/FolderName).

/Silent ou /S

Instalando ou desinstalar sem avisar o usuário para a entrada ou exibir as mensagens.Se um aviso de confiança é necessário, a personalização não está instalado ou não é atualizada.

ou de /Help/?

Exibir informações de ajuda.

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

Código de erro

Definição

0

A solução com êxito foi instalada ou desinstalada, ou a ajuda de VSTOInstaller exibida.

-100

Uma ou mais opções de linha de comando não são válidas foram definidas ou mais de uma vez.Para obter mais informações, entre o “vstoinstaller/?” consulte ou Criando um instalador personalizado para uma solução Office ClickOnce.

-101

Uma ou mais opções de linha de comando não são válidos.Para obter mais informações, entre o “vstoinstaller/?”.

-200

O URI de manifesto de implantação não é válido.Para obter mais informações, entre o “vstoinstaller/?”.

-201

A solução não pode ser instalado como o manifesto de implantação não é válido.Consulte Manifestos de implantação de soluções do Office.

-202

A solução não pode ser instalado como o Visual Studio para a seção do Office manifesto do aplicativo não é válido.Consulte Manifestos de aplicativo para soluções do Office.

-203

A solução não pode ser instalado como um download de erro ocorreu.Verifique o local do arquivo ou URI de rede do manifesto de implantação, e tente novamente.

-300

A solução não pode ser instalado como uma exceção de segurança ocorreu.Consulte Protegendo soluções do Office.

-400

A solução não pôde ser instalado.

-401

A solução não pôde ser desinstalada.

-500

A operação foi cancelado porque a solução não pode ser instalado ou desinstalado ou o manifesto de implantação não pode ser baixado.

Publicar uma atualização

Para atualizar uma solução, você publique-o novamente usando Designer de Projeto ou Assistente de Publicaçãoe em seguida, você copia a solução atualizado para o local de instalação.Quando você copiar os arquivos para o local de instalação, certifique-se que você substitui os arquivos anteriores.

Na próxima vez que a solução verifica uma atualização, localiza 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 uma solução é publicado.Você pode desejar modificar o caminho de instalação para uma ou mais das seguintes razões:

  • O programa de instalação foi criado antes que o caminho de instalação esteve conhecido.

  • Os arquivos de solução forem copiados para um local diferente.

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

Para modificar o caminho de instalação de uma solução, você deve atualizar o programa de instalação, e então os usuários devem executá-lo.Para personalizações da nível, os usuários devem também atualizar uma propriedade no seu documento para apontar para o novo local.

ObservaçãoObservação

Se você não deseja recuperar os usuários atualizem suas propriedades de documento, você pode solicitar que os usuários obtenham o documento atualizada do local de instalação.

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

  1. Abra uma janela de Prompt de comando em seguida, altere diretórios à pasta de instalação.

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

    O exemplo a seguir mostra como modificar o caminho de instalação para um local no site de Fabrikam, mas você pode substituir essa URL com o caminho que você deseja:

    setup.exe /url="http://www.fabrikam.com/newlocation"
    
    ObservaçãoObservação

    Se uma mensagem aparece e indica que a assinatura do executável será invalidada, o certificado que foi usado para assinar a solução não é mais válido, e o editor é conhecido.Como resultado, os usuários precisarão confirmar que contam com a fonte da solução antes que eles a instalação.

    ObservaçãoObservação

    Para exibir o valor atual de URL, setup.exe /urlexecução.

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

Para atualizar a propriedade de _AssemblyLocation em um documento

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

    Guia de informações no Excel

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

    Propriedades avançadas no Excel.

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

    A propriedade AssemblyLocation.

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

  4. Antes do identificador, digite 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 este identificador, consulte Visão geral sobre propriedades de documento personalizado.

  5. Escolha o botão de OK , e então salve e feche o documento.

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

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

Quando você reverter uma solução, você reverter usuários de volta para uma versão anterior dessa solução.

Para reverter uma solução

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

  2. No nível superior de publicar a pasta, exclusões o manifesto de implantação (o arquivo de .vsto).

  3. Localize a subpasta para a versão que você deseja reverter.

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

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

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

    Publicar estrutura de pastas

    Na próxima vez que um usuário abre o aplicativo ou documento personalizado, modificando o manifesto de implantação é detectada.A versão anterior de solução do Office executa de cache de ClickOnce.

ObservaçãoObservação

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

Consulte também

Outros recursos

Implantando uma solução do Office

Implantando uma solução do Office usando o ClickOnce

Como: publica uma solução do Office, usando o ClickOnce

Como: instalar uma solução Office ClickOnce

Como: publica uma solução em nível de documento do Office em um servidor do SharePoint usando ClickOnce

Criando um instalador personalizado para uma solução Office ClickOnce