Solucionar problemas de empacotamento e implantação do SharePoint

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, consulte 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 o destino de plataforma Any CPU para os assemblies que deseja implantar em um servidor do SharePoint. Para obter mais informações, consulte Página Compilar, Designer de Projeto (Visual Basic) e Caixa de diálogo Configurações avançadas do compilador (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ção está 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 regras de validação de pacote e recursos personalizados para soluções do SharePoint.

Resolução de conflitos 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 de um item em seu 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 .

Diferenças entre a implantação do F5

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

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

2. Associe 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: criar uma etapa de implantação personalizada para projetos do SharePoint.

Atrasar a exibição da página do SharePoint ao publicar a Web Part visual

A página do SharePoint leva muito tempo para ser exibida ao implantar uma Web Part Visual na pasta Bin no Windows Vista, Windows 7 ou Windows Server 2008. Se você alterar todos os arquivos em um diretório de ASP.NET de nível superior, como o diretório Bin, todo o aplicativo Web recompile. 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 seguintes etapas:

1. Instale a atualização KB967535 conforme descrito no artigo de Suporte da Microsoft CORREÇÃO: 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 seguinte linha ao arquivo Web.config:

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

Falha na implantação do projeto do SharePoint com o erro "Falha ao extrair o arquivo cab 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 contornar esse problema, remova todos os parênteses nos nomes dos itens de projeto do SharePoint.

O erro aparece ao implantar uma parte visual da Web em um site em um aplicativo Web diferente.

Na primeira vez que você implanta uma Web Part visual em um site em um aplicativo Web diferente daquele no qual ela está implantada no momento (ao alterar a propriedade SiteUrl da Web Part visual), você recebe um erro.

Mensagem de erro

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

Resolução

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

O aviso é exibido ao implantar controles de usuário aninhados

Esse aviso ocorre quando você implanta uma solução do SharePoint que possui controles de usuário aninhados, como uma Web Part visual contendo 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 quando você adiciona um controle a um designer, seja arrastando-o da Toolbox ou usando a diretiva @Register no Modo de Exibição de Fonte.

Mensagem de erro

O elemento de aviso 1 '[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 gerará um aviso. O sistema de projeto desconhece um controle de usuário aninhado se o projeto não for construído 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 de usuário seja retirado do conjunto do SharePoint após a depuração.

Para remover esse aviso, compile o projeto, feche e então 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

• Empacotar e implantar soluções do SharePoint