Présentation du débogage distant
Remonter à Débogage des applications - Index
- Remarque : Cette rubrique décrit la solution de débogage distant d'ancien style, qui a été remplacée par la nouvelle solution de débogage distant et multi-périphérique. Toutefois, vous pouvez continuer à utiliser le débogueur et les procédures d'ancien style, comme ils sont décrits ici. Si vous souhaitez utiliser la nouvelle solution de débogage en vue de déboguer un processus distant, consultez Débogage des applications multi-périphériques pour obtenir des informations sur la nouvelle solution de débogage distant et multi-périphérique.
Le débogage distant vous permet de déboguer une ou plusieurs applications sur une machine distante quand l'EDI s'exécute seulement sur votre machine locale. Cela permet le débogage sur une machine où il n'est pas possible d'installer l'EDI en entier et de reconstruire un projet. Le débogage distant est utile pour les applications qui s'exécutent de manière différente sur votre machine locale et sur la machine d'un utilisateur final.
- Remarque : Lorsque le débogage s'effectue depuis une machine Windows vers une machine Windows distante, vous obtenez un message d'erreur PAClient indiquant que le fichier ne peut pas être créé car il est utilisé par un autre processus.
- La solution de contournement consiste à déployer votre fichier
<projet>.rsm
sur la machine distante. Pour cela, accédez à Projet > Options > Compilateur Delphi > Liaison et définissez Inclure les symboles de débogage distant sur True.
Sommaire
L'exécutable du débogueur distant
L'exécutable du débogueur distant porte le nom rmtdbg290.exe
. L'exécutable et ses fichiers de support doivent être présents sur la machine distante. Utilisez Platform Assistant pour installer le débogueur distant et les fichiers de débogage. Pour obtenir des instructions, voir paserver, l'application serveur Platform Assistant.
Fichiers locaux et distants
Trois types de fichiers sont impliqués dans le débogage distant :
- Fichiers source
- Fichiers exécutables
- Fichiers de symboles
La compilation des fichiers source utilise l'EDI sur la machine locale. Les fichiers exécutables et les fichiers de symboles produits après la compilation doivent être copiés sur la machine distante.
Fichiers source
Quand vous déboguez un projet sur une machine distante, les fichiers source du projet doivent être ouverts sur la machine locale. Les fichiers source, affichés dans la fenêtre de l'éditeur, montrent le point d'exécution en cours d'un programme. N'utilisez pas les fichiers source sur la machine distante.
Fichiers exécutables
Les fichiers exécutables sont les fichiers .dll et .exe qui sont mappés dans l'espace d'adressage de l'application. Générez-les sur la machine locale, puis copiez-les sur la machine distante.
Fichiers de symboles
Les fichiers de symboles sont générés sur la machine locale au moment de la compilation. Le débogueur les utilise pour obtenir des informations telles que le mappage des instructions machine sur les numéros de ligne source ou les noms et types des variables déclarées dans les fichiers source. Delphi utilise des fichiers RSM, C++ utilise des fichiers TDS.
Configurez les options spécifiques de génération des fichiers de symboles sur la machine locale, puis copiez les fichiers sur la machine distante.
Machines locales et distantes
Pour utiliser le débogage distant, vous devez avoir la possibilité de vous connecter à la machine distante et disposer d'un accès en écriture à au moins un répertoire.
Le débogueur distant ne fournit pas de mécanisme d'interaction avec une application sur la machine distante. Si vous devez interagir avec l'application, établissez une connexion de bureau distant :
- Comment utiliser le Bureau à distance (EN) (Windows 10)
- Aide de l'application de Bureau à distance (EN) (Windows 8)
- Se connecter à un autre ordinateur à l'aide de Connexion Bureau à distance (EN) (Windows 7)
- Bureau à distance Microsoft (EN) (macOS)
Voir aussi
- Débogage distant - Procédures d'ancien style
- Installation d'un débogueur sur une machine distante
- Etablissement d'une connexion pour le débogage distant
- Préparation des fichiers pour le débogage distant
- Installation, démarrage et arrêt du serveur de débogage distant
- Débogage des applications multi-périphériques (nouvelle solution de débogage distant)
- PAServer, l'application serveur Platform Assistant
- Débogage des apps iOS
- Exécution et débogage de votre application Android sur un périphérique Android à distance