Solucionando problemas de implantação de solução do Office

Este tópico contém informações sobre como solucionar problemas comuns que você pode encontrar quando você implantar soluções do Office.

Aplicáve a: As informações neste tópico se aplicam a projetos em nível de aplicativo e em nível de documento para o Office 2013 e o Office 2010. Consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Soluções do Office de solução de problemas usando o visualizador de eventos

Você pode usar o visualizador de eventos no Windows para ver as mensagens de erro que são detectadas por Visual Studio Tools for Office Runtime quando você instala ou desinstala soluções do Office.Você pode usar essas mensagens de registador de evento para resolver problemas de instalação e implantação.Para obter mais informações, consulte Log de eventos para soluções do Office.

Altere o nome do assembly causa conflitos

Se você alterar o valor de Nome do Assembly na página de Aplicativo de Designer de Projeto após você ter implantado já uma solução, as ferramentas de publicação alterado o pacote de configuração para ter um arquivo Setup.exe e dois manifestos de implantação.Se você implantar os arquivos de manifesto, as seguintes condições podem ocorrer:

  • Se o usuário final instala ambas as versões, o aplicativo será carregado os suplementos.

  • Se o suplemento foi instalado antes que o nome do assembly esteve alterado, o usuário final nunca recebeu atualizações.

Para evitar essas condições, não altere o valor de Nome do Assembly da solução após a implantação de solução.

Verificar se há atualizações levar um longo tempo

O 2010 Visual Studio Tools for Office Runtime fornece uma entrada de Registro que os administradores podem usar para definir o valor de tempo limite para baixar os manifestos e a solução. 

Para definir o valor de tempo limite

  1. No Registro, navegue para a próxima chave:

    HKEY_CURRENT_USER\Software\Microsoft\VSTA

  2. Subkey de AddInTimeout , defina o valor de tempo limite em milissegundos.

    Se a subchave de AddInTimeout não existir, crie-a como um DWORD.

Não pode atualizar ou publicar em um compartilhamento de rede

As soluções do Office que estão em um compartilhamento de rede podem exibir uma mensagem enganosas durante atualizações se o arquivo do Setup.exe de solução é bloqueado em um processo quando a atualização é publicado.A mensagem pode instruir o seguinte: “Não é possível adicionar “setup.exe” a Web.O arquivo “setup.exe” já existe neste Web.”

Para ajudar a evitar bloqueio do arquivo, você pode fazer o compartilhamento somente leitura para os usuários finais.No entanto, se os documentos estão no compartilhamento, também tornar-se-ão somente leitura para os usuários finais.

Os pré-requisitos para Microsoft Office não são instalados

Você pode adicionar o.NET Framework, Visual Studio Tools for Office Runtime, e assemblies de interoperabilidade primários do Office a sua configuração obtém como pré-requisitos que são implantados com sua solução do Office.Para obter informações sobre como instalar assemblies de interoperabilidade primários, consulte Configurando um computador para desenvolver soluções do Office e Como: instalar Assemblies de interoperabilidade primária do Officeinteroperabilidade primários.

Publicar usando “localhost” pode causar problemas de instalação

Quando você usa “https://localhost” como o local de publicação ou de instalação para soluções de um documento nível, Assistente de Publicação não converte a cadeia de caracteres no nome do computador atual.Nesse caso, a solução deve ser instalado no computador de desenvolvimento.Para fazer soluções implantados use o IIS no computador de desenvolvimento, use o nome totalmente qualificado para todos os locais de HTTP/HTTPS/FTP em vez de host local.

Assemblies armazenados em cache são carregados em vez de assemblies atualizados

A fusão, o carregador de assembly do.NET Framework, carrega a cópia armazenada em cache de assemblies quando o caminho de saída do projeto está em um compartilhamento de rede, o assembly é assinados com um nome forte, e a versão do assembly de personalização não muda.Se você atualiza um assembly que é usar essas condições, a atualização não aparecerá na próxima vez que você executar o projeto como a cópia armazenada em cache é carregada.

Você pode configurar o Visual Studio para que a fusão baixa assemblies toda vez que o projeto é executado.

Para baixar os assemblies em vez de em cache cópias de carregamento

  1. Na barra de menus, escolha Projeto, ProjectNamePropriedades.

  2. Na página de Aplicativo , escolha Informações do Assembly.

  3. Na primeira caixa de Versão do Assembly , digite um asterisco (*), e depois escolha o botão de OK .

Depois que você altera a versão do assembly, você pode continuar a assinar o seu assembly com um nome forte, e a fusão carregará a versão mais recente de personalização.

A instalação falha quando o URI tem caracteres que Are't US-ASCII

Quando você publica uma solução do Office para um local de HTTP/HTTPS/FTP, o caminho não pode ter quaisquer caracteres Unicode que não estão em US-ASCII.Esses caracteres podem causar o comportamento inconsistente no programa de instalação.Use caracteres de US-ASCII para o caminho de instalação.

O aviso como desinstalar manualmente aparece quando você publica e instalar uma solução no computador de desenvolvimento

Quando você cria uma solução do Office, a versão é registrada criado automaticamente.Se você tiver publicado e tem instalado anteriormente a mesma solução para seu computador de desenvolvimento, Visual Studio Tools for Office Runtime detecta que o caminho de instalação para a versão publicado e a versão criado são diferentes após a solução é criado seguir, reconstruído, ou publicado.A mensagem de erro informa que a personalização “não pode ser instalado como outra versão atualmente estiver instalado e não pode ser atualizada desse local.” As chaves do Registro são atualizadas sempre que uma solução é reconstruída.Portanto, você deve desinstalar a versão anterior antes de publicar, depure, ou execute a nova versão.

Para impedir que a mensagem aparece, crie uma outra conta de usuário no seu computador de desenvolvimento para testar sua implantação.Como alternativa, você pode desinstalar a versão da lista dos programas instalados no computador antes que você publique em seguida, depure, ou reconstruir a solução.

Exceção não tratada ou de erro não foi encontrado do método quando você instalar uma solução

Quando você instala soluções do Office abrindo o manifesto de implantação (um arquivo de .vsto), o aplicativo do Office, documento, ou pasta de trabalho, as mensagens de erro para as seguintes condições podem aparecer:

  • Método não encontrado.

  • MissingMethodException.

  • De exceção não tratada.

Para evitar essas mensagens de erro, instalar a solução executando o programa de instalação.

Quando você instala a solução sem executar o programa de instalação, o instalador não verifica ou não instala pré-requisitos.O programa de instalação para a versão correta dos pré-requisitos e instalá-los conforme necessário.

As chaves do Registro de manifesto para a alteração suplementos após uma edição limitada Projeto de InstallShield são compiladas

A chave de Registro de manifesto que é parte de um programa de instalação do suplemento alterações em vez de .vsto a .dll.manifest quando você cria um projeto de edição limitada de InstallShield.

Para resolver esse problema, crie o projeto de edição limitada de InstallShield em uma solução diferente, ou use CompanyName.AddinName como o valor da chave do Registro que contém o nome do suplemento.

O instalador de ClickOnce para sua solução do Office não instala os assemblies de Interoperabilidade primários

Quando você executa o programa de instalação que cria ClickOnce para sua solução do Office, o instalador para assemblies de interoperabilidade primários (PIAs) do Office executa somente se nenhum PIAs já está instalado.

Se o programa de instalação não instala os PIAs corretamente, instalá-los manualmente executando o arquivo installer que é chamado o2007pia.msi o diretório de instalação.

Reinstale soluções do Office causa um argumento fora do intervalo de exceção

Quando você reinstala uma solução do Office, uma exceção de ArgumentOutOfRangeException pode aparecer com a seguinte mensagem de erro: O argumento foi especificado fora do escopo dos valores válidos.

Essa situação ocorre se a caixa para o URL para o local de instalação é diferente.Por exemplo, esse erro apareceria se você instalou uma solução https://fabrikam.com/ExcelSolution.vsto do Office usou https://fabrikam.com/excelsolution.vsto a primeira vez e na segunda vez.

Para impedir que a mensagem aparece, use a mesma uso quando você instala soluções do Office.

Não pode instalar uma solução de ClickOnce abrindo o manifesto de implantação da Web

Os usuários podem instalar soluções do Office abrindo o manifesto de implantação da Web.No entanto, alguns instalações de Serviços de Informações da Internet) bloco a extensão de nome de arquivo .vsto.Você deve definir tipos MIME no IIS antes de usá-las para implantar uma solução do Office.

Para obter informações sobre como definir MIME digitar no IIS 6, consulte Configurar tipos MIME (IIS 6.0).

Para obter informações sobre como definir MIME digitar no IIS 7, consulte Adicione um tipo MIME (IIS7)..

Definir a extensão para .vsto e o tipo de MIME para application/x-ms-vsto.

Consulte também

Conceitos

Solucionando problemas de implantações de ClickOnce

Outros recursos

Implantando uma solução do Office