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

Esta seção contém dicas para resolver problemas comuns que você pode encontrar ao implantar soluções do Office.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de nível de aplicativo para Microsoft Office 2010 e o sistema 2007 do Microsoft Office. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Solucionando problemas de soluções do Office usando o Visualizador de eventos

Você pode usar o Visualizador de eventos no Windows para ver as mensagens de erro que são capturadas pelo Visual Studio Tools for Office runtime ao instalar ou desinstalar o Office solutions. Você pode usar essas mensagens do agente de log de eventos para solucionar problemas de implantação e de instalação. For more information, see Log de eventos para soluções do Office.

Alterar o nome do Assembly, ocasionará conflitos

Se você alterar o Nome do Assembly o valor a aplicativo página da Project Designer depois que você já implantou uma solução, as ferramentas de publicação irá modificar o pacote de instalação para que um arquivo de Setup. exe e dois manifestos de implantação. Dois arquivos de manifesto de implantação pode causar as seguintes condições:

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

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

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

Verificando as atualizações leva muito tempo

Visual Studio 2010 Tools for Office RuntimeFornece uma entrada de registro que permite aos administradores 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 até a seguinte chave:

    HKEY_CURRENT_USER\Software\Microsoft\VSTA

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

    Se a AddInTimeout subchave não existir, crie-o 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 Setup. exe da solução é bloqueado em um processo, enquanto a atualização está sendo publicada. A mensagem pode dizer o seguinte: "Não é possível adicionar 'Setup. exe' na 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 estará somente leitura para os usuários finais.

Pré-requisitos para Microsoft Office não estão instalados.

Você pode adicionar o Microsoft.NET Framework, o Visual Studio Tools for Office runtimee os Microsoft Office de assemblies de interoperabilidade primária para o seu pacote de instalação como pré-requisitos são implantados com sua solução do Office. Para obter informações sobre como instalar assemblies de interoperabilidade primária, consulte Configurando um computador para desenvolver soluções do Office e Como: Instalar Assemblies de interoperabilidade primária do Office.

Publicar usando 'localhost' Pode causar problemas de instalação

Quando você usa "https://localhost" como o local de instalação ou publicar para soluções de nível de documento, o Assistente de publicação não converte a seqüência de caracteres para o nome do computador real. Isso significa que a solução só pode ser instalada no computador de desenvolvimento. Para tornar soluções implantadas para usar o IIS no computador de desenvolvimento, use o nome totalmente qualificado para todos os locais de HTTPS/HTTP/FTP, em vez de localhost.

Cache de Assemblies É carregados em vez de conjuntos atualizados

Fusão, o.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 de personalização não altera, o carregador do NET Framework assembly, carrega a cópia em cache de assemblies. Se você atualizar um assembly que atende a essas condições, você não verá a atualização 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 a fusão baixar conjuntos toda vez que o projeto for executado.

Para fazer o download de módulos (assemblies) em vez de carregar cópias em cache

  1. Sobre o projeto menu, clique em ProjectName Propriedades.

  2. Sobre o aplicativo página, clique em Informações de Assembly.

  3. No primeiro Versão do Assembly , digite um asterisco (*).

  4. Click OK.

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

Esquemas XML no nível do documento personalizações não são registrados.

Se você anexar um esquema XML a um documento em um projeto de nível de documento para o sistema de Microsoft Office de 2007, o esquema não está registrado na biblioteca do usuário. Você deve criar um arquivo do instalador separado para fazer isso. For more information, see Esquemas XML e dados no nível do documento personalizações.

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 de HTTPS/HTTP/FTP, o caminho não pode ter quaisquer caracteres Unicode que não estão em US-ASCII. Tais caracteres podem causar um comportamento inconsistente no programa de instalação. Use caracteres US-ASCII para o caminho de instalação.

Para desinstalar manualmente aparece quando você publicar e instalar uma solução no computador de desenvolvimento

Quando você cria uma solução Office, a versão interna é registrada automaticamente. Se você tiver publicado anteriormente e instalada no computador de desenvolvimento, a mesma solução Visual Studio Tools for Office runtime detecta que o caminho de instalação para a versão publicada e a versão interna são diferentes após a próxima compilação, reconstruir ou publicar. A mensagem de erro que afirma "a personalização não pode ser instalada porque outra versão instalada atualmente e não pode ser atualizado a partir deste local." Como a solução de reconstrução atualiza as chaves do registro, é necessário desinstalar a primeira versão antes de publicar, depuração ou executando a versão de segunda.

Para evitar que a mensagem apareça, crie outra conta de usuário no computador de desenvolvimento para testar sua implantação. Como alternativa, desinstale a versão da lista de programas instalados no computador antes de Avançar publicar, depurar ou recrie a solução.

Não capturada exceção método não encontrado ou erro quando você instala uma solução

Quando você instala o Office solutions abrindo o manifesto de implantação (um arquivo de .vsto), aplicativos de escritório, documento ou pasta de trabalho, você pode ver as mensagens de erro para as seguintes condições:

  • Método não encontrado.

  • MissingMethodException.

  • Exceção não identificada.

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 verificar ou instalar os pré-requisitos. O programa de instalação verifica a versão correta dos pré-requisitos e instala-los conforme necessário.

O manifesto de chaves do registro para alteração de suplementos após a criação de um projeto de instalação do Windows Installer

A chave de registro de manifesto que faz parte de um programa de instalação do suplemento, às vezes, alterações de .vsto para. dll.manifest quando você constrói o projeto de instalação do Windows Installer.

Para contornar esse problema, crie o projeto de instalação em uma solução diferente ou usar 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 cria a ClickOnce para sua solução do Office, o instalador para a assemblies de interoperabilidade primários (PIAs) do Office é executado somente se não houver nenhum PIAs já instalados.

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

Reinstalando o resultado de soluções do Office em um argumento fora do intervalo de exceção

Ao reinstalar uma solução Office, você poderá ver um ArgumentOutOfRangeException exceção com a seguinte mensagem de erro: Argumento especificado estava fora do intervalo de valores válidos.

Isso ocorre se as maiúsculas e minúsculas para a URL para o local de instalação é diferente. Por exemplo, este erros apareceria se você instalar uma solução Office da https://fabrikam.com/ExcelSolution.vsto da primeira vez e use https://fabrikam.com/excelsolution.vsto pela segunda vez.

Para evitar que a mensagem apareça, use o casing mesmo durante a instalação de soluções do Office.

Consulte também

Conceitos

Solucionando problemas de implantações de ClickOnce

Outros recursos

Implantar soluções do Office