Compartilhar via

Depuração de soluções do SharePoint

  • Artigo

Você pode depurar soluções do SharePoint usando o Visual Studio depurador. Quando você inicia a depuração, Visual Studio implanta os arquivos de projeto para o servidor do SharePoint e abre uma instância do site do SharePoint no navegador da Web. As seções a seguir explicam como depurar aplicativos do SharePoint no Visual Studio.

  • Ativar depuração

  • O processo de implantação e de depuração F5

  • Recursos de projeto do SharePoint

  • Depuração de fluxos de trabalho

  • Receptores de evento do recurso de depuração.

  • Permitindo que as informações de depuração avançadas

Ativar depuração

Quando você depurar uma solução do SharePoint no primeiro Visual Studio, uma caixa de diálogo alerta que o arquivo Web. config não está configurado para habilitar a depuração. (O arquivo Web. config é criado quando você instala o SharePoint server. Para obter mais informações, consulte Trabalhando com arquivos Web. config.) A caixa de diálogo oferece a opção de executar o projeto sem depuração ou modificar o arquivo Web. config para habilitar a depuração. Se você selecionar a primeira opção, o projeto é executada normalmente. Se você selecionar a segunda opção, o arquivo Web. config é configurado para:

  • Ativar a pilha de chamadas (CallStack="true")

  • Desative erros personalizados em Visual Studio (<customErrors mode="Off" />)

  • Ativar a depuração de compilação (<compilation debug="true">)

O arquivo resultante da Web. config a seguir:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <configuration>
        ...
        <SharePoint>
            <SafeMode MaxControls="200"
                CallStack="true"
                DirectFileDependencies="10"
                TotalFileDependencies="50"
                AllowPageLevelTrace="false">
                ...
            </SafeMode>
        ...
        </SharePoint>
        <system.web>
            ...
            <customErrors mode="Off" />
            ...
            <compilation debug="true">
            ...
            </compilation>
            ...
        </system.web>
        ...
    </configuration>

Para reverter as alterações e desativar a depuração, altere o seguinte XML no arquivo Web. config:

  • Desativar a pilha de chamadas (CallStack="false")

  • Habilitar os erros personalizados em Visual Studio (<customErrors mode="On" />)

  • Desativar a compilação de depuração (<compilation debug="false">)

O processo de implantação e de depuração F5

Quando você executa o projeto do SharePoint no modo de depuração, o processo de implantação do SharePoint executa as seguintes tarefas:

  1. Executa os comandos de pré-implantação personalizáveis.

  2. Cria um arquivo de pacote (. wsp) da solução de Web usando MSBuild comandos. O arquivo. wsp inclui todos os arquivos necessários e recursos. Para obter mais informações, consulte Visão geral das soluções.

  3. Se a solução do SharePoint é uma solução de farm, recicla o IIS o pool de aplicativos para o site especificado URL. Esta etapa libera arquivos bloqueados pela IIS processo do operador.

  4. Se já existir uma versão anterior do pacote, cancela a versão anterior dos recursos e arquivos no arquivo. wsp. Esta etapa desativa os recursos, desinstala o pacote de solução e, em seguida, exclui o pacote da solução no servidor do SharePoint.

  5. Instala a versão atual dos recursos e arquivos no arquivo. wsp. Essa etapa adiciona e instala a solução no servidor do SharePoint.

  6. Para fluxos de trabalho, instala o assembly de fluxo de trabalho. Você pode alterar seu local usando o Assembly Location propriedade.

  7. Ativa o recurso do projeto no SharePoint, se o escopo é o Site ou Web. Recursos do Farm e WebApplication escopos não são ativados.

  8. Para fluxos de trabalho, associa o fluxo de trabalho com a biblioteca do SharePoint, lista ou site que você selecionou no O Assistente para personalização do SharePoint.

    ObservaçãoObservação

    Essa associação ocorre somente se você selecionou associar automaticamente o fluxo de trabalho no assistente.

  9. Executa os comandos de pós-implantação personalizáveis.

  10. Anexa o Visual Studio o depurador para o Windows SharePoint Services processo (w3wp. exe). Se o tipo de projeto permite que você altere a Sandboxed Solution propriedade e seu valor é definido como true, e em seguida, o depurador se anexa a um processo diferente (SPUCWorkerProcess.exe). Para obter mais informações, consulte Considerações sobre a solução no modo seguro.

  11. Inicia o depurador do JavaScript, se a solução do SharePoint é uma solução de farm.

  12. Exibe a página do site, lista ou biblioteca apropriada no navegador da Web.

Visual StudioExibe uma mensagem de status na janela saída após a conclusão de cada tarefa. Se uma tarefa não pode ser concluída, Visual Studio exibe uma mensagem de erro na janela Error List.

Recursos de projeto do SharePoint

Um recurso é uma unidade portátil e modular de funcionalidade que simplifica a modificação de sites usando as definições de site. Também é um pacote de Windows SharePoint Services elementos (WSS), que podem ser ativados para um escopo específico e que ajuda os usuários a realizar uma meta específica ou tarefa. Modelos são implantados como recursos.

Quando você executa um projeto no modo de depuração, o processo de implantação cria uma pasta de recurso diretório na pasta %COMMONPROGRAMFILES%\Microsoft Shared\web extensions\14\TEMPLATE\FEATURES de servidor. Os nomes de recurso tem o formato nome do projeto_Featurex, como, por exemplo, TestProject_Feature1.

A pasta da solução no diretório do recurso contém um definição do recurso arquivo e um a definição de fluxo de trabalho arquivo. O arquivo de definição de recurso (Feature. XML) descreve os arquivos de recurso do project.O arquivo de definição de projeto (elements) descreve o modelo de projeto. Elements pode ser encontrado em Solution Explorer, mas Feature. XML é gerado quando o pacote de solução é criado. Para obter mais informações sobre esses arquivos, consulte Projeto do SharePoint e modelos de Item de projeto.

Depuração de fluxos de trabalho

Quando você depurar projetos de fluxo de trabalho, Visual Studio adiciona o modelo de fluxo de trabalho (dependendo do seu tipo) para uma biblioteca ou lista. Você pode iniciar o modelo de fluxo de trabalho manualmente ou por adicionando ou atualizando um item. Você pode usar Visual Studio para depurar o fluxo de trabalho.

ObservaçãoObservação

Se você adicionar referências para outros assemblies, certifique-se de que esses módulos são instalados no cache global de assemblies (GAC). Caso contrário, a solução de fluxo de trabalho falhará. Para obter informações sobre como instalar assemblies, consulte Iniciar manualmente um fluxo de trabalho em um documento ou item.

No entanto, o processo de implantação não inicia o fluxo de trabalho. Você deve iniciar o fluxo de trabalho do site do SharePoint. Você também pode iniciar o fluxo de trabalho usando um aplicativo de cliente como, por exemplo, Microsoft Office Word 2007 ou usando o código do lado do servidor separado. Use uma das abordagens especificadas no O Assistente para personalização do SharePoint.

Por exemplo, se você especificou que o fluxo de trabalho pode ser iniciado manualmente, inicie o fluxo de trabalho diretamente do item na lista ou biblioteca. Para obter mais informações sobre como iniciar um fluxo de trabalho manualmente, consulte Iniciar manualmente um fluxo de trabalho em um item do documento.

Receptores de evento do recurso de depuração.

Por padrão, quando você executa um Visual Studio aplicativo do SharePoint, seus recursos são ativados automaticamente para você no servidor SharePoint. No entanto, isso causa problemas quando você depurar receptores de evento do recurso, porque quando um recurso é ativado por Visual Studio, ele é executado em um processo diferente do depurador. Isso significa que algumas funcionalidades de depuração, como, por exemplo, pontos de interrupção, não funcionará corretamente.

Para desabilitar a ativação automática do recurso no SharePoint e permitir a depuração adequada de receptores de evento do recurso, defina o valor do projeto Configuração de implantação Active propriedade para Sem ativação antes de depuração. Em seguida, após sua Visual Studio SharePoint executando o aplicativo, ativar manualmente o recurso do SharePoint. Para fazer isso, clique em Configurações do Site na Ações do Site menu no SharePoint, clique no Gerenciar recursos do Site vincular e clique o Activate botão próximo ao recurso e continuar a depuração como normal.

Permitindo que as informações de depuração avançadas

Devido a algumas vezes complexas interações entre o Visual Studio processo (devenv. exe), o Visual Studio (vssphost4.exe) do processo de host do SharePoint, SharePoint e a camada do WCF, diagnosticar erros que ocorrem durante a compilação, implantação, e etc. pode ser um desafio. Para ajudá-lo a resolver esses erros, você pode habilitar as informações de depuração avançadas. Para fazer isso, vá para a seguinte chave do registro no registro do Windows:

[HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\10.0\SharePointTools]

Alterar o "enablediagnostics" valor de chave de "0" em "1".

Definindo o valor de chave para a 1 pilha de causas rastrear informações apareçam na saída janela sempre que ocorrerem de erros de sistema do projeto enquanto você estiver executando em Visual Studio. Para desativar as informações de depuração avançadas, defina EnableDiagnostics para 0.

Para obter mais informações sobre outras chaves de registro do SharePoint, consulte A depuração de extensões para as ferramentas do SharePoint em Visual Studio.

Consulte também

Conceitos

Solucionando problemas de soluções do SharePoint