Le Débogueur Android

Si vous développez des applications Java exécutées sur des appareils ou des émulateurs Android, vous pouvez également les déboguer. Les machines locales et distantes peuvent être sur une plate-forme 32 bits ou une plate-forme 64 bits.

Deployment diagram for debugging an application in Sparx Systems Enterprise Architect.

Exigences du système

Sur la machine distante, ce logiciel est requis :

SDK Android, qui inclut le pont de débogage Android, ADB (vous devez être familiarisé avec le SDK et ses outils)
JDK Java (prise en support 32 et 64 bits)
Logiciel de transfert de port (tiers)

Sur la machine locale, ce logiciel est requis :

Enterprise Architect Version 10 ou supérieure

Paramètres de script de l'analyseur

Champ/Bouton	Action	Voir également
Débogueur	Cliquez sur la flèche déroulante et sélectionnez Java (JDWP).
Exécuter	Cliquez sur ce bouton radio.
Répertoire par défaut	Sans objet - laissez vide.
Chemin de candidature	Sans objet - laissez vide.
Arguments de la ligne de commande	Sans objet - laissez vide.
Construire d'abord	Sans objet - laissez vide.
Afficher la console	Sans objet - laissez vide.
Afficher les messages de diagnostic	Sans objet - laissez vide.
Lien	Sans objet - laissez vide.
Port	Il s'agit du port d'application, attribué en avant à l'aide d'adb ou d'autres moyens, par lequel Enterprise Architect et la Virtual Machine Android (VM) peuvent communiquer.	Le Débogueur Android
Héberger	Ordinateur hôte (localhost par défaut) Si Android s'exécute sur un émulateur sur un appareil connecté à un ordinateur en réseau, entrez le nom du réseau ici. Par défaut, le débogage tentera de se connecter au port que vous spécifiez sur la machine locale.
La source	C'est l'équivalent source du paramètre classpath en Java. La racine de chaque arborescence source doit être répertoriée. Si plusieurs sont spécifiés, ils doivent être séparés par un point-virgule ; C'est: c:\myapp\src;c:\myserver\src Vous devez spécifier au moins un chemin source racine. Lorsqu'un point d'arrêt se produit, le débogueur recherche la source Java dans chacune des arborescences de sources répertoriées ici.
Enregistrement	Permet de consigner des informations supplémentaires à partir du débogueur valeurs possibles : vrai, faux, 1,0, oui, non
Production	Spécifie le nom complet du fichier log local à écrire. Le dossier doit exister sinon aucun log ne sera créé. Le fichier log contient généralement un vidage des octets envoyés entre le débogueur et la VM.
Plateforme	Si vous déboguez Java en cours d'exécution sous n'importe quel scénario Android, sélectionnez Android. Pour tous les autres scénarios, sélectionnez Java.

Configurer les ports pour le débogage - Transfert de port (local)

Le débogueur ne peut déboguer qu'une seule machine virtuelle à la fois ; il utilise un seul port pour communiquer avec la machine virtuelle. Le port de l'application à déboguer peut être attribué à l'aide d'ADB, qui est fourni avec le SDK Android.

Avant le débogage, démarrez l'application une fois dans l'appareil. Lorsque l'application démarre, découvrez son identifiant de processus (pid) :

adb jdwp

Le dernier numéro indiqué est le pid de la dernière application lancée ; note le pid et utilisez-le pour permettre au débogueur de se connecter à la VM :

adb transférer tcp:port jdwp:pid
- port = numéro de port répertorié dans le script de l'analyseur
- pid = identifiant de processus de l'application sur l'appareil

Configurer les ports pour le débogage - Redirection de port (à distance)

Pour déboguer à distance, la même procédure doit être suivie que pour la machine locale, mais la communication nécessite un transfert supplémentaire car le socket créé à l'aide de la commande adb forward n'écoutera que sur l'adaptateur local. Le socket est lié à l'hôte local et les tentatives de connexion à ce port se heurteront à des messages "connexion refusée".

Afin de réaliser le débogage à distance, il est nécessaire d'avoir un proxy en cours d'exécution sur la machine distante qui écoute toutes les connexions entrantes et transfère tout le trafic vers le port adb ; il existe de nombreux produits logiciels disponibles pour ce faire.

Le débogage à distance avec Enterprise Architect ne fonctionnera que si vous avez configuré un redirecteur de port proxy.