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 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 comprend le pont de débogage Android, ADB (vous devez être familier avec le SDK et ses outils)
Java JDK ( support 32 et 64 bits)
Logiciel de redirection de port (tiers)

Sur la machine locale, ce logiciel est requis :

Enterprise Architect version 10 ou supérieure

Paramètres du script d'analyse

Champ/Bouton	Action	Voir aussi
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 – laisser vide.
Parcours d'application	Sans objet – laisser vide.
Arguments de la ligne de commande	Sans objet – laisser vide.
Construire d'abord	Sans objet – laisser vide.
Afficher la console	Sans objet – laisser vide.
Afficher les messages de diagnostic	Sans objet – laisser vide.
Connexion	Sans objet – laisser vide.
Port	Il s'agit du port d'application, attribué via adb ou d'autres moyens, via lequel Enterprise Architect et la Virtual Machine Android (VM) peuvent communiquer.	Le Débogueur Android
Hôte	Ordinateur hôte (par défaut, localhost) Si Android s'exécute sur un émulateur sur un appareil connecté à un ordinateur en réseau, saisissez 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.
Source	Il s'agit de l'équivalent source du paramètre classpath en Java. La racine de chaque arbre source doit être répertoriée. Si plusieurs racines sont spécifiées, elles doivent être séparées par un point-virgule, c'est-à-dire : 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 sources répertoriées ici.
Enregistrement	Permet d'enregistrer des informations supplémentaires à partir du débogueur valeurs possibles : vrai, faux, 1, 0, oui, non
Sortir	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 machine virtuelle.
Plate-forme	Si vous déboguez Java exécuté dans 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 - Redirection 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, fourni avec le SDK Android.

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

adb jdwp

Le dernier numéro répertorié 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 une transmission 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 verront confrontées à des messages « connexion refusée ».

Afin de réaliser un débogage à distance, il est nécessaire d'avoir un proxy exécuté sur la machine distante qui écoute toutes les connexions entrantes et transmet tout le trafic au port adb ; de nombreux logiciels sont disponibles pour ce faire.

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