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 Eclipse IDE for Java Developers depuis la page eclipse.org/downloads.

Créer des projets

  1. Exécutez "make" une fois à partir de la ligne de commande. Cela compilera les bibliothèques externes dont dépendent les projets ci-dessous.
  2. Définissez la variable de chemin d'accès TRADEFED_ROOT dans Window > Preferences > Java > Build Path> Classpath Variables et pointez-la vers la racine de votre source Tradefed.
  3. Définissez la variable de chemin d'accès TRADEFED_ROOT dans Window > Preferences > General > Workspace > Linked Resources et pointez-la vers la racine de votre source Tradefed.

  4. 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

  5. Si vous le souhaitez, pour afficher le code source ddmlib, associez le code source à partir d'une branche d'outils non groupés, telle que /platform/tools/base/tools_r22/ddmlib/src/main/java/com/android/ddmlib/IDevice.java.

  6. Si vous souhaitez également charger les projets de harnais CTS, 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 source complète de la plate-forme. Vous devrez donc extraire une branche de plate-forme telle que android-latest-release pour obtenir ces fichiers : /development/android16-release/ide/eclipse/

Utilisez les fichiers de préférences dans Eclipse pour définir automatiquement le formatteur sur le guide de style Android. Pour ce faire dans Studio :

  1. Accédez à Window > Preferences > Java > Code Style (Fenêtre > Préférences > Java > Style de code).
  2. Sous Formatter, importez le fichier android-formatting.xml.
  3. Sous Organiser > Importations, importez le fichier android.importorder.

Supprimer les espaces blancs de fin

Pour forcer Eclipse à supprimer tous les espaces blancs de fin :

  1. Accédez à Window > Preferences > Java > Editor > Save Actions (Fenêtre > Préférences > Java > Éditeur > Actions d'enregistrement).
  2. Ensuite, Actions supplémentaires > Configurer > Code > Onglet "Organiser" > Formatteur.
  3. Cochez Supprimer les espaces de fin de ligne.
  4. 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, il est recommandé 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, il vous suffit d'effectuer un clic droit dessus et de sélectionner 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 Exécuter > Configurations de débogage.

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éboguer à distance avec Eclipse

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

  1. Démarrez tradefed.sh avec l'indicateur de débogage : TF_DEBUG=1 tradefed.sh
  2. Attendez que l'invite suivante s'affiche dans la JVM : Listening for transport dt_socket at address: 10088. Cela signifie que la JVM attend que le débogueur se connecte au port 10088.
  3. Associez-vous au débogage à distance d'Eclipse depuis le menu principal : sélectionnez Run > Debug Configurations… (Exécuter > Configurations de débogage…).
  4. Dans la boîte de dialogue pop-up, sélectionnez Remote Java Application (Application Java à distance) dans le menu de gauche.
  5. Cliquez sur l'icône New launch configuration (Nouvelle configuration de lancement) dans la barre d'action.
  6. Nommez la configuration comme vous le souhaitez et sélectionnez tradefederation comme projet.
  7. Renseignez le port à l'aide de l'adresse fournie précédemment.
  8. Passez à l'onglet Source et ajoutez les projets tradefederation et google-tradefed au chemin de recherche de la source.
  9. Cliquez sur Déboguer pour démarrer la session de débogage.

Le débogueur s'associe 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 pendant le 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 de l'étape 1 ci-dessus. Vous pouvez même l'utiliser dans un environnement de production si vous avez des bugs de blocage mystérieux à examiner : 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 toujours en cours d'exécution.

Déboguer à distance à l'aide de JDB

Pour utiliser le débogueur Java JDB, suivez des étapes semblables à celles d'Eclipse :

  1. Démarrez tradefed.sh avec l'indicateur de débogage : TF_DEBUG=1 tradefed.sh
  2. Attendez que l'invite de la JVM s'affiche : Listening for transport dt_socket at address: 10088.

  3. Connecter jdb. Par exemple, à partir de croot :

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

  4. Attendez que la connexion soit établie et déboguez ! Exécutez man jdb pour obtenir de l'aide.

Examiner la couverture du code

  1. Installez le plug-in Eclemma.
  2. Accédez à Help > Install New Software (Aide > Installer un nouveau logiciel), puis indiquez l'URL suivante dans l'assistant : http://update.eclemma.org/
  3. Une fois installé, sélectionnez l'option de test Coverage As > JUnit pour exécuter une couverture du code.