Pour configurer Tradefed à l'aide d'Eclipse, procédez comme suit.
Créez un espace de travail distinct pour développer la fédération commerciale. Ne réutilisez pas 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 à l'adresse suivante: eclipse.org/téléchargements
Créer des projets
- Exécutez make une fois à partir de la ligne de commande. Cela créera des bibliothèques externes dépend des projets ci-dessous.
- Définissez la variable classpath TRADEFED_ROOT dans
Window > Preferences > Java > Build Path> Classpath Variables
et faites-la pointer vers la racine source de votre échanges - Définissez la variable de chemin TRADEFED_ROOT dans
Window > Preferences > General > Workspace > Linked Resources
et faites-la pointer vers la racine source échangée Utilisez l'assistant
File > Import...-> General > Existing Projects into workspace"
pour intégrer ces projets Java Open Source dans 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
Si vous voulez voir le code source de
ddmlib
, joignez le code source à partir d'une branche d'outils non groupée, telle que /platform/tools/base/tools_r22/ddmlib/src/main/java/com/android/ddmlib/IDevice.java.Si vous souhaitez également que les projets d'exploitation CTS soient chargés, importez:
test/suite_harness/common/util test/suite_harness/common/host-side/util test/suite_harness/common/host-side/tradefed
Formater automatiquement
REMARQUE: Les fichiers requis sont stockés dans development/ide/eclipse
sur la plate-forme complète.
arborescence source. Vous devez donc consulter une branche de plate-forme telle que main
.
pour obtenir ces fichiers:
/development/main/ide/eclipse/
Utilisez des fichiers de préférences dans Eclipse pour définir automatiquement l'outil de mise en forme 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 > Importations, importez le fichier
android.importorder
.
Supprimer les espaces blancs de fin
Pour forcer Eclipse à supprimer tous les espaces blancs de fin:
- Accédez à Fenêtre > Préférences -> Java -> Éditeur -> Actions d'enregistrement.
- Sélectionnez ensuite Actions supplémentaires -> Configurer -> Code > Organisation de l'onglet -> Outil de mise en forme.
- Cochez la case Supprimer les espaces blancs de fin.
- Cliquez sur Appliquer et fermer.
Vérifier le style de code
Lorsque vous envoyez une liste de modifications, une accroche de préimportation automatique est exécutée pour vérifier votre
format de code: google-java-format
Cela facilite le formatage de votre code selon la norme courante.
Déboguer Eclipse
Si vous souhaitez exécuter du code TF via un débogueur dans Eclipse, nous vous recommandons commencez par créer un test unitaire pour le code en question, car il s'agit de la méthode la plus simple et le moyen le plus rapide d'exercer la fonctionnalité.
Pour déboguer un test unitaire TF, effectuez 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 la commande Exécuter > Menu "Debug configurations" (Configurations de débogage).
Pour déboguer le programme TF lui-même, lors de l'exécution d'une configuration, suivez le
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. Donc
pour déboguer l'instrument configuration, accédez à Exécuter > Configuration du débogage
et définissez l'onglet Arguments de 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 échangée démarrée depuis
Ligne de commande tradefed.sh
:
- Démarrez tradefed.sh avec l'indicateur de débogage:
TF_DEBUG=1 tradefed.sh
- Attendez que la JVM affiche l'invite suivante:
Listening for transport dt_socket at address: 10088
. Cela signifie que la JVM attend que le débogueur s'associer sur le port10088
. - Joindre avec le débogage distant d'Eclipse à partir du menu principal: sélectionnez Exécuter > Déboguer Configurations...
- Dans la boîte de dialogue pop-up, sélectionnez Application Java distante dans le menu de gauche.
- Cliquez sur l'icône New launch configuration (Nouvelle configuration de lancement) dans la barre d'action.
- Attribuez un nom à la configuration et sélectionnez tradefederation comme projet.
- Renseignez le port à l'aide de l'adresse fournie précédemment.
- Passez à l'onglet Source et ajoutez les projets tradefederation et google-tradefed par le chemin de recherche source.
- Cliquez sur Debug (Déboguer) pour démarrer la session de débogage.
Le débogueur se connecte 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
au démarrage de TF, vous pouvez commencer par définir le point d'arrêt, puis associer
à l'aide d'un débogueur.
CONSEIL: Pour utiliser un autre port, ajoutez TF_DEBUG_PORT=nnn
à la commande à l'étape 1.
ci-dessus. Vous pouvez l'utiliser dans un environnement de production
Blocage des bugs à examiner: remplacez suspend=y
par suspend=n
dans tradefed.sh
et
commencez par l'indicateur de débogage. La JVM n'attend pas l'association du débogueur, mais vous pouvez
donc à tout moment tant que
le processus est toujours en cours d'exécution.
Débogage à distance avec JDB
Pour utiliser Java Debugger JDB, suivez des étapes semblables à celles d'Eclipse:
- Démarrez
tradefed.sh
avec l'indicateur de débogage:TF_DEBUG=1 tradefed.sh
. - Attendez que l'invite JVM suivante s'affiche:
Listening for transport dt_socket at address: 10088
. Connectez
jdb
. Par exemple, à partir de croot, exécutez la commande suivante:jdb -attach 10088 \ -sourcepath tools/tradefederation/core/src:vendor/google_tradefederation/core/src
Attendez la connexion et procédez au débogage. Exécutez
man jdb
pour obtenir de l'aide.
Examiner la couverture de code
- Installez le plug-in Eclemma.
- Accédez à Aide > Installer un nouveau logiciel et faire pointer l'assistant vers: http://update.eclemma.org/fr
- Une fois l'installation effectuée, sélectionnez Couverture l'option de test JUnit pour effectuer une l'exécution de la couverture de code.