Iniciar seu Trailhead Playground

Objetivos de aprendizagem

Neste projeto, você vai:

Definir pontos de interrupção e pontos de verificação para percorrer o código e inspecionar valores de variável em números de linha específicos em uma sessão de depuração.
Invocar testes do Apex e baixar logs de depuração usando o Visual Studio Code.
Encontrar e corrigir um bug usando o Depurador de reprodução do Apex para Visual Studio Code.

Nota

Deseja aprender em português (Brasil)? Comece o desafio em um Trailhead Playground de português (Brasil) e use as traduções fornecidas entre parênteses para navegar. Copie e cole somente os valores em inglês porque as validações dos desafios dependem de dados em inglês. Se você não passar no desafio em sua organização de português (Brasil), recomendamos que (1) mude o local para os Estados Unidos, (2) mude o idioma para inglês, seguindo as instruções aqui, e (3) clique novamente no botão “Validar o desafio”.

Consulte o emblema Trailhead no seu idioma para saber mais sobre como aproveitar a experiência de Trailhead em outros idiomas.

Introdução

“Qualquer bug não detectado na fase de design exigirá dez vezes mais tempo para detectar na fase de codificação e outras dez vezes mais na fase de depuração.” — Dr. Nikolai Bezroukov, The Art of Debugging

Pesquisa de bugs de software representada por uma lupa sobre uma joaninha

A depuração e o teste são processos relacionados, mas distintos no desenvolvimento de software. O teste tenta localizar e relatar erros. A depuração tenta identificar a causa desses erros e corrigi-los. E, de acordo com o Dr. Nikolai Bezroukov, quando se trata de encontrar e esmagar bugs em seu código, quanto antes melhor.

O Apex dá suporte a testes por meio de uma estrutura completa para a execução isolada de testes do Apex, incluindo organizações que não são de produção, como sandboxes e organizações temporárias. O Apex também dá suporte à depuração por meio da instrução System.debug, logs de depuração e depuradores.

Quando os sinalizadores de rastreamento estiverem ativados, seu código do Apex gera logs de depuração, que são gravações de todas as interações em uma transação. O Depurador de reprodução do Apex simula uma sessão de depuração ativa com o uso de um log de depuração. Ele apresenta as informações registradas em log, inclusive valores de variável, pilha de chamadas e pontos de interrupção, parecido com um depurador interativo, para você poder depurar seu código do Apex.

O que é o Depurador de reprodução do Apex?

O Depurador de reprodução do Apex é uma ferramenta gratuita que permite a você depurar seu código do Apex com a inspeção de logs de depuração usando o Visual Studio Code como cliente. A execução do depurador de reprodução fornece a você os mesmos recursos esperados de outros depuradores. Você pode ver variáveis, definir pontos de interrupção e passar o mouse por cima de variáveis para ver o valor atual. Você não precisa mais analisar milhares de linhas de log manualmente ou polvilhar seu código com instruções System.debug para ver os valores de variável ou acompanhar o caminho de execução do código.

O Depurador de reprodução do Apex também facilita o trabalho assíncrono e a colaboração com outras pessoas para resolver problemas. Como você pode iniciar uma sessão de depuração de reprodução com um log de depuração habilitado para reprodução, os clientes e colegas de trabalho podem compartilhar logs de depuração para ajudar a resolver problemas. Para iniciar uma sessão de depuração, abra um log de depuração no Visual Studio Code e clique com o botão direito do mouse em qualquer linha no arquivo para iniciar o depurador.

Inicialização do Depurador de reprodução do Apex com um log de depuração aberto no Visual Studio Code

O processo de depuração envolve iterar por várias etapas. Edite seu código do Apex, implante o código na sua organização, reproduza o cenário que contém bug, baixe o log de depuração resultante e inicie o Depurador de reprodução do Apex com esse log de depuração.

O log de depuração habilitado para reprodução inclui instruções geradas com nível de log FINER (ÓTIMO) ou FINEST (MELHOR) em logs da categoria Visualforce e FINEST (MELHOR) em logs da categoria Código do Apex. Saiba mais sobre níveis e categorias de log na documentação Níveis de log de depuração.

O que é o Depurador interativo do Apex?

O Depurador interativo do Apex, também incluído no Pacote de extensões do Salesforce, permite que os clientes depurem seu código do Apex em sandboxes e organizações temporárias, em tempo real, usando o Visual Studio Code como cliente.

O Depurador interativo do Apex também vem com recursos para parceiros ISV que trabalhem com assinantes que instalam um pacote gerenciado. Por conta das proteções contra visualização de código gerenciado, os assinantes não conseguem depurar código ISV em suas organizações. Com o Depurador de clientes ISV, um ISV pode trabalhar com um assinante para depurar problemas específicos da organização deste.

Para conhecer os detalhes de preços do Depurador interativo do Apex ou do Depurador de clientes ISV, entre em contato com seu executivo de contas do Salesforce.

Este projeto se concentra em como configurar e usar o Depurador de reprodução do Apex gratuito.

Criar seu Trailhead Playground

Para este projeto, crie um novo Trailhead Playground. Role até à parte inferior desta página, clique na seta para baixo ao lado de Launch (Iniciar) e selecione Create a Trailhead Playground (Criar um Trailhead Playground).

Procurando ajuda?

Descubra mais