Menyiapkan Eclipse

Ikuti langkah-langkah berikut untuk menyiapkan Tradefed menggunakan Eclipse.

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

Jika perlu, Anda dapat mendownload Eclipse IDE untuk developer Java dari: eclipse.org/downloads

Membuat project

1. Jalankan make sekali dari baris perintah. Tindakan ini akan membangun library eksternal bergantung pada project di bawah ini.
2. Tetapkan variabel classpath TRADEFED_ROOT di Window > Preferences > Java > Build Path> Classpath Variables dan arahkan ke root sumber yang ditukarkan
3. Tetapkan variabel jalur TRADEFED_ROOT di Window > Preferences > General > Workspace > Linked Resources dan arahkan ke root sumber yang diperdagangkan

4. Gunakan wizard File > Import...-> General > Existing Projects into workspace"untuk memasukkan proyek Java open source ini ke dalam 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. Atau, jika Anda ingin melihat kode sumber ddmlib, lampirkan kode sumber tersebut dari cabang alat yang tidak dipaketkan, seperti /platform/tools/base/tools_r22/ddmlib/src/main/java/com/android/ddmlib/IDevice.java.

6. Secara opsional, jika Anda juga ingin project memanfaatkan 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 tersedia di development/ide/eclipse pada platform lengkap dalam hierarki sumber. Jadi, Anda perlu memeriksa cabang platform seperti main untuk mendapatkan file ini: /pengembangan/main/ide/eclipse/

Gunakan file preferensi di Eclipse untuk secara otomatis mengatur pemformat ke Panduan gaya Android. Untuk melakukannya di Studio:

1. Buka Window > Preferensi > Java > Gaya Kode.
2. Di bagian Formatter, impor file android-formatting.xml.
3. Di bagian Atur > Impor, impor file android.importorder.

Hapus spasi kosong di akhir

Untuk memaksa Eclipse menghapus semua spasi kosong di akhir:

1. Buka Window > Preferensi -> Java -> Editor -> Simpan Tindakan.
2. Lalu Tindakan Tambahan -> Konfigurasikan -> Kode > Mengatur tab -> Pemformat.
3. Centang Hapus Spasi Kosong Akhir.
4. Klik Terapkan dan Tutup.

Memeriksa gaya kode

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

Ini membantu memformat kode Anda ke standar umum.

Debug Gerhana Matahari

Jika Anda ingin menjalankan kode TF melalui debugger di Eclipse, sebaiknya Anda pertama buat pengujian unit untuk kode yang dimaksud karena ini akan menjadi yang paling sederhana dan tercepat untuk melatih fungsionalitasnya.

Untuk men-debug pengujian unit TF, cukup klik kanan pengujian itu dan pilih Debug As > JUnit uji coba.

Untuk men-debug pengujian fungsional TF, ikuti petunjuk di bagian sebelumnya untuk menjalankan pengujian fungsional tetapi gunakan perintah Run > Menu konfigurasi debug.

Untuk men-debug program TF itu sendiri, saat menjalankan konfigurasi apa pun, ikuti instruksi di bagian sebelumnya untuk menjalankan tes fungsional tetapi memberikan argumen command line untuk konfigurasi yang ingin Anda jalankan di langkah 4. Namun untuk men-debug 'instrument' buka perintah Run > Konfigurasi debug lalu tetapkan tab Arguments dalam konfigurasi debug Eclipse untuk -- package <package to run> instrument.

Debug jarak jauh dengan Eclipse

Ikuti langkah-langkah berikut untuk men-debug sesi trading yang dimulai dari jarak jauh Command line tradefed.sh:

1. Mulai tradefed.sh dengan flag debug: TF_DEBUG=1 tradefed.sh
2. Tunggu hingga Anda melihat perintah ini dari JVM: Listening for transport dt_socket at address: 10088 Ini berarti JVM sedang menunggu debugger untuk pasang pada porta 10088.
3. Lampirkan dengan proses debug jarak jauh Eclipse dari menu utama: Pilih Run > Men-debug Konfigurasi....
4. Dalam dialog pop-up, pilih Remote Java Application dari menu kiri.
5. Klik ikon New launch configuration di panel tindakan.
6. Beri nama konfigurasi sesuai keinginan Anda dan pilih tradefederation sebagai proyek.
7. Isi port menggunakan alamat yang diberikan sebelumnya.
8. Beralihlah ke tab Source dan tambahkan tradefederation project dan google-tradefed ke Jalur Pencarian Sumber.
9. Klik Debug untuk memulai sesi proses debug.

Debugger melekat pada proses JVM yang mendengarkan, dan terminal yang berjalan tradefed.sh menampilkan perintah tf>.

Untuk menelusuri kode Anda dalam mode debug, tetapkan titik jeda di Eclipse dan panggil perintah Tradefed Anda (yaitu run <test>) di terminal. Untuk men-debug apa pun selama startup TF, Anda bisa mengatur titik jeda terlebih dahulu dan kemudian melampirkan Eclipse debugger.

TIPS: Untuk menggunakan port alternatif, tambahkan TF_DEBUG_PORT=nnn ke perintah di langkah 1 di atas. Anda bahkan bisa menggunakannya di lingkungan produksi jika Anda memiliki misteri menggantung bug untuk diselidiki: ubah suspend=y menjadi suspend=n dalam tradefed.sh dan mulailah dengan penanda debug. JVM tidak akan menunggu debugger terpasang, tetapi Anda dapat melakukannya jadi kapan saja, selama proses masih berjalan.

Debug jarak jauh menggunakan JDB

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

1. Mulai tradefed.sh dengan tanda debug: TF_DEBUG=1 tradefed.sh
2. Tunggu hingga Anda melihat perintah 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 selesai. Jalankan man jdb untuk mendapatkan bantuan lebih lanjut.

Memeriksa cakupan kode

1. Instal plugin Eclemma.
2. Buka Help > Install New Software dan arahkan wizardnya ke: http://update.eclemma.org/
3. Setelah diinstal, pilih Cakupan Sebagai > Opsi pengujian JUnit untuk melakukan cakupan kode.