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

Configurer Eclipse

Suivez ces étapes pour configurer Tradefed à l'aide d'Eclipse.

Créez un espace de travail distinct 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 sur la page eclipse.org/downloads.

Créer des projets

Exécutez make une fois à partir de la ligne de commande. Cette opération créera des bibliothèques externes en fonction 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 pointez-la vers la racine source de Tradefed.

Utilisez l'assistant File > Import...-> General > Existing Projects into workspace" pour importer ces projets Java Open Source sous les chemins d'accès 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 souhaitez afficher le code source ddmlib, vous pouvez joindre 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 charger les projets de faisceau CTS, importez les éléments suivants:

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 se trouvent dans development/ide/eclipse dans l'arborescence source complète de la plate-forme. Vous devez donc extraire 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 le formateur sur le guide de style Android. Pour ce faire, dans Studio:

Accédez à Window > Preferences > Java > Code Style (Fenêtre > Préférences > Java > Style de code).
Sous Formateur, 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 en fin de ligne:

Accédez à Window > Preferences -> Java -> Editor -> Save Actions (Fenêtre > Préférences > Java > Éditeur > Enregistrer les actions).
Ensuite, sélectionnez Autres actions -> Configurer -> Code > onglet Organisation -> Formateur.
Cochez Supprimer les espaces vides à la fin.
Cliquez sur Appliquer et fermer.

Vérifier le style du code

Lorsque vous envoyez une liste de modifications, un hook de préchargement automatique s'exécute pour vérifier le format de votre code: google-java-format

Cela permet de mettre en forme 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 de créer d'abord un test unitaire pour le code en question, car il s'agit du moyen le plus simple et le plus rapide d'exercer la fonctionnalité.

Pour déboguer un test unitaire TF, effectuez un clic droit dessus, puis sélectionnez Debug As > JUnit test (Déboguer en tant que > Test JUnit).

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 Run > Debug configurations (Exécuter > Déboguer les configurations).

Pour déboguer le programme TF lui-même, lorsque vous exécutez 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. Pour déboguer la configuration "instrument", accédez au menu Run > Debug configuration (Exécuter > Configuration de débogage), puis définissez l'onglet Arguments dans la configuration de débogage Eclipse sur -- package <package to run> instrument.

Débogage à distance avec Eclipse

Pour déboguer à distance une session de tradefed lancée à partir de la ligne de commande tradefed.sh, procédez comme suit:

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. Cela signifie que la JVM attend que le débogueur soit associé sur le port 10088.
Associer avec le débogage à distance d'Eclipse à partir du menu principal: sélectionnez Run > Debug Configurations (Exécuter > Configurations de débogage).
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.
Nommez la configuration comme vous le souhaitez, puis 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 au chemin d'accès de recherche de source.
Cliquez sur Debug (Déboguer) pour démarrer la session de débogage.

Le débogueur se connecte au processus JVM en é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 (par exemple, run <test>) dans le terminal. Pour déboguer quoi que ce soit au démarrage de TF, vous pouvez d'abord définir le point d'arrêt, puis associer le débogueur Eclipse.

CONSEIL: Pour utiliser un autre port, ajoutez TF_DEBUG_PORT=nnn à la commande à l'étape 1 ci-dessus. Vous pouvez même l'utiliser dans l'environnement de production si vous devez examiner des bugs de blocage mystérieux: remplacez suspend=y par suspend=n dans tradefed.sh et commencez par l'indicateur de débogage. La JVM n'attend pas que le débogueur soit associé, mais vous pouvez le faire à tout moment tant que le processus est en cours d'exécution.

Débogage à distance à l'aide de 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 de la JVM s'affiche: Listening for transport dt_socket at address: 10088.

Associer jdb. Par exemple, à partir de croot:

jdb -attach 10088 \
    -sourcepath tools/tradefederation/core/src:vendor/google_tradefederation/core/src

Attendez la connexion et lancez le débogage. Exécutez man jdb pour obtenir de l'aide.

Examiner la couverture de code

Installez le plug-in Eclemma.
Accédez à Help > Install New Software (Aide > Installer un nouveau logiciel) et pointez l'assistant vers la page suivante : http://update.eclemma.org/
Une fois installé, sélectionnez l'option de test Coverage As > JUnit (Couverture en tant que > JUnit) pour effectuer une analyse de la couverture du code.