Depuração de soluções do SharePoint

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

• Ativar a depuração

• Depuração de F5 e processo de implantação

• Recursos do projeto do SharePoint

• Fluxos de trabalho de depuração

• Recipientes de recurso de depuração

• Ativando informações de depuração aprimorado

Ativar a depuração

Quando você depura primeiro uma solução do SharePoint em Visual Studio, alertas de uma caixa de diálogo que você o arquivo web.config não está configurado para ativar a depuração.(O arquivo web.config é criado quando você instalar o servidor do SharePoint.Para obter mais informações, consulte Trabalhar com arquivos Web.config.) A caixa de diálogo oferece a você a opção de executar o projeto sem depuração ou modificar o arquivo web.config para ativar a depuração.Se você escolher a primeira opção, o projeto geralmente executa.Se você escolher a segunda opção, o arquivo web.config é configurado:

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

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

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

O arquivo web.config resultante maneira:

<?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 a seguir XML no arquivo web.config:

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

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

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

Depuração de F5 e processo de implantação

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

1. Executar comandos personalizáveis de pré-compilação implantação.

2. Cria um arquivo de pacote de solução da Web (.wsp) usando comandos de MSBuild .o arquivo de .wsp inclui todos os arquivos e recursos necessários.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 pool de aplicativos de IIS para o site URLespecificada.Esta etapa libera os arquivos com barreira pelo processo de trabalho de IIS .

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

5. Instalar a versão atual dos recursos e arquivos no arquivo de .wsp.Essa etapa e adicionar a solução instalado no servidor do SharePoint.

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

7. Alterna o recurso de projeto no SharePoint se o escopo é ou site Web.Os recursos em escopos de farm e de WebApplication não são ativados.

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

   Observação
   Essa associação ocorre apenas se você selecionou Automaticamente fluxo de trabalho do associado no assistente.

9. Executar comandos personalizáveis de pré implantação.

10. Anexe o depurador de Visual Studio o processo de Windows SharePoint Services (w3wp.exe). Se o tipo de projeto permite que você altere a propriedade de Sandboxed Solution e seu valor é definido como true, então o depurador é anexado 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 Javascript se a solução do SharePoint é uma solução de farm.

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

Visual Studio exibe uma mensagem de status na janela de saída após cada tarefa é concluída.Se uma tarefa não pode ser concluída, Visual Studio exibe uma mensagem de erro na janela de error list.

Recursos do projeto do SharePoint

Um recurso é uma unidade portátil e modular de funcionalidades que simplifica a alteração de sites usando definições do site.Também é um conjunto de elementos de Windows SharePoint Services (WSS) que podem ser ativados para um escopo específico e que ajudam aos usuários fazer um objetivo ou uma tarefa específica.os modelos são implantados como recursos.

Quando você executa um projeto no modo de depuração, o processo de implantação cria uma pasta no diretório recurso em %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES.Os nomes de recurso têm o _Featurexde nome do projetode formato, como TestProject_Feature1.

A pasta de solução no diretório de recursos contém um arquivo de definição de recurso e um arquivo de definição de fluxo de trabalho .O arquivo de definição do recurso (Feature.xml) descreve os arquivos no arquivo de definição do projeto de Feature.O arquivo de definição de projeto (Elements.xml) descreve o modelo de projeto.Elements.xml pode ser encontrado em Gerenciador de Soluções, 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.

Fluxos de trabalho de depuração

Quando você depura projetos de fluxo de trabalho, Visual Studio adiciona o modelo de fluxo de trabalho (dependendo do tipo) a uma biblioteca ou a uma lista.Você pode então iniciar o modelo de fluxo de trabalho manualmente ou adicionar ou atualizar um item.Você pode usar Visual Studio para depurar o fluxo de trabalho.

Observação
Se você adicionar referências a outros módulos (assemblies), certifique-se de que os assemblies que estã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, Iniciar manualmente um fluxo de trabalho em um documento ou em um itemconsulte.

Em o entanto, o processo de implantação não inicia o fluxo de trabalho.Você deve iniciar o fluxo de trabalho do site da web do SharePoint.Você também pode iniciar o fluxo de trabalho usando um aplicativo cliente como o Microsoft Office Word 2010, ou usando o código separado do servidor.Use uma das abordagens especificadas em Assistente de personalização do SharePoint.

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

Recipientes de recurso de depuração

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

Para desativar a ativação automática de recursos no SharePoint e permite a depuração apropriada de destinatários de recurso, defina o valor da propriedade de Configuração ativa de implantação de projeto a nenhuma ativação antes de depuração.Em seguida, depois que você inicia para depurar seu aplicativo do SharePoint em Visual Studio, alterne manualmente o recurso no SharePoint.Para ativar o recurso, abra o menu de Ações do Site no SharePoint, escolha Configurações do Site, escolha o link de Gerenciar recursos do site , e então escolha o botão de Ativar ao lado do recurso, para continuar a depuração como normal.

Ativando informações de depuração aprimorado

Devido às interações às vezes complexas entre o processo de devenv.exe Visual Studio (), o processo host de Visual Studio o SharePoint vssphost4.exe (), o SharePoint, e a camada WCF, diagnosticando erros que ocorrem durante a compilação, implantando, e assim por diante pode ser um desafio.Para ajudar a resolver esses erros, você pode ativar informações de depuração avançada.Para fazer isso, vá para a próxima chave do Registro no Registro do Windows:

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

Se o valor de “EnableDiagnostics” REG_DWORD ainda não existir, criar manualmente.Defina o valor “EnableDiagnostics” a “1 ".

Definir esse valor para 1 principal faz com que as informações de rastreamento de pilha pareça na janela de Saída sempre que os erros de sistema do projeto ocorrem quando você executar em Visual Studio.Para desativar informações de depuração aprimorado, defina EnableDiagnostics de volta para 0, ou exclui o valor.

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

Consulte também

Conceitos

Solucionando problemas de soluções do SharePoint