Compartilhar via

Solucionar problemas de empacotamento e implantação do SharePoint

  • Artigo

Este tópico aborda vários problemas que você pode encontrar ao empacotar e implantar soluções do SharePoint.

Habilitar a depuração aprimorada

Para diagnosticar entre o Visual Studio, o SharePoint e outras camadas, você pode usar a chave do Registro EnableDiagnostics para exibir o rastreamento de pilha. Para obter mais informações, confira Depurar soluções do SharePoint.

Adicionar saída do projeto ao pacote de solução

Você pode adicionar a saída do projeto a um pacote por meio do Designer de Pacotes. No entanto, ao adicionar a saída do projeto, verifique se a plataforma do projeto corresponde à plataforma da solução do SharePoint. Recomendamos que você use a plataforma de destino Qualquer CPU para os assemblies que deseja implantar em um servidor do SharePoint. Para obter mais informações, consulte Página de Compilação, Designer de Projeto (Visual Basic) e Caixa de diálogo Configurações de Compilador Avançadas (Visual Basic).

Avisos e erros de validação

As ferramentas de desenvolvimento do SharePoint no Visual Studio executam etapas de validação para verificar se o pacote de soluções é formado corretamente. Você também pode criar etapas de validação personalizadas para seus recursos e pacotes. Para obter mais informações, consulte Como criar um recurso personalizado e regras de validação de pacote para soluções do SharePoint.

Resolução do conflito de implantação

Ao implantar uma solução do SharePoint, você poderá encontrar colisões quando um item no servidor tiver o mesmo nome, URL ou ID que um item no pacote de solução. Você pode alterar a propriedade Resolução de Conflitos de Implantação para resolver, relatar ou ignorar colisões para módulos, Web Parts, instâncias de lista e tipos de conteúdo.

A tabela a seguir demonstra as configurações da propriedade Resolução de Conflitos de Implantação.

Valor Descrição
Automático Detecta colisões e resolve os conflitos automaticamente.
Prompt Detecta colisões e as relata ao desenvolvedor antes de resolver os conflitos.
Nenhum Não detecta colisões.

Diferenças entre a implantação de F5

Quando você usa o Visual Studio para implantar seu projeto do SharePoint no servidor local do SharePoint para teste e depuração, algumas etapas adicionais são executadas pelo Visual Studio.

  1. Redefina o IIS (Serviço de Informações da Internet) durante a etapa de implantação.

  2. Associar fluxos de trabalho automaticamente.

  3. Defina a ordem de ativação do recurso de acordo com a hierarquia no Designer de Pacotes.

    Você pode adicionar etapas de implantação personalizadas para alterar ainda mais o comportamento do F5. Para obter mais informações, consulte Passo a passo de como criar uma etapa de implantação personalizada para projetos do SharePoint.

Atraso ao exibir a página do SharePoint ao implantar a Web Part visual

A página do SharePoint leva muito tempo para aparecer ao implantar uma Web Part visual na pasta Bin no Windows Vista, Windows 7 ou Windows Server 2008. Se você alterar arquivos em um diretório de ASP.NET de nível superior, como o diretório Bin, todo o aplicativo Web será recompilado. Isso pode causar um atraso de até 25 segundos para a página do SharePoint ser renderizada.

Mensagem de erro

Nenhum.

Resolução

Para contornar esse problema, execute as etapas a seguir:

  1. Instale a atualização KB967535 conforme descrito no artigo Suporte da Microsoft FIX: um hotfix está disponível para corrigir dois problemas no ASP.NET no IIS 7.0 para Windows Vista e Windows Server 2008.

  2. Adicione a linha a seguir ao arquivo Web.config:

    <compilation batch="false" optimizeCompilations="true">

Falha na implantação do projeto do SharePoint com o erro "Falha na extração do arquivo de gabinete na solução"

Se o nome de qualquer item de projeto do SharePoint contiver parênteses, sua solução falhará na implantação com um erro.

Mensagem de erro

Erro na etapa de implantação "Adicionar Solução": falha ao extrair o arquivo Cab na solução.

Resolução

Para solucionar esse problema, remova os parênteses nos nomes dos itens de projeto do SharePoint.

Erro aparece ao implantar uma Web Part visual em um site em um aplicativo Web diferente

Na primeira vez que você implantar uma Web Part visual em um site em um aplicativo Web diferente daquele no qual ele está implantado no momento (alterando a propriedade SiteUrl da Web Part visual), você receberá um erro.

Mensagem de erro

Erro na etapa de implantação "Adicionar Solução": um recurso com a ID [#] já foi instalado neste farm. Use o atributo force para reinstalar explicitamente o recurso.

Resolução

Esse erro ocorre devido à forma como os recursos de Web Part visuais são retraídos no SharePoint. Para implantar a Web Part visual com êxito, implante a solução novamente escolhendo a chave F5.

Aviso exibido ao implantar controles de usuário aninhados

Esse aviso ocorre quando você implanta uma solução do SharePoint que tem controles de usuário aninhados, como uma Web Part visual que contém um controle de usuário ou um controle de usuário que contém uma Web Part visual ou outro controle de usuário. Esse aviso ocorre se você adicionar um controle a um designer arrastando-o da Caixa de Ferramentas ou usando a diretiva @Register no modo de exibição Origem.

Mensagem de erro

Aviso 1 O elemento "[Nome do Controle]" não é um elemento conhecido. Isso pode ocorrer se houver um erro de compilação no site ou se o arquivo web.config estiver ausente.

Resolução

Se o sistema de projetos do Visual Studio não estiver ciente de um controle de usuário aninhado, ele não poderá fornecer o IntelliSense e emitirá o aviso. O sistema de projeto desconhece um controle de usuário aninhado se o projeto não for criado e o designer não for fechado e reaberto ou se a opção de retração automática estiver habilitada, o que fará com que o controle do usuário seja retirado do hive do SharePoint após a depuração.

Para remover esse aviso, compile o projeto e feche e reabra o designer ou desabilite a opção de retração automática para o projeto. Para fazer isso, desmarque a caixa de seleção Retrair automaticamente após a depuração na guia SharePoint da caixa de diálogo de propriedades do projeto.

Conteúdo relacionado