Thiết lập Eclipse

Hãy làm theo các bước sau để thiết lập Tradefed bằng Eclipse.

Tạo không gian làm việc riêng để phát triển Liên đoàn Thương mại, không sử dụng lại không gian làm việc đã được sử dụng để phát triển thiết bị Android.

Nếu cần, bạn có thể tải xuống Eclipse IDE dành cho nhà phát triển Java từ: Eclipse.org/downloads

Tạo dự án

  1. Chạy make một lần từ dòng lệnh. Điều này sẽ xây dựng các thư viện bên ngoài phụ thuộc vào các dự án bên dưới.
  2. Đặt biến đường dẫn lớp TRADEFED_ROOT trong Window > Preferences > Java > Build Path> Classpath Variables và trỏ nó vào thư mục gốc nguồn được giao dịch của bạn
  3. Đặt biến đường dẫn TRADEFED_ROOT trong Window > Preferences > General > Workspace > Linked Resources và trỏ nó tới thư mục gốc nguồn được giao dịch của bạn

  4. Sử dụng trình File > Import...-> General > Existing Projects into workspace" để đưa các dự án Java nguồn mở này vào các đường dẫn sau:

    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. Theo tùy chọn, nếu bạn muốn xem mã nguồn ddmlib , hãy đính kèm mã nguồn từ một nhánh công cụ chưa được nhóm lại, chẳng hạn như /platform/tools/base/tools_r22/ddmlib/src/main/java/com/android/ddmlib/IDevice.java .

  6. Theo tùy chọn, nếu bạn cũng muốn tải các dự án khai thác CTS, hãy nhập:

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

Định dạng tự động

LƯU Ý: Các tệp cần thiết nằm trong development/ide/eclipse trong cây nguồn nền tảng đầy đủ. Vì vậy, bạn sẽ cần kiểm tra một nhánh nền tảng, chẳng hạn như main để lấy các tệp này: /development/main/ide/eclipse/

Sử dụng các tệp ưu tiên trong Eclipse để tự động đặt trình định dạng thành hướng dẫn kiểu Android. Để thực hiện việc này trong Studio:

  1. Chuyển đến Cửa sổ > Tùy chọn > Java > Kiểu mã .
  2. Trong Formatter , nhập tệp android-formatting.xml .
  3. Trong Sắp xếp > Nhập , hãy nhập tệp android.importorder .

Xóa khoảng trắng ở cuối

Để buộc Eclipse xóa tất cả khoảng trắng ở cuối:

  1. Chuyển đến Cửa sổ > Tùy chọn -> Java -> Trình chỉnh sửa -> Lưu hành động .
  2. Sau đó, Hành động bổ sung -> Định cấu hình -> Mã > tab Sắp xếp -> Trình định dạng .
  3. Kiểm tra Xóa khoảng trắng ở cuối .
  4. Nhấp vào Áp dụng và Đóng .

Kiểm tra kiểu mã

Khi gửi danh sách thay đổi, hook tải lên trước tự động sẽ chạy để kiểm tra định dạng mã của bạn: google-java-format

Điều này giúp định dạng mã của bạn theo tiêu chuẩn chung.

Gỡ lỗi Eclipse

Nếu bạn muốn chạy mã TF thông qua trình gỡ lỗi trong Eclipse, trước tiên bạn nên tạo một bài kiểm tra đơn vị cho mã được đề cập vì đây sẽ là cách đơn giản và nhanh nhất để thực hiện chức năng.

Để gỡ lỗi bài kiểm tra đơn vị TF, chỉ cần nhấp chuột phải vào nó và chọn Debug As > JUnit test .

Để gỡ lỗi kiểm tra chức năng TF, hãy làm theo hướng dẫn trong phần trước để chạy kiểm tra chức năng nhưng sử dụng menu Chạy > Cấu hình gỡ lỗi .

Để gỡ lỗi chương trình TF, khi chạy bất kỳ cấu hình nào, hãy làm theo hướng dẫn trong phần trước để chạy thử nghiệm chức năng nhưng cung cấp các đối số dòng lệnh cho cấu hình bạn muốn chạy ở bước 4. Vì vậy, để gỡ lỗi cấu hình 'công cụ', đi tới menu Cấu hình Chạy > Gỡ lỗi và đặt tab Đối số trong cấu hình gỡ lỗi Eclipse thành -- package <package to run> instrument .

Gỡ lỗi từ xa với Eclipse

Hãy làm theo các bước sau để gỡ lỗi từ xa phiên giao dịch được bắt đầu từ dòng lệnh tradefed.sh :

  1. Bắt đầu Tradefed.sh với cờ gỡ lỗi: TF_DEBUG=1 tradefed.sh
  2. Đợi cho đến khi bạn thấy lời nhắc này từ JVM: Listening for transport dt_socket at address: 10088 Điều này có nghĩa là JVM đang chờ trình gỡ lỗi đính kèm tại cổng 10088 .
  3. Đính kèm tính năng gỡ lỗi từ xa của Eclipse từ menu chính: Chọn Chạy > Cấu hình gỡ lỗi... .
  4. Trong hộp thoại bật lên, chọn Ứng dụng Java từ xa từ menu bên trái.
  5. Nhấp vào biểu tượng Cấu hình khởi chạy mới trên thanh hành động.
  6. Đặt tên cho cấu hình theo ý muốn của bạn và chọn liên đoàn thương mại làm dự án.
  7. Điền vào cổng bằng địa chỉ được cung cấp trước đó.
  8. Chuyển sang tab Nguồn và thêm liên đoàn thương mại của dự án và được google-tradefed vào Đường dẫn tra cứu nguồn .
  9. Nhấp vào Gỡ lỗi để bắt đầu phiên gỡ lỗi.

Trình gỡ lỗi gắn vào quy trình JVM đang nghe và thiết bị đầu cuối đang chạy tradefed.sh hiển thị dấu nhắc tf> .

Để xem qua mã của bạn ở chế độ gỡ lỗi, hãy đặt điểm ngắt trong Eclipse và gọi lệnh Tradefed của bạn (tức là run <test> ) trong thiết bị đầu cuối. Để gỡ lỗi mọi thứ trong quá trình khởi động TF, trước tiên bạn có thể đặt điểm dừng rồi đính kèm trình gỡ lỗi Eclipse.

MẸO: Để sử dụng một cổng thay thế, hãy thêm TF_DEBUG_PORT=nnn vào lệnh ở bước 1 ở trên. Bạn thậm chí có thể sử dụng điều này trong môi trường sản xuất nếu bạn có lỗi treo bí ẩn cần điều tra: thay đổi suspend=y thành suspend=n trong tradefed.sh và bắt đầu bằng cờ gỡ lỗi. JVM sẽ không đợi trình gỡ lỗi đính kèm nhưng bạn có thể làm như vậy bất kỳ lúc nào miễn là quá trình này vẫn đang chạy.

Gỡ lỗi từ xa bằng JDB

Để sử dụng JDB của Trình gỡ lỗi Java, hãy làm theo các bước tương tự như các bước dành cho Eclipse:

  1. Bắt đầu tradefed.sh với cờ gỡ lỗi: TF_DEBUG=1 tradefed.sh
  2. Đợi cho đến khi bạn thấy lời nhắc từ JVM: Listening for transport dt_socket at address: 10088 .

  3. Kết nối jdb . Ví dụ: từ croot chạy:

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

  4. Đợi kết nối và gỡ lỗi! Chạy man jdb để được trợ giúp thêm.

Kiểm tra phạm vi bảo hiểm của mã

  1. Cài đặt plugin Eclemma .
  2. Đi tới Trợ giúp > Cài đặt Phần mềm Mới và trỏ trình hướng dẫn tới: http://update.eclemma.org/
  3. Sau khi cài đặt, hãy chọn tùy chọn Coverage As > JUnit test để tiến hành chạy phạm vi mã.