Suivez ces étapes pour configurer Tradefed à l'aide d'Eclipse.
Créez un espace de travail séparé pour développer Trade Federation, ne réutilisez pas un espace de travail déjà utilisé pour le développement d'appareils Android.
Si nécessaire, vous pouvez télécharger l' IDE Eclipse pour les développeurs Java à partir de : eclipse.org/downloads
Créer des projets
- Exécutez make une fois à partir de la ligne de commande. Cela créera des bibliothèques externes dépendantes des projets ci-dessous.
- Définissez la variable de chemin de classe TRADEFED_ROOT dans
Window > Preferences > Java > Build Path> Classpath Variables
et pointez-la vers la racine de votre source tradefed. - Définissez la variable de chemin TRADEFED_ROOT dans
Window > Preferences > General > Workspace > Linked Resources
et pointez-la vers la racine de votre source tradefed. Utilisez l'assistant
File > Import...-> General > Existing Projects into workspace"
pour importer ces projets Java open source sous les chemins suivants :prebuilts/misc/common/ddmlib\* tools/loganalysis tools/loganalysis/tests tools/tradefederation/core tools/tradefederation/core/tests tools/tradefederation/contrib tools/tradefederation/core/remote platform_testing/libraries/health/runners/longevity/host platform_testing/libraries/annotations platform_testing/libraries/health/composers/host
Facultativement, si vous souhaitez voir le code source
ddmlib
, joignez le code source d'une branche d'outils dégroupée, telle que /platform/tools/base/tools_r22/ddmlib/src/main/java/com/android/ddmlib/IDevice.java .Facultativement, si vous souhaitez également que les projets de harnais CTS soient chargés, importez :
test/suite_harness/common/util test/suite_harness/common/host-side/util test/suite_harness/common/host-side/tradefed
Format automatique
REMARQUE : les fichiers requis se trouvent dans development/ide/eclipse
dans l'arborescence complète des sources de la plate-forme. Vous devrez donc consulter une branche de plateforme telle que main
pour obtenir ces fichiers : /development/main/ide/eclipse/
Utilisez les fichiers de préférences dans Eclipse pour définir automatiquement le formateur sur le guide de style Android. Pour ce faire dans Studio :
- Accédez à Fenêtre > Préférences > Java > Style de code .
- Sous Formatter , importez le fichier
android-formatting.xml
. - Sous Organiser > Imports , importez le fichier
android.importorder
.
Supprimer les espaces de fin
Pour forcer Eclipse à supprimer tous les espaces de fin :
- Accédez à Window > Preferences -> Java -> Editor -> Save Actions .
- Puis Actions supplémentaires -> Configurer -> Code > onglet Organisation -> Formateur .
- Cochez Supprimer les espaces de fin .
- Cliquez sur Appliquer et fermer .
Vérifier le style du code
Lors de la soumission d'une liste de modifications, un hook de pré-téléchargement automatique s'exécutera pour vérifier le format de votre code : google-java-format
Cela aide à formater votre code selon la norme commune.
Déboguer l'éclipse
Si vous souhaitez exécuter du code TF via un débogueur dans Eclipse, il est recommandé de créer d'abord un test unitaire pour le code en question car ce sera le moyen le plus simple et le plus rapide d'exercer les fonctionnalités.
Pour déboguer un test unitaire TF, faites simplement un clic droit dessus et sélectionnez Debug As > JUnit test .
Pour déboguer un test fonctionnel TF, suivez les instructions de la section précédente pour exécuter un test fonctionnel mais utilisez le menu Exécuter > Configurations de débogage .
Pour déboguer le programme TF lui-même, lors de l'exécution d'une configuration, suivez les instructions de la section précédente pour exécuter un test fonctionnel mais fournissez les arguments de ligne de commande pour la configuration que vous souhaitez exécuter à l'étape 4. Ainsi, pour déboguer la configuration « instrument », accédez au menu de configuration Exécuter > Déboguer et définissez l'onglet Arguments dans la configuration de débogage Eclipse sur -- package <package to run> instrument
.
Débogage à distance avec Eclipse
Suivez ces étapes pour déboguer à distance une session tradefed démarrée à partir de la ligne de commande tradefed.sh
:
- Démarrez tradefed.sh avec l'indicateur de débogage :
TF_DEBUG=1 tradefed.sh
- Attendez que cette invite de la JVM s'affiche :
Listening for transport dt_socket at address: 10088
Cela signifie que la JVM attend que le débogueur se connecte au port10088
. - Attachez-vous au débogage à distance d'Eclipse à partir du menu principal : sélectionnez Exécuter > Configurations de débogage... .
- Dans la boîte de dialogue contextuelle, sélectionnez Application Java distante dans le menu de gauche.
- Cliquez sur l'icône Nouvelle configuration de lancement dans la barre d'action.
- Nommez la configuration comme vous le souhaitez et sélectionnez tradefederation comme projet.
- Remplissez le port en utilisant l'adresse fournie précédemment.
- Basculez vers l'onglet Source et ajoutez les projets tradefederation et google-tradefed au chemin de recherche source .
- Cliquez sur Déboguer pour démarrer la session de débogage.
Le débogueur s'attache au processus JVM d'écoute et le terminal exécutant tradefed.sh
affiche l'invite tf>
.
Pour parcourir votre code en mode débogage, définissez un point d'arrêt dans Eclipse et appelez votre commande Tradefed (c'est-à-dire run <test>
) dans le terminal. Pour déboguer quoi que ce soit lors du démarrage de TF, vous pouvez d'abord définir le point d'arrêt, puis attacher le débogueur Eclipse.
CONSEIL : Pour utiliser un autre port, ajoutez TF_DEBUG_PORT=nnn
à la commande de l'étape 1 ci-dessus. Vous pouvez même l'utiliser dans un environnement de production si vous avez de mystérieux bogues de blocage à enquêter : remplacez suspend=y
par suspend=n
dans tradefed.sh
et commencez par l'indicateur de débogage. La JVM n'attendra pas que le débogueur se connecte, mais vous pouvez le faire à tout moment tant que le processus est toujours en cours d'exécution.
Débogage à distance à l'aide de JDB
Pour utiliser Java Debugger JDB, suivez des étapes similaires à celles d'Eclipse :
- Démarrez
tradefed.sh
avec l'indicateur de débogage :TF_DEBUG=1 tradefed.sh
- Attendez de voir l'invite de la JVM :
Listening for transport dt_socket at address: 10088
. Connectez
jdb
. Par exemple, depuis croot, exécutez :jdb -attach 10088 \ -sourcepath tools/tradefederation/core/src:vendor/google_tradefederation/core/src
Attendez la connexion et déboguez ! Exécutez
man jdb
pour plus d'aide.
Examiner la couverture du code
- Installez le plugin Eclemma .
- Accédez à Aide > Installer un nouveau logiciel et pointez l'assistant vers : http://update.eclemma.org/
- Une fois installé, sélectionnez l’option de test Coverage As > JUnit pour effectuer une exécution de couverture de code.