Solução de problemas de empacotamento do SharePoint e implantação
Este tópico aborda os diversos problemas que você pode encontrar ao empacotar e implantar soluções do SharePoint.
Este tópico contém as seguintes seções.
- Habilitando avançado para depuração
- Adicionando a saída do projeto para o pacote de solução
- Erros e avisos de validação
- Resolução de conflitos de implantação
- Diferenças entre a implantação de F5
- Atrasar a exibição de página do SharePoint ao implantar o Visual Web Part
- SharePoint projeto implantação falha com erro "Falha ao extrair o arquivo cab da solução"
- Erro aparece quando a implantação de uma Web Part Visual a um Site em um aplicativo da Web diferente
- Aviso aparecerá quando a implantação de controles de usuário aninhados
- Tópicos relacionados
Habilitando avançado para depuração
Para diagnosticar entre Visual Studio, SharePoint e outras camadas, você pode usar a chave de registro EnableDiagnostics para exibir o rastreamento de pilha. Para obter mais informações, consulte Depuração de soluções do SharePoint.
Adicionando a saída do projeto para o pacote de solução
Você pode adicionar a saída do projeto para um pacote através do Designer do pacote. No entanto, quando você adiciona a saída do projeto, certifique-se de que a plataforma do projeto corresponde a plataforma de solução do SharePoint. Recomendamos que você use o Qualquer CPU destino de plataforma para os assemblies que você deseja implantar em um servidor do SharePoint. Para obter mais informações, consulte Avançado da caixa de diálogo Configurações do compilador (Visual Basic)ou Compilação de página, Designer de projeto c (#).
Erros e avisos de validação
As ferramentas de desenvolvimento do SharePoint no Visual Studio executam etapas de validação para verificar que o pacote de solução é formado corretamente. Você também pode criar as etapas de validação personalizada para seus pacotes e recursos. Para obter mais informações, consulte Como: Criar regras de validação de pacote e de recurso de personalizar soluções do SharePoint.
Resolução de conflitos de implantação
Quando você implanta uma solução do SharePoint, você pode descobrir colisões quando um item no servidor tem o mesmo nome, URL ou identificação como um item em seu pacote de solução. Você pode alterar o Resolução de conflitos de implantação propriedade para resolver, relatório ou ignorar a colisões de módulos, Web parts, instâncias da lista e tipos de conteúdo.
A tabela a seguir demonstra as configurações para o Resolução de conflitos de implantação propriedade.
Valor |
Descrição |
|---|---|
Automático |
Detecta colisões e resolve os conflitos automaticamente. |
Prompt |
Detecta colisões e emite relatórios para o desenvolvedor antes de resolver os conflitos. |
Nenhum |
Não detecta colisões. |
Diferenças entre a implantação de F5
Quando você usa Visual Studio para implantar o projeto do SharePoint para o servidor local do SharePoint para testar e depurar, existem algumas etapas adicionais que são executadas por Visual Studio.
Redefina o serviço de informações da Internet (IIS) durante a etapa de implantação.
Associe automaticamente os fluxos de trabalho.
Defina a ordem de ativação do recurso de acordo com a hierarquia no Designer de pacote.
Você pode adicionar etapas de implantação personalizada para alterar o comportamento de F5. Para obter mais informações, consulte Demonstra Passo a passo: A criação de uma etapa de implantação personalizado para projetos do SharePoint.
Atrasar a exibição de página do SharePoint ao implantar o Visual Web Part
A página do SharePoint é demorada apareça ao implantar uma parte do Visual Web para a pasta Bin em Windows Vista ou Windows Server 2008. Se você alterar os arquivos em um nível superior ASP.NET diretório, como o diretório Bin, todo Web aplicativo recompilações. Isso pode causar um atraso de até 25 segundos para a página do SharePoint para processar.
Mensagem de erro
Nenhum.
Resolução
Para contornar esse problema, execute as seguintes etapas:
Instalar o hotfix QFE KB967535 conforme descrito no artigo de suporte da Microsoft Corrigir: Um hotfix está disponível para corrigir os dois problemas no ASP.NET no IIS 7.0 para Windows Vista e Windows Server 2008.
Adicione a seguinte linha no arquivo Web. config:
<compilation batch="false" optimizeCompilations="true">
SharePoint projeto implantação falha com erro "Falha ao extrair o arquivo cab da solução"
Se o nome de qualquer item de projeto do SharePoint contém parênteses, sua solução falha em implantação de um erro.
Mensagem de erro
Ocorreu um erro na etapa de implantação Add Solution: Falha ao extrair o arquivo cab da solução.
Resolução
Para contornar esse problema, remova todos os parênteses nos nomes dos itens de projeto do SharePoint.
Erro aparece quando a implantação de uma Web Part Visual a um Site em um aplicativo da Web diferente
Na primeira vez que você implante uma Web part visual a um site em um aplicativo da Web diferente no qual ele é atualmente implantado (alterando a propriedade do visual Web part SiteUrl), você obterá um erro.
Mensagem de erro
Ocorreu um erro na etapa de implantação Add Solution: Um recurso com ID [#] já foi instalado neste farm. Use o atributo de força para explicitamente reinstalá-lo.
Resolução
Este erro ocorre devido à maneira de recursos do visual Web Parts são cancelados no SharePoint. Para implantar com êxito a visual Web part, implante a solução novamente pressionando F5.
Aviso aparecerá quando a implantação de controles de usuário aninhados
Este aviso ocorre quando você implanta uma solução do SharePoint que possui controles de usuário aninhados, como, por exemplo, 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. Este aviso ocorre se você adicionar um controle para um designer arrastando-o na caixa de ferramentas ou usando a diretiva @ Register no modo de exibição de origem.
Mensagem de erro
Aviso 1 elemento ' Control Name]' não é um elemento de conhecidos. Isso pode ocorrer se houver um erro de compilação no site da Web ou o arquivo Web. config está ausente.
Resolução
Se o Visual Studio o sistema de projeto não reconhece um controle de usuário aninhados, ele não pode fornecer o Intellisense e emite o aviso. O sistema de projeto é um controle de usuário aninhados não sabem se o projeto não é criado e o designer não é fechado e reaberto, ou se a retração do auto opção estiver ativada, que faz com que o controle de usuário deve ser cancelada da seção SharePoint após a depuração.
Para remover este aviso, construir o projeto e, em seguida, feche e reabra o designer ou desativar a opção para o projeto de retração automática. Para fazer isso, desmarque o de Auto-retração após a depuração caixa de seleção a SharePoint guia da caixa de diálogo de propriedades do projeto.