Eclipse'i kurma

Eclipse'i kullanarak Tradefed'i ayarlamak için aşağıdaki adımları uygulayın.

Ticaret Federasyonu'nu geliştirmek için ayrı bir çalışma alanı oluşturun. Android cihaz geliştirme için zaten kullanılmış olan 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şturma

1. make komutunu komut satırından bir kez çalıştırın. Bu işlem, aşağıdaki projelere bağlı harici kitaplıklar oluşturur.
2. Window > Preferences > Java > Build Path> Classpath Variables hücresindeki TRADEFED_ROOT sınıf yolu değişkenini ayarlayın ve bunu işlem yapılan kaynak kökünüze yönlendirin
3. Window > Preferences > General > Workspace > Linked Resources içinde TRADEFED_ROOT yol değişkenini ayarlayın ve bunu işlem yapılan kaynak kökünüze yönlendirin

4. Aşağıdaki yolların altına bu açık kaynak Java projelerini 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 paketlenmemiş bir araç dalındaki kaynak kodunu ekleyin.

6. İsteğe bağlı olarak, CTS koşum takı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 biçim

NOT: Gerekli dosyalar, tam platform kaynak ağacında development/ide/eclipse içinde bulunur. Bu nedenle, aşağıdaki dosyaları almak için main gibi bir platform dalını kontrol etmeniz gerekir: /development/main/ide/eclipse/

Düzenleyiciyi Android stil kılavuzuna otomatik olarak ayarlamak için Eclipse'teki tercih dosyalarını kullanın. Studio'da bunu yapmak için:

1. Pencere > Tercihler > Java > Kod Stili'ne gidin.
2. Düzenleyici bölümünde android-formatting.xml dosyasını içe aktarın.
3. Düzenle > İçe aktarma bölümünde 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 -> İşlemleri Kaydet'e gidin.
2. Ardından Ek İşlemler -> Yapılandır -> Kod > Organize Etme sekmesi -> Biçimlendirici'yi tıklayın.
3. Sonundaki Boşlukları Kaldır'ı işaretleyin.
4. Uygula ve Kapat'ı tıklayın.

Kod stilini kontrol etme

Değişiklik listesi gönderirken, kod biçiminizi kontrol etmek için otomatik bir önceden yükleme kancası çalıştırılır: google-java-format

Bu, kodunuzu ortak standarda göre biçimlendirmenize yardımcı olur.

Eclipse'te hata ayıklama

TF kodunu Eclipse'te bir hata ayıklayıcı üzerinden çalıştırmak istiyorsanız işlevi kullanmanın en basit ve en hızlı yolu olduğu için önce söz konusu kod için bir birim testi oluşturmanız önerilir.

Bir TF birim testinde hata ayıklama yapmak için ilgili testi sağ tıklayın ve Hata Ayıklama Yöntemi > JUnit testi'ni seçin.

TF işlevsel testinde hata ayıklama yapmak için işlevsel test çalıştırmayla ilgili önceki bölümdeki talimatları uygulayın ancak Çalıştır > Yapılandırmaları hata ayıkla menüsünü kullanın.

TF programının kendisinde hata ayıklama yapmak için herhangi bir yapılandırmayı çalıştırırken işlevsel test çalıştırmayla ilgili önceki bölümdeki talimatları uygulayın ancak 4. adımda çalıştırmak istediğiniz yapılandırma için komut satırı bağımsız değişkenlerini sağlayın. Bu nedenle, "araç" yapılandırmasında hata ayıklamak için Çalıştır > Hata ayıklama yapılandırması menüsüne gidip Eclipse hata ayıklama yapılandırmasındaki Bağımsız değişkenler sekmesini -- package <package to run> instrument olarak ayarlayın.

Eclipse ile uzaktan hata ayıklama

tradefed.sh komut satırından başlatılan bir tradefed oturumunda uzaktan hata ayıklama yapmak için aşağıdaki adımları uygulayın:

1. tradefed.sh dosyasını hata ayıklama işaretiyle 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 bağlanmasını beklediği anlamına gelir.
3. Ana menüden Eclipse'in uzak hata ayıklama özelliğini kullanarak ekleme: Çalıştır > Hata Ayıklama Yapılandırmaları...'nı seçin.
4. Pop-up iletişim kutusunda, soldaki menüden Remote Java Application öğesini seçin.
5. İşlem çubuğundaki Yeni başlatma yapılandırması simgesini tıklayın.
6. Yapılandırmayı istediğiniz gibi adlandırın ve proje olarak tradefederation'ı seçin.
7. Daha önce sağlanan adresi kullanarak bağlantı noktasını doldurun.
8. Kaynak sekmesine geçin ve tradefederation ile 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 bağlanır ve tradefed.sh çalıştıran terminalde tf> istemi gösterilir.

Hata ayıklama modunda kodunuzu adım adım incelemek için Eclipse'te bir kesme noktası ayarlayın ve terminalde Tradefed komutunuzu (ör. run <test>) çağırın. TF'nin başlatılması sırasında herhangi bir şeyde hata ayıklama yapmak için önce durma 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ırmanız gereken gizemli asma hatalarınız varsa bunu üretim ortamında bile kullanabilirsiniz: tradefed.sh içinde suspend=y değerini suspend=n olarak değiştirin ve hata ayıklama işaretiyle başlayın. JVM, hata ayıklayıcının eklenmesini beklemez ancak işlem devam ettiği sürece bunu istediğiniz zaman yapabilirsiniz.

JDB kullanarak uzaktan hata ayıklama

Java hata ayıklayıcı JDB'yi kullanmak için Eclipse'tekilere benzer adımları uygulayın:

1. Hata ayıklama işaretiyle tradefed.sh'ü başlatın: TF_DEBUG=1 tradefed.sh
2. JVM'den gelen isteği görene kadar bekleyin: Listening for transport dt_socket at address: 10088.

3. jdb'e bağlanın. Örneğin, croot'tan şunu çalıştırın:

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

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

Kod kapsamını inceleme

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. Yüklendikten sonra kod kapsamı çalıştırmak için Kapsam Olarak > JUnit test seçeneğini belirleyin.