Depuração a partir de máquinas remotas

Visão Geral

Quando um banco de dados 4D está sendo executado no 4D Server em modo interpretado, é possível depurar o código 4D em execução no servidor a partir de um cliente 4D remoto conectado ao projeto. Basta associar o depurador a uma máquina remota específica, e a execução do código pode ser monitorada no depurador diretamente na máquina remota.

En una máquina remota, la ventana de depuración muestra un icono de servidor específico y un color de fondo azul para indicar que está depurando el código servidor:

Esta funcionalidad es especialmente útil cuando 4D Server se ejecuta en modo sin interfaz (ver Command Line Interface), o cuando el acceso a la máquina del servidor no es fácil.

Depurador anexado

Apenas um depurador pode depurar uma aplicação 4D Server num determinado momento. Se llama el depurador asociado. O depurador ligado pode ser:

• o depurador local do Servidor 4D (padrão) - se o servidor não estiver sendo executado sem interface.
• o depurador de um cliente 4D remoto - se a sessão remota tiver acesso ao modo Desenho.
• o depurador Qodly no servidor 4D - se o servidor permitir acesso a Qodly Studio.
• o depurador VS Code, desde que você tenha instalado a extensão 4D-Debugger.

O depurador anexado é chamado sempre que um 4D Server se encontra:

• um ponto de ruptura
• um comando TRACE
• um ponto de interrupção para fazer o pedido
• um erro

Tenga en cuenta que los mensajes de error se envían a la máquina depuradora asociada. Isso significa que, no caso de um depurador remoto, as mensagens de erro do servidor são exibidas no cliente 4D remoto.

Note que:

• The code executed in the On Server Startup Database Method cannot be debugged remotely. Só pode ser depurado no lado do servidor
• Se não estiver ligado um depurador, o código em execução não é interrompido pelos comandos de depuração

Ligar o depurador

Por defeito, quando se inicia uma aplicação interpretada:

• se o 4D Server não estiver funcionando sem interface, o depurador está associado ao servidor,
• se 4D Server funciona sem interface, nenhum depurador está ligado.

Pode anexar o depurador a qualquer cliente 4D remoto autorizado a conectar-se à aplicação 4D Server.

A sessão usuário do cliente 4D remoto deve ter acesso ao ambiente de desenho do banco de dados.

Para anexar o depurador a um cliente 4D remoto:

1. Na barra de menu do 4D Server, selecione Editar > Desativar o depurador para que o depurador se torne disponível para máquinas remotas (essa etapa é inútil se o 4D Server estiver sendo executado sem interface).
2. Em um cliente 4D remoto conectado ao servidor, selecione Executar > Anexar depurador remoto

Se o anexo é aceito (veja solicitações de anexos rejeitadas), o comando do menu torna-se Desconectar o depurador remoto.

O depurador é então ligado ao cliente 4D remoto:

• até ao fim da sessão do usuário
• until you select Detach Remote Debugger

Para ligar o depurador de novo ao servidor:

1. No cliente 4D remoto que tem o depurador conectado, selecione Executar > Desconectar o depurador remoto.
2. Na barra de menu de 4D Server, selecione Editar > Anexar depurador.

Quando o depurador estiver conectado ao servidor (padrão), todos os processos do servidor são executados automaticamente no modo cooperativo para permitir a depuração. Este fato pode ter um impacto significativo no desempenho. Quando não for necessário depurar na máquina do servidor, recomenda-se desconectar o depurador e anexá-lo a uma máquina remota, se necessário.

Anexar o depurador na inicialização

4D permite que você anexe automaticamente o depurador a um cliente 4D remoto ou ao servidor na inicialização:

• No servidor (se não sem cabeçalha), esta opção se chama Anexar depurador na inicialização. Quando o servidor é iniciado, ele anexa automaticamente o depurador (padrão).

Aviso: se essa opção for selecionada para um servidor que será iniciado posteriormente no modo sem cabeça, o depurador não estará disponível para esse servidor.

• Em um cliente remoto 4D, esta opção se chama Anexar depurador remoto na inicialização. Quando selecionado, o cliente 4D remoto tentará automaticamente anexar o depurador remoto em cada conexão subsequente com o mesmo banco de dados do 4D Server. Se o anexo for aceite (veja solicitações de anexo rejeitadas), o depurador remoto é anexado automaticamente ao cliente remoto 4D e a opção Desanexar depurador remoto é exibida.

Essa configuração é aplicada por projeto e é armazenada localmente no arquivo .4DPreferences.

Solicitações de anexos rejeitadas

Enquanto o depurador estiver conectado a um cliente 4D remoto ou ao 4D Server, nenhuma outra máquina poderá se conectar ao depurador.

Se uma máquina tentar anexar o depurador enquanto este já estiver anexado, a anexação é rejeitada e aparece uma caixa de diálogo:

A ligação do depurador neste caso exige que:

• o depurador anexado é desconectado do servidor ou do cliente 4D remoto usando, respectivamente, o comando de menu Detach debugger ou Detach remote debugger,
• a sessão do cliente remoto 4D anexado é encerrada.