Configura Eclipse

Sigue estos pasos para configurar Tradefed con Eclipse.

Crear un espacio de trabajo aparte para desarrollar la Federación de Comercio; no reutilices un que ya se usaba para el desarrollo de dispositivos Android.

Si es necesario, puedes descargar el IDE de Eclipse para desarrolladores de Java desde el siguiente sitio: eclipse.org/descargas

Crea proyectos

  1. Ejecuta make una vez desde la línea de comandos. Se compilarán bibliotecas externas depende de los proyectos que se muestran a continuación.
  2. Configura la variable de ruta de clase TRADEFED_ROOT en Window > Preferences > Java > Build Path> Classpath Variables y apúntala a la raíz de origen de tu fuente de intercambio.
  3. Configura la variable de ruta de acceso TRADEFED_ROOT en Window > Preferences > General > Workspace > Linked Resources y apúntala a la raíz de origen de intercambio.

  4. Usa el asistente de File > Import...-> General > Existing Projects into workspace" para incorporar estos proyectos de Java de código abierto al las siguientes rutas:

    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. De manera opcional, si quieres ver el código fuente de ddmlib, adjunta el código fuente. desde una rama de herramientas sin agrupar, como /platform/tools/base/tools_r22/ddmlib/src/main/java/com/android/ddmlib/IDevice.java.

  6. De manera opcional, si también quieres que se carguen los proyectos de aprovechamiento del CTS, importa lo siguiente:

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

Formato automático

NOTA: Los archivos necesarios se encuentran en development/ide/eclipse en la plataforma completa árbol de fuentes. Por lo tanto, tendrás que consultar una rama de la plataforma como main para obtener estos archivos: /development/main/ide/eclipse/

Usa archivos de preferencias en Eclipse para establecer automáticamente el formateador en la Guía de estilo de Android Sigue estos pasos en Studio:

  1. Ve a Ventana > Preferencias > Java > Estilo de código.
  2. En Formateador, importa el archivo android-formatting.xml.
  3. En Organizar > Imports, importa el archivo android.importorder.

Quita los espacios en blanco finales

Para forzar a Eclipse a quitar todos los espacios en blanco finales, haz lo siguiente:

  1. Ve a Ventana > Preferencias -> Java -> Editor -> Guardar acciones.
  2. Luego, Acciones adicionales -> Configurar -> Código > Organizando pestaña -> Formateador.
  3. Marca Quitar espacio en blanco del seguimiento.
  4. Haz clic en Aplicar y cerrar.

Verifica el estilo de código

Al enviar una lista de cambios, se ejecutará un hook previo a la carga automática para verificar formato de código: google-java-format

Esto te ayudará a formatear tu código conforme al estándar común.

Depurar Eclipse

Si quieres ejecutar TF code a través de un depurador en Eclipse, te recomendamos crea primero una prueba de unidades para el código en cuestión, ya que será la más sencilla. y más rápida de ejercitar la funcionalidad.

Para depurar una prueba de unidades de TF, simplemente haz clic con el botón derecho en ella y selecciona Debug As > JUnit prueba.

Para depurar una prueba funcional de TF, sigue las instrucciones de la sección anterior para ejecutar una prueba funcional, pero usa el botón Run > Menú de configuraciones de depuración

Para depurar el programa de TF en sí, cuando ejecutes cualquier configuración, sigue las instrucciones de la sección anterior para ejecutar una prueba funcional, pero proporciona los argumentos de la línea de comandos para la configuración que quieres ejecutar en el paso 4. De esta manera, depurar el "instrumento" ve a Ejecutar > Configuración de depuración y configura la pestaña Arguments en la configuración de depuración de Eclipse como -- package <package to run> instrument

Depuración remota con Eclipse

Sigue estos pasos para depurar de forma remota una sesión de intercambio que se inició desde Línea de comandos de tradefed.sh:

  1. Inicia Tradefed.sh con la marca de depuración TF_DEBUG=1 tradefed.sh.
  2. Espera hasta ver este mensaje de la JVM: Listening for transport dt_socket at address: 10088. Esto significa que la JVM está esperando que el depurador lo haga. conectarla en el puerto 10088.
  3. Adjuntar con la depuración remota de Eclipse desde el menú principal: Selecciona Ejecutar > Depurar Configuraciones...
  4. En el cuadro de diálogo emergente, selecciona Remote Java Application en el menú de la izquierda.
  5. Haz clic en el ícono New launch configuration de la barra de acciones.
  6. Asígnale el nombre que desees a la configuración y selecciona tradefederation como en un proyecto final.
  7. Propaga el puerto con la dirección que proporcionaste anteriormente.
  8. Cambia a la pestaña Fuente y agrega los proyectos tradefederation y google-tradefed a la ruta de búsqueda de origen.
  9. Haz clic en Debug para iniciar la sesión de depuración.

El depurador se conecta al proceso de JVM de escucha y la terminal que se ejecuta tradefed.sh muestra el mensaje tf>.

Para revisar tu código en modo de depuración, establece un punto de interrupción en Eclipse y, luego, invoca el comando Tradefed (es decir, run <test>) en la terminal Para depurar algo durante el inicio de TF, primero puedes establecer el punto de interrupción y, luego, conectar el depurador de la nube.

SUGERENCIA: Para usar un puerto alternativo, agrega TF_DEBUG_PORT=nnn al comando en el paso 1 arriba. Incluso puede usar esto en un entorno de producción Para bloquear los errores que se deben investigar, cambia suspend=y a suspend=n en tradefed.sh. comienza con la marca de depuración. La JVM no esperará a que se adjunte el depurador, pero puedes y en cualquier momento, siempre que el proceso se siga ejecutando.

Depuración remota mediante JDB

Para usar Java Debugger JDB, sigue pasos similares a los de Eclipse:

  1. Inicia tradefed.sh con la marca de depuración TF_DEBUG=1 tradefed.sh.
  2. Espera hasta ver el mensaje de JVM: Listening for transport dt_socket at address: 10088.

  3. Conectar jdb. Por ejemplo, desde croot ejecuta:

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

  4. Espera a la conexión y deja de depurar. Ejecuta man jdb para obtener más ayuda.

Examina la cobertura de código

  1. Instala el complemento Eclemma.
  2. Accede a Ayuda > Install New Software (Instalar software nuevo) y apunta el asistente hacia lo siguiente: https://update.eclemma.org/
  3. Luego de instalarla, selecciona Cobertura como > JUnit para realizar una ejecución de cobertura de código.