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
- Jalankan make sekali dari baris perintah. Ini akan membangun perpustakaan eksternal yang bergantung pada proyek di bawah ini.
- Setel variabel classpath TRADEFED_ROOT di
Window > Preferences > Java > Build Path> Classpath Variables
dan arahkan ke root sumber tradefed Anda - Tetapkan variabel jalur TRADEFED_ROOT di
Window > Preferences > General > Workspace > Linked Resources
dan arahkan ke root sumber tradefed Anda 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
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 .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:
- Buka Jendela > Preferensi > Java > Gaya Kode .
- Di bawah Formatter , impor file
android-formatting.xml
. - Di bagian Organize > Imports , impor file
android.importorder
.
Hapus spasi putih di belakangnya
Untuk memaksa Eclipse menghapus semua spasi tambahan:
- Buka Jendela > Preferensi -> Java -> Editor -> Simpan Tindakan .
- Kemudian Tindakan Tambahan -> Konfigurasi -> Kode > tab Pengorganisasian -> Formatter .
- Centang Hapus Spasi Tambahan .
- 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
:
- Mulai tradefed.sh dengan tanda debug:
TF_DEBUG=1 tradefed.sh
- 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 port10088
. - Lampirkan dengan debugging jarak jauh Eclipse dari menu utama: Pilih Run > Debug Configurations... .
- Dalam dialog pop-up, pilih Aplikasi Java Jarak Jauh dari menu sebelah kiri.
- Klik ikon Konfigurasi peluncuran baru di bilah tindakan.
- Beri nama konfigurasi sesuai keinginan Anda dan pilih federasi perdagangan sebagai proyek.
- Isi port menggunakan alamat yang diberikan sebelumnya.
- Beralih ke tab Sumber dan tambahkan proyek tradefederation dan google-tradefed ke Source Lookup Path .
- 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:
- Mulai
tradefed.sh
dengan tanda debug:TF_DEBUG=1 tradefed.sh
- Tunggu hingga Anda melihat prompt dari JVM:
Listening for transport dt_socket at address: 10088
. Hubungkan
jdb
. Misalnya, dari croot run:jdb -attach 10088 \ -sourcepath tools/tradefederation/core/src:vendor/google_tradefederation/core/src
Tunggu koneksi dan debug! Jalankan
man jdb
untuk bantuan lebih lanjut.
Periksa cakupan kode
- Instal plugin Eclemma .
- Buka Bantuan > Instal Perangkat Lunak Baru dan arahkan wizard ke: http://update.eclemma.org/
- Setelah terinstal, pilih opsi Cakupan Sebagai > pengujian JUnit untuk menjalankan cakupan kode.