Solucionar problemas de implantação de solução do Office
Aplica-se a: Visual Studio 2022
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 de nível de documento e projetos de suplemento de Visual Studio Tools para Office (VSTO). Consulte Recursos disponíveis por aplicativo do Office e 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 Visual Studio Tools para Office runtime ao instalar ou desinstalar soluções do Office. Você pode usar essas mensagens do agente de eventos para resolve problemas de instalação e implantação. Para obter mais informações, confira 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 Project Designer 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 VSTO.
- Se o Suplemento VSTO foi instalado antes da alteração do nome do assembly, 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.
Verificar se as atualizações levam muito tempo
O Visual Studio 2010 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.
Como definir o valor de tempo limite
No registro, navegue até a seguinte chave:
HKEY_CURRENT_USER\Software\Microsoft\VSTA
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 arquivo 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 fazer 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 para o Microsoft Office não estão instalados
Você pode adicionar o .NET Framework, o Visual Studio Tools para Office runtime e os assemblies de interoperabilidade primários do Office ao 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 de nível de 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
Fusion, o carregador de assembly .NET Framework, carrega a cópia em cache de assemblies quando o caminho de saída do projeto está em um compartilhamento de arquivo 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 será exibida na próxima vez que você executar o projeto porque a cópia armazenada em cache será 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
- Na barra de menus, selecione Project, <ProjectName> Properties.
- Na página Aplicativo , selecione Informações do Assembly.
- Defina o número de revisão, o terceiro campo, da Versão do Assembly, como um cartão selvagem (*). Por exemplo, "1.0.*". Em seguida, selecione o botão OK .
Depois de alterar a versão do assembly, você pode continuar a assinar seu assembly com um nome forte e o Fusion carregará a versão mais recente da personalização.
Observação
A partir do Visual Studio 2017, se você tentar usar wild cards na Versão do Assembly, ocorrerá um erro de build. Isso ocorre porque os curingas na versão do assembly quebrarão o recurso determinístico MSBuild. Você será instruído a remover os curingas da versão do assembly ou desabilitar o determinismo. Para saber mais sobre o recurso determinístico, confira: Propriedades comuns do projeto MSBuild e Personalizar seu build
Falha na instalação 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 no US-ASCII. Esses caracteres podem causar um comportamento inconsistente no programa de configuração. Use caracteres US-ASCII para o caminho de instalação.
Prompt para desinstalar manualmente é 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 no computador de desenvolvimento, Visual Studio Tools para Office runtime detectará que o caminho de instalação da versão publicada e a versão criada são diferentes depois que a solução for criada, reconstruída ou publicada. A mensagem de erro diz que "a personalização não pode ser instalada porque outra versão está instalada no momento 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, depurar ou executar a nova versão.
Para impedir que a mensagem apareça, crie outra conta de usuário em seu 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 ou método não encontrado quando você instala uma solução
Quando você instala as soluções do Office abrindo o manifesto de implantação (um arquivo .vsto ), 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.
- Exceção uncaught.
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 marcar para ou instala pré-requisitos. O programa de instalação verifica a versão correta dos pré-requisitos e os instala conforme necessário.
As chaves do registro de manifesto para suplementos são alteradas após a criação de um projeto InstallShield Limited Edition
A chave do registro de manifesto que faz parte de um programa de Instalação de Suplementos do VSTO às vezes muda de .vsto para .dll.manifest quando você cria um projeto 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 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ário) do Office é executado somente se nenhum PIAs 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 do 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 inválimento da URL para o local de instalação for diferente. Por exemplo, esse erro seria exibido se você instalasse uma solução do Office da http://fabrikam.com/ExcelSolution.vsto primeira vez e depois usasse http://fabrikam.com/excelsolution.vsto a segunda vez.
Para impedir que a mensagem apareça, use o mesmo invólucro 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 (Internet Information Services) bloqueiam a extensão do nome do 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.