Configura Eclipse

Segui questi passaggi per configurare Tradefed utilizzando Eclipse.

Crea un'area di lavoro separata per sviluppare la Trade Federation, non riutilizzare un area di lavoro già utilizzata per lo sviluppo di dispositivi Android.

Se necessario, puoi scaricare l'IDE Eclipse per sviluppatori Java da: eclipse.org/download

Crea progetti

  1. Esegui make una volta dalla riga di comando. In questo modo verranno create librerie esterne dipendevano dai progetti seguenti.
  2. Imposta la variabile classpath TRADEFED_ROOT in Window > Preferences > Java > Build Path> Classpath Variables e puntala alla radice di origine tradefeduta
  3. Imposta la variabile di percorso TRADEFED_ROOT in Window > Preferences > General > Workspace > Linked Resources e puntala alla radice di origine trasferita

  4. Usa la procedura guidata File > Import...-> General > Existing Projects into workspace" per inserire questi progetti Java open source nel seguenti percorsi:

    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. Facoltativamente, se vuoi visualizzare il codice sorgente ddmlib, collegalo da un ramo di strumenti non in bundle, ad esempio /platform/tools/base/tools_r22/ddmlib/src/main/java/com/android/ddmlib/IDevice.java.

  6. Facoltativamente, se vuoi caricare anche i progetti di cablaggio CTS, importa:

    test/suite_harness/common/util
test/suite_harness/common/host-side/util
test/suite_harness/common/host-side/tradefed

Formattazione automatica

NOTA: i file richiesti sono disponibili all'interno di development/ide/eclipse nell'intera piattaforma nell'albero di origine. Dovrai quindi controllare un ramo della piattaforma, come main per recuperare questi file: /development/main/ide/eclipse/

Usa i file delle preferenze in Eclipse per impostare automaticamente il formattatore su Guida di stile di Android. Per eseguire questa operazione in Studio:

  1. Vai a Finestra > Preferenze > Java > Stile del codice.
  2. In Formattatore, importa il file android-formatting.xml.
  3. In Organizza > Importazioni, importa il file android.importorder.

Rimuovi gli spazi vuoti finali

Per forzare la rimozione di tutti gli spazi vuoti finali da Eclissi:

  1. Vai a Finestra > Preferenze -> Java -> Editor -> Salva azioni.
  2. Quindi fai clic su Azioni aggiuntive -> Configura -> Codice > Scheda Organizzazione -> Formattatore.
  3. Seleziona Rimuovi spazio vuoto finale.
  4. Fai clic su Applica e chiudi.

Controlla lo stile del codice

Quando invii un elenco di modifiche, viene eseguito un hook automatico di precaricamento per controllare formato codice: google-java-format

Ciò consente di formattare il codice secondo lo standard comune.

Esegui il debug dell'eclissi

Se vuoi eseguire il codice TF in un debugger in Eclipse, ti consigliamo crea innanzitutto un test delle unità per il codice in questione, poiché questa sarà la e più rapido per esercitarne la funzionalità.

Per eseguire il debug di un test di unità TF, è sufficiente fare clic con il tasto destro del mouse e selezionare Debug come > Unità J test.

Per eseguire il debug di un test funzionale di TF, segui le istruzioni riportate nella sezione precedente per eseguire un test funzionale, ma usa il pulsante Esegui > Configurazioni di debug.

Per eseguire il debug del programma TF stesso, quando esegui una configurazione, segui le le istruzioni nella sezione precedente per l'esecuzione di un test funzionale, ma gli argomenti della riga di comando per la configurazione da eseguire nel passaggio 4. Quindi... per eseguire il debug dello "strumento" configurazione, vai al menu Esegui > Configurazione di debug e imposta la scheda Argomenti nella configurazione di debug di Eclipse su -- package <package to run> instrument.

Debug remoto con Eclipse

Segui questi passaggi per eseguire da remoto il debug di una sessione trasferita avviata da Riga di comando tradefed.sh:

  1. Avvia tradefed.sh con il flag di debug: TF_DEBUG=1 tradefed.sh
  2. Attendi finché non viene visualizzato questo prompt dalla JVM: Listening for transport dt_socket at address: 10088 Ciò significa che la JVM è in attesa del debugger per collega alla porta 10088.
  3. Collega con il debug remoto di Eclipse dal menu principale: seleziona Esegui > Esegui il debug Configurazioni....
  4. Nella finestra di dialogo popup, seleziona Applicazione Java remota dal menu a sinistra.
  5. Fai clic sull'icona Nuova configurazione di avvio nella barra delle azioni.
  6. Assegna alla configurazione il nome che preferisci e seleziona tradefederation come predefinita progetto.
  7. Compila la porta utilizzando l'indirizzo fornito in precedenza.
  8. Passa alla scheda Source (Origine) e aggiungi i progetti tradefederation e google-tradefed al Percorso di ricerca della sorgente.
  9. Fai clic su Debug per avviare la sessione di debug.

Il debugger si collega al processo JVM di ascolto e il terminale in esecuzione tradefed.sh mostra il prompt tf>.

Per esaminare il codice in modalità di debug, imposta un punto di interruzione in Eclipse e richiama il tuo comando Tradefed (ad es. run <test>) nel terminale. Per eseguire il debug di qualsiasi cosa Durante l'avvio di TF, puoi prima impostare il punto di interruzione e poi collegare l'Eclissi debugger.

SUGGERIMENTO: per utilizzare una porta alternativa, aggiungi TF_DEBUG_PORT=nnn al comando nel passaggio 1 in alto. Puoi anche usarlo nell'ambiente di produzione se hai domande hang bug per effettuare accertamenti: cambia suspend=y in suspend=n in tradefed.sh e per iniziare con il flag di debug. La JVM non attenderà il collegamento del debugger, ma puoi farlo quindi in qualsiasi momento purché il processo sia ancora in esecuzione.

Debug remoto tramite JDB

Per utilizzare JDB in Java Debugger, segui questi passaggi simili a quelli per Eclipse:

  1. Avvia tradefed.sh con il flag di debug: TF_DEBUG=1 tradefed.sh
  2. Attendi finché non viene visualizzato il prompt della JVM: Listening for transport dt_socket at address: 10088.

  3. Connetti jdb. Ad esempio, da croot run:

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

  4. Attendi la connessione ed esegui il debug. Esegui man jdb per ulteriore assistenza.

Esamina la copertura del codice

  1. Installa il plug-in Eclemma.
  2. Vai su Guida > Installa nuovo software e indica con la procedura guidata: http://update.eclemma.org/
  3. Al termine dell'installazione, seleziona Copertura come > JUnit per eseguire un l'esecuzione della copertura del codice.