Siapkan Eclipse

Ikuti langkah-langkah berikut untuk menyiapkan Tradefed menggunakan Eclipse.

Buat ruang kerja terpisah untuk mengembangkan Federasi Perdagangan, jangan menggunakan kembali ruang kerja yang sudah digunakan untuk pengembangan perangkat Android.

Jika diperlukan, Anda dapat mengunduh Eclipse IDE untuk pengembang Java dari: Eclipse.org/downloads

Buat proyek

  1. Jalankan make sekali dari baris perintah. Ini akan membangun perpustakaan eksternal yang bergantung pada proyek di bawah ini.
  2. Setel variabel classpath TRADEFED_ROOT di Window > Preferences > Java > Build Path> Classpath Variables dan arahkan ke root sumber tradefed Anda
  3. Tetapkan variabel jalur TRADEFED_ROOT di Window > Preferences > General > Workspace > Linked Resources dan arahkan ke root sumber tradefed Anda

  4. Gunakan wizard File > Import...-> General > Existing Projects into workspace" untuk memasukkan proyek Java sumber terbuka ini dengan jalur berikut:

    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. Opsional, jika Anda ingin melihat kode sumber ddmlib , lampirkan kode sumber dari cabang alat yang tidak dibundel, seperti /platform/tools/base/tools_r22/ddmlib/src/main/java/com/android/ddmlib/IDevice.java .

  6. Opsional, jika Anda juga ingin proyek pemanfaatan CTS dimuat, impor:

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

Format otomatis

CATATAN: File yang diperlukan berada dalam development/ide/eclipse di pohon sumber platform lengkap. Jadi, Anda perlu memeriksa cabang platform seperti main untuk mendapatkan file-file ini: /development/main/ide/Eclipse/

Gunakan file preferensi di Eclipse untuk secara otomatis mengatur formatter ke panduan gaya Android. Untuk melakukan ini di Studio:

  1. Buka Jendela > Preferensi > Java > Gaya Kode .
  2. Di bawah Formatter , impor file android-formatting.xml .
  3. Di bagian Organize > Imports , impor file android.importorder .

Hapus spasi putih di belakangnya

Untuk memaksa Eclipse menghapus semua spasi tambahan:

  1. Buka Jendela > Preferensi -> Java -> Editor -> Simpan Tindakan .
  2. Kemudian Tindakan Tambahan -> Konfigurasi -> Kode > tab Pengorganisasian -> Formatter .
  3. Centang Hapus Spasi Tambahan .
  4. Klik Terapkan dan Tutup .

Periksa gaya kode

Saat mengirimkan daftar perubahan, hook praunggah otomatis akan dijalankan untuk memeriksa format kode Anda: google-java-format

Ini membantu memformat kode Anda ke standar umum.

Debug Gerhana

Jika Anda ingin menjalankan kode TF melalui debugger di Eclipse, disarankan agar Anda terlebih dahulu membuat pengujian unit untuk kode tersebut karena ini akan menjadi cara paling sederhana dan tercepat untuk menjalankan fungsionalitasnya.

Untuk men-debug pengujian unit TF, cukup klik kanan padanya dan pilih Debug As > JUnit test .

Untuk men-debug pengujian fungsional TF, ikuti instruksi di bagian sebelumnya untuk menjalankan pengujian fungsional tetapi gunakan menu Konfigurasi Run > Debug .

Untuk men-debug program TF itu sendiri, saat menjalankan konfigurasi apa pun, ikuti instruksi di bagian sebelumnya untuk menjalankan pengujian fungsional tetapi berikan argumen baris perintah untuk konfigurasi yang ingin Anda jalankan di langkah 4. Jadi untuk men-debug konfigurasi 'instrumen', buka menu konfigurasi Run > Debug dan atur tab Arguments di konfigurasi debug Eclipse ke -- package <package to run> instrument .

Debug jarak jauh dengan Eclipse

Ikuti langkah-langkah berikut untuk men-debug sesi tradefed dari jarak jauh yang dimulai dari baris perintah tradefed.sh :

  1. Mulai tradefed.sh dengan tanda debug: TF_DEBUG=1 tradefed.sh
  2. Tunggu sampai Anda melihat prompt ini dari JVM: Listening for transport dt_socket at address: 10088 Ini berarti JVM sedang menunggu debugger untuk dipasang di port 10088 .
  3. Lampirkan dengan debugging jarak jauh Eclipse dari menu utama: Pilih Run > Debug Configurations... .
  4. Dalam dialog pop-up, pilih Aplikasi Java Jarak Jauh dari menu sebelah kiri.
  5. Klik ikon Konfigurasi peluncuran baru di bilah tindakan.
  6. Beri nama konfigurasi sesuai keinginan Anda dan pilih federasi perdagangan sebagai proyek.
  7. Isi port menggunakan alamat yang diberikan sebelumnya.
  8. Beralih ke tab Sumber dan tambahkan proyek tradefederation dan google-tradefed ke Source Lookup Path .
  9. Klik Debug untuk memulai sesi debugging.

Debugger menempel pada proses JVM yang mendengarkan, dan terminal yang menjalankan tradefed.sh menampilkan prompt tf> .

Untuk menelusuri kode Anda dalam mode debug, tetapkan titik istirahat di Eclipse dan aktifkan perintah Tradefed Anda (yaitu run <test> ) di terminal. Untuk men-debug apa pun selama startup TF, Anda dapat mengatur break point terlebih dahulu dan kemudian memasang debugger Eclipse.

TIPS: Untuk menggunakan port alternatif, tambahkan TF_DEBUG_PORT=nnn ke perintah pada langkah 1 di atas. Anda bahkan dapat menggunakan ini di lingkungan produksi jika Anda memiliki bug hang misterius untuk diselidiki: ubah suspend=y menjadi suspend=n di tradefed.sh dan mulai dengan tanda debug. JVM tidak akan menunggu debugger terpasang, namun Anda dapat melakukannya kapan saja selama prosesnya masih berjalan.

Debug jarak jauh menggunakan JDB

Untuk menggunakan Java Debugger JDB, ikuti langkah-langkah yang mirip dengan Eclipse:

  1. Mulai tradefed.sh dengan tanda debug: TF_DEBUG=1 tradefed.sh
  2. Tunggu hingga Anda melihat prompt dari JVM: Listening for transport dt_socket at address: 10088 .

  3. Hubungkan jdb . Misalnya, dari croot run:

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

  4. Tunggu koneksi dan debug! Jalankan man jdb untuk bantuan lebih lanjut.

Periksa cakupan kode

  1. Instal plugin Eclemma .
  2. Buka Bantuan > Instal Perangkat Lunak Baru dan arahkan wizard ke: http://update.eclemma.org/
  3. Setelah terinstal, pilih opsi Cakupan Sebagai > pengujian JUnit untuk menjalankan cakupan kode.