Activer les journaux de consignation pour les débogueurs RAD Studio

Remonter à Débogage des applications - Index

Les journaux des débogueurs aident à diagnostiquer et comprendre les comportements inattendus pendant le débogage, par exemple isoler des bogues dans le débogueur lui-même.

Ces journaux sont activés en définissant des variables d'environnement, mais il existe différents débogueurs pour différentes plates-formes. Cela signifie que différentes variables d'environnement doivent être définies pour générer les journaux en fonction de la plate-forme.

Pour générer les journaux, suivez ces étapes :

1. Quittez l'EDI (et PAServer si vous effectuez un débogage distant).
2. Supprimez au préalable tous les journaux existants (afin que nous ayons seulement un ensemble de journaux qui représentent le problème).
3. Définissez toutes les variables d'environnement comme spécifié ci-dessous, qui s'appliquent à la plate-forme (assurez-vous que tous les répertoires de sortie spécifiés existent et sont en écriture).
4. Lancez l'EDI (et PAServer si vous effectuez un débogage distant).
5. Exécutez le débogueur et faites uniquement ce qui est nécessaire pour reproduire le bogue.
6. Quittez l'EDI (et PAServer si vous effectuez un débogage distant).
7. Collectez tous les journaux du débogueur générés et attachez-les au rapport de bogue ou à la demande de support.

Notes:

• Tous les répertoires de sortie spécifiés dans les paramètres doivent exister avant de lancer l'EDI (et/ou PAServer si vous effectuez un débogage distant).
• Vous devez disposer des droits d'accès en écriture aux répertoires de sortie spécifiés dans les paramètres (le cas échéant), en particulier pour Windows 10 et macOS.
• Vous devrez peut-être quitter l'EDI avant de pouvoir consulter les journaux (en fonction de la plate-forme).

Journaux DBK

Journaux DBK hébergés par Windows (Win32 & Win64)

Remarque: Le débogueur DBK utilisé pour Win32 est pris en charge pour Delphi et C++, et Win64 est seulement pris en charge pour Delphi. Pour le débogage Win64 C++, veuillez consulter la section LLDB ci-dessous.

Pour obtenir les journaux du débogueur sur une machine Windows :

1. Lancez bds.exe
2. Ouvrez Outils>Options>EDI>Variables d'environnement
3. Dans Redéfinitions système utilisateur, cliquez sur Nouveau... pour ajouter les paires nom/valeur suivantes pour les variables d'environnement :
   1. DBK_DEBUG all
   2. DBK_DEBUG_OUTDIR d:\MyLogsDirectory

Pour désactiver les journaux du débogueur dans la session de débogage suivante :

1. Ouvrez Outils>Options>EDI>Variables d'environnement
2. Sélectionnez la variable DBK_DEBUG et cliquez sur Supprimer
3. Sélectionnez la variable DBK_DEBUG_OUTDIR et cliquez sur Supprimer

Pour chaque exécution du débogueur :

• Sur Win32, vous trouverez des journaux DBK nommés dbk_<pid1>.log (pour le serveur de débogage) et dbk_<pid2>_N.log (pour le débogueur) dans MyLogDirectory.
• Sur Win64, vous trouverez des journaux DBK nommés dbk_<pid1>.log (pour le pilote hébergé par Win32), dbk_<pid2>.log (pour le serveur de débogage) et dbk_<pid3>_N.log (pour le débogueur) dans MyLogsDirectory.

Conseil: Si le débogueur ne démarre pas, essayez d'exécuter l'EDI en tant qu'administrateur et vérifiez si les fichiers journaux ont été écrits dans le répertoire bin bds.

Journaux LLDB

Journaux LLDB hébergés par Windows (Win64, Android32 et Android64)

Remarque: Android32 et Android64 sont pris en charge pour Delphi et C++, tandis que Win64 est seulement pris en charge pour C++.

Pour obtenir les journaux du débogueur sur une machine Windows :

1. Lancez bds.exe
2. Ouvrez Outils>Options>EDI>Variables d'environnement
3. Dans Redéfinitions système utilisateur, cliquez sur Nouveau... pour ajouter les paires nom/valeur suivantes pour les variables d'environnement :
   1. GDB_DEBUG 1
   2. GDB_OUTDIR d:\MyLogsDirectory

Pour désactiver les journaux LLDB dans la session de débogage suivante :

1. Ouvrez Outils>Options>EDI>Variables d'environnement
2. Sélectionnez la variable GDB_DEBUG et cliquez sur Supprimer
3. Sélectionnez la variable GDB_OUTDIR et cliquez sur Supprimer

Pour chaque exécution du débogueur, vous trouverez le(s) journal(aux) de l'EDI nommé(s) gdb_<pid>.log dans MyLogsDirectory si GDB_OUTDIR est définie. Si elle n'est pas définie, les journaux seront placés dans le répertoire bin bds.

Journaux LLDB hébergés par macOS (iOS64, simulateur iOS ARM64, macOS 64 et macOS ARM64)

Pour obtenir les journaux du débogueur sur une machine Mac, commencez par ouvrir une fenêtre Terminal. Allez dans le répertoire où PAServer est installé. Tapez la commande suivante :

export GDB_DEBUG=1
export GDB_OUTDIR=~/MyLogDirectory
./paserver

Vous trouverez le(s) journal(aux) de l'EDI nommé(s) lldb_<pid>.log dans MyLogsDirectory si GDB_OUTDIR est définie. Si elle n'est pas définie, les journaux seront placés dans le même répertoire que le binaire paserver.

Problèmes connus et solutions

Si l'EDI ne peut pas démarrer une session de débogage pour une application Delphi sur une plate-forme Windows 64 bits en raison du conflit de port, procédez comme suit :

Pour définir cette variable DBK_DEBUG_PORT :

1. Ouvrez Outils>Options>EDI>Variables d'environnement
2. Dans Redéfinitions système utilisateur, cliquez sur Nouveau... pour ajouter les paires nom/valeur suivantes pour les variables d'environnement :
   1. DBK_DEBUG_PORT 12345
3. Relancez l'EDI

L'application Delphi pour la session de débogage sur la plate-forme Windows 64 bits utilisera ce nouveau numéro de port. Pour revenir au numéro par défaut, supprimez cette variable nouvellement ajoutée, puis relancez l'EDI.