Cette page a été traduite par l'API Cloud Translation.

Configurer Eclipse

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 port 10088.
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.