Depurador

O termo depurador (debugger) vem do termo bug. Um bug em um método é um erro que você quer eliminar. Quando ocorre um erro, ou quando você precisa monitorar a execução de seus métodos, você pode usar o depurador. Um depurador ajuda você a encontrar bugs, permitindo-lhe percorrer lentamente os seus métodos e analisar informações sobre o método. Esse processo passo-a-passo através de métodos é chamado de depuração.

Você pode fazer com que a janela do depurador exibia e, em seguida, trace os métodos das seguintes maneiras:

• Clicando no botão Depurar na Janela de erro de sintaxe
• Usando o comando TRACE
• Clicando no botão de depuração na janela execução de método.
• Pressionando Alt + Shift + botão direito do mouse (Windows) ou Control + Option + Comando +  clique (Macintosh) enquanto um método está executando, em seguida, selecionando o processo a ser rastreado no menu pop-up:

• Clicar no botão Depurar quando um processo é selecionado na página do Processo do Explorador de execução.
• Criando ou editando um break point na janela do editor de métodos, ou nas páginas de Quebra e Captura do Explorador de execução.

Nota: se existe um sistema de senha para o banco de dados, somente o designer e os usuários pertencentes ao grupo que tem privilégios de acesso ao design podem traçar métodos.

A janela do depurador é exibida aqui:

Você pode mover a janela de depuração e / ou redimensionar qualquer um dos seus painéis internos, conforme necessário. Exibir uma nova janela de depuração usa a mesma configuração (tamanho e posição da janela, colocação das linhas de divisão e conteúdo da área que avalia as expressões) como a última janela exibida na mesma sessão.

4D é um ambiente multi-tasking. Se você executar vários processos de usuário, você pode rastreá-los independentemente. Você pode ter uma janela de depurador aberta para cada processo.

Nove botões estão localizados na barra de controle de execução na parte superior da janela Debugger:

O rastreamento é interrompido e a execução recomeça normalmente com o método.

Nota: Shift + F5 ou Shift + clique no botão Sem Trace reinicia a execução. Ele também desativa todos os vestígios da chamadas subseqüentes para o processo atual..

O método é interrompido, e você volta para onde estava antes de começar a executar o método. Se você estava traçando um formulário ou a execução de um método de objeto, em resposta a um evento, ele é interrompido e volta para o formulário. Se você estava traçando um método de execução de dentro do ambiente do aplicativo, você retorna para o ambiente que estava.

O método é interrompido, como se você clicasse em Abortar. Além disso, 4D abre uma janela do Editor de método para o método que estava sendo executado no momento em que o botão Abortar e Editar foi clicado.

Conselho: Utilize este botão quando você souber que são necessárias alterações no código e quando estas mudanças forem necessárias para o exercício de análise dos seus métodos. Depois de terminar com as alterações, execute o método.

Clicando no botão Editar faz o mesmo que clicar no botão Abortar e Editar, mas não aborta a execução atual. O método de execução é interrompido nesse ponto. 4D abre uma janela do Editor de método para o método que estava sendo executado no momento que o botão Editar foi clicado.

Importante: Você pode modificar este método, no entanto, estas alterações não vão aparecer ou serem executados na instância do método a ser seguido na janela do depurador. Depois que o método foi interrompido ou completado com sucesso, as alterações aparecerão na próxima execução do método. Em outras palavras, o método deve ser recarregado assim suas modificações serão levadas em consideração.

Conselho: Utilize este botão quando você sabe que são necessárias alterações no código e quando elas não interferem no resto do código a ser executado ou rastreado.

Conselho: Métodos de Objeto são recarregados para cada evento. Se você estiver rastreando um método de objeto (ou seja, em resposta a um clique de botão), você não precisa deixar o formulário. Você pode editar o método de objeto, salvar as alterações, em seguida, voltar ao formulário e tentar novamente. Para rastrear/alterar os métodos de formulário, você deve sair do formulário e reabri-lo para recarregar o método do formulário. Ao fazer a depuração de uma forma ampla, um truque é colocar o código (que você está depurando) para um método de projeto que você usa como sub-rotina a partir de um método formulário. Ao fazê-lo, você pode ficar no formulário enquanto você depura, edita e testa novamente o formulário, porque a sub-rotina é recarregada a cada vez que é chamado pelo método do formulário.

Salva a configuração atual da janela de depuração (tamanho e posição da janela, colocando uma das linhas de divisão e conteúdo da área que avalia as expressões), de modo que ela será usado por padrão cada vez que o banco de dados for aberto. Esses parâmetros são armazenados no arquivo de estrutura do banco de dados.

A linha atual do método (a indicada pela seta amarela - chamada contador de programa) é executada, e o passo do depurador salta para a próxima linha. O botão Botão Executar Passo a Passo não entra em sub-rotinas e funções, fica ao nível do método que você está rastreando. Se você quiser também pode rastrear chamadas a sub-rotinas e funções, utilize o botão Executar e entrar.

Na execução de uma linha que chama outro método (subrotina ou função), este botão faz com que a janela do depurador mostre o método que está sendo chamado e lhe permita passar por esse método. O novo método torna-se o método (top) atual no da janela do depurador. Na execução de uma linha que não chama um outro método, este botão age da mesma forma como o botão Executar e Entrar.

Na execução de uma linha que cria um novo processo (ou seja, chamando o comando New process), este botão abre uma janela de novo depurador que permite traçar o método do processo recém-criado. Na execução de uma linha que não cria um novo processo, este botão age da mesma forma como o botão Executar passo a passo.

Se você está traçado sub-rotinas e funções, clicando neste botão permite executar todo o método a ser seguido para voltar para o método chamador. A janela do depurador é trazida de volta para o método anterior na cadeia de chamada. Se o método atual é o último método na cadeia de chamada, a janela do depurador será fechada.

No lado direito da barra de ferramentas de controle de execução, o depurador fornece as seguintes informações:

• O nome do método que você está traçado (exibido em preto)
• O problema que causou o aparecimento da janela Debugger (exibido em vermelho)

Usando a janela de exemplo mostrada acima, as seguintes informações são exibidas:

• O método DE_DebugDemo é o método que está sendo rastreado.
• A janela do depurador apareceu porque ele detectou uma chamada para o comando C_DATE e esse comando foi um dos comandos a serem capturados.

Aqui estão as razões possíveis para o depurador aparecer e para a mensagem (exibida em vermelho):

• Comando TRACE: Uma chamada para TRACE foi emitida.
• Ponto de interrupção atingido: um ponto de interrupção foi encontrado.
• Interrupção do usuário: Você usou Alt + Shift + clique com o botão direito (Windows) ou Control + Comando + Option + clique (Macintosh), ou você clicou no botão de rastreamento na página Processo do Explorador de execução.
• Captura de uma chamada a Nome do comando: Uma chamada a um comando 4D para ser capturado está a ponto de ser executada.
•  Passo a passo em novo processo: Você usou o botão Entrar no processo e esta mensagem é exibida na janela do depurador aberto para o processo recém-criado.

A janela do depurador consiste na barra de ferramentas de controle de execução descrita anteriormente e quatro painéis redimensionáveis: