Solucionar problemas de implantação da solução do Office

Aplica-se a: Visual Studio

Este artigo apresenta como resolver problemas comuns que você pode encontrar ao implantar soluções do Office.

As informações neste artigo se aplicam a projetos no nível do documento e projetos de suplemento do VSTO (Visual Studio Tools for Office). Confira Recursos disponibilizados pelo aplicativo do Office e pelo tipo de projeto.

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

Você pode usar o visualizador de eventos no Windows para ver mensagens de erro capturadas pelo runtime do Visual Studio Tools for Office ao instalar ou desinstalar soluções do Office. Você pode usar essas mensagens do agente de eventos para resolver problemas de instalação e implantação. Para obter mais informações, consulte Log de eventos para soluções do Office.

Alterar o nome do assembly causa conflitos

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

• Se o usuário final instalar as duas versões, o aplicativo carregará os dois suplementos do VSTO.
• Se o VSTO Add-in tiver sido instalado antes de o nome do assembly ser alterado, o usuário final nunca receberá atualizações.

Para evitar essas condições, não altere o valor do Nome do Assembly da solução depois de implantar a solução.

A verificação de atualizações leva muito tempo

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

Como definir o valor do tempo limite

1. No registro, navegue até a seguinte chave:

   HKEY_CURRENT_USER\Software\Microsoft\VSTA

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

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

Não é possível atualizar ou publicar em um compartilhamento de arquivos de rede

As soluções do Office que estão em um compartilhamento de arquivos de rede podem exibir uma mensagem enganosa durante as atualizações se o arquivo Setup.exe da solução estiver bloqueado em um processo enquanto a atualização estiver sendo publicada. A mensagem pode dizer o seguinte: "Não é possível adicionar 'setup.exe' à Web. O arquivo 'setup.exe' já existe nesta Web."

Para ajudar a evitar o bloqueio de arquivos, você pode tornar o compartilhamento somente leitura para os usuários finais. No entanto, se os documentos estiverem no compartilhamento, eles também se tornarão somente leitura para os usuários finais.

Os pré-requisitos do Microsoft Office não estão instalados

Você pode adicionar o .NET Framework, o tempo de execução das Ferramentas do Visual Studio para Office e os assemblies de interoperabilidade primária do Office ao seu pacote de instalação como pré-requisitos implantados com sua solução do Office. Para obter informações sobre como instalar os assemblies de interoperabilidade primários, consulte Configurar um computador para desenvolver soluções do Office e Como instalar assemblies de interoperabilidade primários do Office.

Publicar usando Localhost pode causar problemas de instalação

Quando você usa http://localhost como local de publicação ou instalação para soluções no nível do documento, o Assistente de Publicação não converte a cadeia de caracteres no nome real do computador. Nesse caso, a solução deve ser instalada no computador de desenvolvimento. Para fazer com que as soluções implantadas usem o IIS no computador de desenvolvimento, use o nome totalmente qualificado para todos os locais HTTP/HTTPS/FTP em vez de localhost.

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

O Fusion, o carregador de assembly do .NET Framework, carrega a cópia armazenada em cache dos assemblies quando o caminho de saída do projeto está em um compartilhamento de arquivos de rede, o assembly é assinado com um nome forte e a versão do assembly da personalização não é alterada. Se você atualizar um assembly que atenda a essas condições, a atualização não aparecerá na próxima vez que você executar o projeto porque a cópia em cache está carregada.

Você pode configurar o Visual Studio para que o Fusion baixe assemblies sempre que o projeto for executado.

Como baixar assemblies em vez de carregar cópias armazenadas em cache

1. Na barra de menus, selecione Projeto, <Propriedades do NomeDoProjeto>.
2. Na página Aplicativo, selecione Informações do Assembly.
3. Defina o número de revisão, terceiro campo, da versão do assembly, como um curinga (*). Por exemplo, "1.0.*". Selecione o botão OK.

Depois de alterar a versão da montagem, você pode continuar a assinar sua montagem com um nome forte, e o Fusion carregará a versão mais recente da personalização.

A instalação falha quando o URI tem caracteres que não são US-ASCII

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

Solicitar a desinstalação manual é exibido quando você publica e instala uma solução no computador de desenvolvimento

Quando você cria uma solução do Office, a versão criada é registrada automaticamente. Se você já publicou e instalou a mesma solução em seu computador de desenvolvimento, o runtime do Visual Studio Tools for Office detectará que o caminho de instalação da versão publicada e da versão compilada são diferentes após a próxima compilação, recompilação ou publicação da solução. A mensagem de erro diz "a personalização não pode ser instalada porque outra versão está instalada no momento e não pode ser atualizada deste local". As chaves do Registro são atualizadas sempre que uma solução é recriada. Portanto, você deve desinstalar a versão anterior antes de publicar, depurar ou executar a nova versão.

Para impedir que a mensagem apareça, crie outra conta de usuário no computador de desenvolvimento para testar sua implantação. Como alternativa, você pode desinstalar a versão da lista de programas instalados no computador antes de publicar, depurar ou recompilar a solução.

Exceção não detectada ou erro de método não encontrado ao instalar uma solução

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

• Método não encontrado.
• MissingMethodException.
• Exceção não detectada.

Para evitar essas mensagens de erro, instale 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 nem instala pré-requisitos. O programa de instalação verifica a versão correta dos pré-requisitos e os instala conforme necessário.

As chaves de registro de manifesto para suplementos são alteradas após a criação de um projeto do InstallShield Limited Edition

A chave do Registro de manifesto que faz parte de um programa de Instalação de Suplemento do VSTO às vezes muda de .vsto para .dll.manifest quando você cria um projeto do InstallShield Limited Edition.

Para contornar esse problema, crie o projeto InstallShield Limited Edition em uma solução diferente ou use CompanyName.AddinName como o valor da chave do Registro que contém o nome do Suplemento do VSTO.

O Instalador do 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 o ClickOnce cria para sua solução do Office, o instalador dos PIAs (assemblies de interoperabilidade primária) do Office é executado somente se nenhum PIA já estiver instalado.

Se o programa de instalação não instalar os PIAs corretamente, instale-os manualmente executando o arquivo do instalador chamado o2007pia.msi no diretório de instalação.

Reinstalar soluções do Office causa uma exceção de argumento fora do intervalo

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

Essa situação ocorrerá se o uso de maiúsculas e minúsculas para a URL do local de instalação for diferente. Por exemplo, esse erro apareceria se você instalasse uma solução do Office pela http://fabrikam.com/ExcelSolution.vsto primeira vez e usasse http://fabrikam.com/excelsolution.vsto a segunda vez.

Para impedir que a mensagem apareça, use o mesmo uso de maiúsculas e minúsculas ao instalar soluções do Office.

Não é possível instalar uma solução 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, algumas instalações do IIS (Serviços de Informações da Internet) bloqueiam a extensão de nome de arquivo .vsto . Você deve definir o tipo MIME no IIS antes de usá-lo para implantar uma solução do Office.

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

Defina a extensão como .vsto e o tipo MIME como application/x-ms-vsto.

Referências

• Solucionar problemas de implantações do ClickOnce
• Implantar uma solução do Office