設定 Eclipse

請按照下列步驟，使用 Eclipse 設定 Tradefed。

建立獨立工作區來開發貿易聯盟，請勿重複使用已用於 Android 裝置開發作業的工作區。

如有需要，您可以從 eclipse.org/downloads 下載 Eclipse IDE for Java developers。

建立專案

  1. 透過指令列執行 make 一次。這會建構下列專案所依附的外部程式庫。
  2. 在 Window > Preferences > Java > Build Path> Classpath Variables 中設定 TRADEFED_ROOT 類別路徑變數，並將其指向 tradefed 來源根目錄
  3. 在 Window > Preferences > General > Workspace > Linked Resources 中設定 TRADEFED_ROOT 路徑變數，並將其指向 tradefed 來源根目錄

  4. 使用 File > Import...-> General > Existing Projects into workspace" 精靈，將這些開放原始碼 Java 專案導入下列路徑：

    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. 視需要，如果您想查看 ddmlib 原始碼，請附加未內含工具分支的原始碼，例如 /platform/tools/base/tools_r22/ddmlib/src/main/java/com/android/ddmlib/IDevice.java。

  6. 您也可以選擇匯入 CTS 束帶專案，方法如下：

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

自動格式

注意：必要檔案會位於完整平台來源樹狀結構中的 development/ide/eclipse 內。因此，您需要檢出 main 等平台分支，才能取得這些檔案：/development/main/ide/eclipse/

使用 Eclipse 中的偏好設定檔，自動將格式化工具設為 Android 樣式指南。如要在 Studio 中執行此操作：

  1. 依序前往「Window」>「Preferences」>「Java」>「Code Style」。
  2. 在「Formatter」下方，匯入 android-formatting.xml 檔案。
  3. 在「整理」>「匯入」下方，匯入檔案 android.importorder。

移除結尾的空白字元

如何強制 Eclipse 移除所有結尾的空白字元：

  1. 依序前往「Window」>「Preferences」->「Java」->「Editor」->「Save Actions」。
  2. 然後依序點選「Additional Actions」->「Configure」->「Code」->「Organizing」分頁標籤->「Formatter」。
  3. 勾選「移除結尾空格」。
  4. 按一下「套用並關閉」。

檢查程式碼樣式

提交變更清單時，系統會執行自動預先上傳掛鉤來檢查程式碼格式：google-java-format

這有助於將程式碼格式化為常見標準。

偵錯 Eclipse

如果您想透過 Eclipse 中的偵錯工具執行 TF 程式碼，建議您先為問題程式碼建立單元測試，因為這是執行功能最簡單且最快速的方式。

如要對 TF 單元測試偵錯，只要在測試上按一下滑鼠右鍵，然後依序選取「Debug As」>「JUnit 測試」即可。

如要對 TF 功能測試進行偵錯，請按照上一節的操作說明執行功能測試，但請使用「Run」>「Debug configuration」選單。

如要對 TF 程式本身進行偵錯，請在執行任何設定時，按照前一個章節中執行功能測試的操作說明操作，但請為您想在步驟 4 中執行的設定提供指令列引數。因此，如要對「instrument」設定進行偵錯，請前往「Run」>「Debug configuration」選單，並將 Eclipse 偵錯設定中的「Arguments」分頁設為 -- package <package to run> instrument。

使用 Eclipse 進行遠端偵錯

請按照下列步驟，從遠端對透過 tradefed.sh 指令列啟動的交易工作階段進行偵錯：

  1. 使用偵錯旗標啟動 tradefed.sh：TF_DEBUG=1 tradefed.sh
  2. 請等到您看到 JVM 的提示訊息：Listening for transport dt_socket at address: 10088 這表示 JVM 正在等待偵錯工具連結至 10088 通訊埠。
  3. 從主選單中選取 Eclipse 的遠端偵錯功能：依序選取「Run」>「Debug Configurations...」。
  4. 在彈出式對話方塊中，從左選單中選取「遠端 Java 應用程式」。
  5. 按一下動作列中的「New launch configuration」圖示。
  6. 為設定命名，並選取「tradefederation」做為專案。
  7. 使用稍早提供的位址填入通訊埠。
  8. 切換至「Source」分頁，然後將「tradefederation」和「google-tradefed」專案新增至「Source Lookup Path」。
  9. 按一下「Debug」，開始偵錯工作階段。

偵錯工具會附加至偵聽 JVM 程序，而執行 tradefed.sh 的終端機會顯示 tf> 提示。

如要在偵錯模式中逐步執行程式碼，請在 Eclipse 中設定中斷點，然後在終端機中叫用 Tradefed 指令 (即 run <test>)。如要在 TF 啟動期間對任何內容進行偵錯，您可以先設定中斷點，然後附加 Eclipse 偵錯工具。

提示：如要使用其他連接埠，請在上述步驟 1 的指令中加入 TF_DEBUG_PORT=nnn。如果您有需要調查的神秘掛起錯誤，也可以在實際工作環境中使用這個方法：在 tradefed.sh 中將 suspend=y 變更為 suspend=n，並以偵錯標記開始。JVM 不會等待系統附加偵錯工具，但只要程序仍在執行，您隨時都可以這麼做。

使用 JDB 進行遠端偵錯

如要使用 Java Debugger JDB，請按照 Eclipse 的步驟操作：

  1. 使用偵錯標記啟動 tradefed.sh：TF_DEBUG=1 tradefed.sh
  2. 等到您看到 JVM 提示：Listening for transport dt_socket at address: 10088。

  3. 連結 jdb。例如，從 croot 執行：

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

  4. 等待連線並進行偵錯！執行 man jdb 以取得進一步協助。

檢查程式碼涵蓋率

  1. 安裝 Eclemma 外掛程式。
  2. 依序前往「Help」>「Install New Software」，並將精靈指向以下網址：http://update.eclemma.org/
  3. 安裝完成後，請選取「Coverage As > JUnit」測試選項，執行程式碼涵蓋率。