Eclipse'i kurun

Eclipse kullanarak Tradefed'i kurmak için aşağıdaki adımları izleyin.

Ticaret Federasyonu'nu geliştirmek için ayrı bir çalışma alanı oluşturun, halihazırda Android cihaz geliştirme için kullanılan bir çalışma alanını yeniden kullanmayın.

Gerekirse Java geliştiricileri için Eclipse IDE'yi şu adresten indirebilirsiniz: eclipse.org/downloads

Proje oluştur

1. Make komutunu komut satırından bir kez çalıştırın. Bu, aşağıdaki projelere bağlı olarak harici kütüphaneler oluşturacaktır.
2. TRADEFED_ROOT sınıf yolu değişkenini Window > Preferences > Java > Build Path> Classpath Variables ayarlayın ve bunu takas edilen kaynak kökünüze yönlendirin
3. TRADEFED_ROOT yol değişkenini Window > Preferences > General > Workspace > Linked Resources ayarlayın ve bunu takas edilen kaynak kökünüze yönlendirin

4. Bu açık kaynaklı Java projelerini aşağıdaki yollara getirmek için File > Import...-> General > Existing Projects into workspace" sihirbazını kullanın:

   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. İsteğe bağlı olarak, ddmlib kaynak kodunu görmek istiyorsanız, /platform/tools/base/tools_r22/ddmlib/src/main/Java/com/android/ddmlib/IDevice.java gibi ayrıştırılmış bir araç dalından kaynak kodunu ekleyin.

6. İsteğe bağlı olarak, CTS donanım projelerinin de yüklenmesini istiyorsanız şunları içe aktarın:

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

Otomatik format

NOT: Gerekli dosyalar, tam platform kaynak ağacındaki development/ide/eclipse içinde bulunur. Bu dosyaları almak için main gibi bir platform dalına göz atmanız gerekecek: /development/main/ide/Eclipse/

Biçimlendiriciyi otomatik olarak Android stil kılavuzuna ayarlamak için Eclipse'deki tercih dosyalarını kullanın. Bunu Studio'da yapmak için:

1. Pencere > Tercihler > Java > Kod Stili'ne gidin.
2. Formatlayıcı altında android-formatting.xml dosyasını içe aktarın.
3. Organize Et > İçe Aktarmalar altında android.importorder dosyasını içe aktarın.

Sondaki boşlukları kaldır

Eclipse'i sondaki tüm boşlukları kaldırmaya zorlamak için:

1. Pencere > Tercihler -> Java -> Düzenleyici -> Eylemleri Kaydet seçeneğine gidin.
2. Daha sonra Ek Eylemler -> Yapılandır -> Kod > Düzenleme sekmesi -> Biçimlendirici .
3. Sondaki Boşlukları Kaldır seçeneğini işaretleyin.
4. Uygula ve Kapat'ı tıklayın.

Kod stilini kontrol edin

Bir değişiklik listesi gönderirken, kod formatınızı kontrol etmek için otomatik bir ön yükleme kancası çalışacaktır: google-java-format

Bu, kodunuzu ortak standartta biçimlendirmenize yardımcı olur.

Eclipse'de hata ayıklama

TF kodunu Eclipse'deki bir hata ayıklayıcı aracılığıyla çalıştırmak istiyorsanız, öncelikle söz konusu kod için bir birim testi oluşturmanız önerilir; çünkü bu, işlevselliği uygulamanın en basit ve en hızlı yolu olacaktır.

Bir TF birim testinde hata ayıklamak için, üzerine sağ tıklayın ve Debug As > JUnit test öğesini seçin.

Bir TF işlevsel testinde hata ayıklamak için, önceki bölümde işlevsel test çalıştırma talimatlarını izleyin ancak Çalıştır > Yapılandırmalarda hata ayıklama menüsünü kullanın.

TF programının kendisinde hata ayıklamak için, herhangi bir konfigürasyonu çalıştırırken, önceki bölümde işlevsel test çalıştırma talimatlarını izleyin ancak 4. adımda çalıştırmak istediğiniz konfigürasyon için komut satırı argümanlarını sağlayın. Yani 'araç' konfigürasyonunda hata ayıklamak için, Çalıştır > Hata ayıklama yapılandırma menüsüne gidin ve Eclipse hata ayıklama yapılandırmasındaki Bağımsız Değişkenler sekmesini -- package <package to run> instrument ayarlayın.

Eclipse ile uzaktan hata ayıklama

tradefed.sh komut satırından başlatılan tradefed oturumunda uzaktan hata ayıklamak için şu adımları izleyin:

1. tradefed.sh'yi hata ayıklama bayrağıyla başlatın: TF_DEBUG=1 tradefed.sh
2. JVM'den şu istemi görene kadar bekleyin: Listening for transport dt_socket at address: 10088 Bu, JVM'nin hata ayıklayıcının 10088 bağlantı noktasına eklenmesini beklediği anlamına gelir.
3. Ana menüden Eclipse'in uzaktan hata ayıklamasını kullanarak ekleyin: Çalıştır > Yapılandırmalarda Hata Ayıklama... öğesini seçin.
4. Açılan iletişim kutusunda soldaki menüden Uzak Java Uygulaması'nı seçin.
5. Eylem çubuğunda Yeni başlatma yapılandırması simgesini tıklayın.
6. Yapılandırmayı istediğiniz gibi adlandırın ve proje olarak ticaret federasyonunu seçin.
7. Daha önce verilen adresi kullanarak bağlantı noktasını doldurun.
8. Kaynak sekmesine geçin ve tradefederation ve google-tradefed projelerini Kaynak Arama Yolu'na ekleyin.
9. Hata ayıklama oturumunu başlatmak için Hata Ayıkla'yı tıklayın.

Hata ayıklayıcı, dinleme JVM işlemine eklenir ve tradefed.sh çalıştıran terminal tf> istemini gösterir.

Hata ayıklama modunda kodunuzu adım adım ilerletmek için Eclipse'de bir kırılma noktası belirleyin ve terminalde Tradefed komutunuzu çağırın (yani run <test> ). TF başlatma sırasında herhangi bir hata ayıklamak için önce kırılma noktasını ayarlayabilir ve ardından Eclipse hata ayıklayıcısını ekleyebilirsiniz.

İPUCU: Alternatif bir bağlantı noktası kullanmak için yukarıdaki 1. adımdaki komuta TF_DEBUG_PORT=nnn ekleyin. Araştırılması gereken gizemli hatalar varsa bunu üretim ortamında bile kullanabilirsiniz: tradefed.sh suspend=y suspend=n olarak değiştirin ve hata ayıklama bayrağıyla başlayın. JVM hata ayıklayıcının eklenmesini beklemez ancak işlem hala çalıştığı sürece bunu istediğiniz zaman yapabilirsiniz.

JDB kullanarak uzaktan hata ayıklama

Java Hata Ayıklayıcı JDB'yi kullanmak için Eclipse'e benzer adımları izleyin:

1. tradefed.sh hata ayıklama bayrağıyla başlatın: TF_DEBUG=1 tradefed.sh
2. JVM'den gelen istemi görene kadar bekleyin: Listening for transport dt_socket at address: 10088 .

3. jdb bağlayın. Örneğin, croot çalıştırmasından:

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

4. Bağlantıyı bekleyin ve hata ayıklayın! Daha fazla yardım için man jdb komutunu çalıştırın.

Kod kapsamını inceleyin

1. Eclemma eklentisini yükleyin.
2. Yardım > Yeni Yazılım Yükle'ye gidin ve sihirbazı şu adrese yönlendirin: http://update.eclemma.org/
3. Kurulduktan sonra, bir kod kapsamı çalıştırması gerçekleştirmek için Kapsama Şekli > JUnit test seçeneğini seçin.