Google cam kết thúc đẩy công bằng chủng tộc cho các cộng đồng Đen. Xem thế nào.
Trang này được dịch bởi Cloud Translation API.
Switch to English

Thêm một ví dụ kiểm tra bản địa mới

Nếu bạn chưa quen với việc phát triển nền tảng Android, bạn có thể thấy ví dụ hoàn chỉnh này về việc thêm một thử nghiệm gốc hoàn toàn mới từ đầu hữu ích để chứng minh quy trình công việc điển hình có liên quan. Ngoài ra, nếu bạn cũng không quen thuộc với khung gtest cho C ++, vui lòng xem lại trang web dự án gtest để có thêm tài liệu.

Hướng dẫn này sử dụng thử nghiệm sau để phục vụ như một mẫu:

Xin chào thế giới kiểm tra bản địa

Bạn nên duyệt qua mã trước để có ấn tượng sơ bộ trước khi tiếp tục.

Quyết định vị trí nguồn

Thông thường, nhóm của bạn sẽ có một mẫu địa điểm được thiết lập để kiểm tra mã và địa điểm để thêm các bài kiểm tra. Hầu hết các nhóm sở hữu một kho lưu trữ git duy nhất hoặc chia sẻ một nhóm với các nhóm khác nhưng có một thư mục con chuyên dụng có chứa mã nguồn thành phần.

Giả sử vị trí gốc cho nguồn thành phần của bạn là tại <component source root> , hầu hết các thành phần đều có srctests các thư mục bên dưới nó và một số tệp bổ sung như Android.mk (hoặc được chia thành các tệp .bp bổ sung).

Vì bạn đang thêm một thử nghiệm hoàn toàn mới, có lẽ bạn sẽ cần phải tạo thư mục tests bên cạnh src thành phần của bạn và điền nó vào nội dung.

Trong một số trường hợp, nhóm của bạn có thể có các cấu trúc thư mục tiếp theo trong tests do nhu cầu đóng gói các bộ thử nghiệm khác nhau vào các nhị phân riêng lẻ. Và trong trường hợp này, bạn sẽ cần tạo một thư mục con mới trong tests .

Để minh họa, đây là một phác thảo thư mục điển hình cho các thành phần với một thư mục tests duy nhất:

 \
 <component source root>
  \-- Android.bp (component makefile)
  \-- AndroidTest.xml (test config file)
  \-- src (component source)
  |    \-- foo.cpp
  |    \-- ...
  \-- tests (test source root)
      \-- Android.bp (test makefile)
      \-- src (test source)
          \-- foo_test.cpp
          \-- ...
 

và đây là một phác thảo thư mục điển hình cho các thành phần có nhiều thư mục nguồn thử nghiệm:

 \
 <component source root>
  \-- Android.bp (component makefile)
  \-- AndroidTest.xml (test config file)
  \-- src (component source)
  |    \-- foo.cpp
  |    \-- ...
  \-- tests (test source root)
      \-- Android.bp (test makefile)
      \-- testFoo (sub test source root)
      |   \-- Android.bp (sub test makefile)
      |   \-- src (sub test source)
      |       \-- test_foo.cpp
      |       \-- ...
      \-- testBar
      |   \-- Android.bp
      |   \-- src
      |       \-- test_bar.cpp
      |       \-- ...
      \-- ...
 

Bất kể cấu trúc nào, cuối cùng bạn sẽ điền vào thư mục tests hoặc thư mục con mới được tạo với các tệp tương tự như trong thư mục native trong thay đổi gerrit mẫu. Các phần dưới đây sẽ giải thích chi tiết hơn về mỗi tệp.

Mã nguồn

Xem bài kiểm tra Hello World Native để biết ví dụ.

Mã nguồn chú thích được liệt kê dưới đây:

 #include <gtest/gtest.h>
 

Tập tin tiêu đề bao gồm cho gtest. Lưu ý rằng sự phụ thuộc tệp bao gồm được tự động giải quyết bằng cách sử dụng BUILD_NATIVE_TEST trong BUILD_NATIVE_TEST hiện

 #include <stdio.h>

TEST(HelloWorldTest, PrintHelloWorld) {
    printf("Hello, World!");
}
 

gtests được viết bằng cách sử dụng macro TEST : tham số đầu tiên là tên trường hợp thử nghiệm và thứ hai là tên thử nghiệm; cùng với tên nhị phân thử nghiệm, chúng tạo thành hệ thống phân cấp bên dưới khi được hiển thị trong bảng điều khiển kết quả:

 <test binary 1>
| \-- <test case 1>
| |   \-- <test 1>
| |   \-- <test 2>
| |   \-- ...
| \-- <test case 2>
| |   \-- <test 1>
| |   \-- ...
| \-- ...
<test binary 2>
|
...
 

Để biết thêm thông tin về viết bài kiểm tra với gtest, xem tài liệu của nó:

  • https://github.com/google/googletest/blob/master/googletest/docs/Primer.md

Tập tin cấu hình đơn giản

Mỗi mô-đun thử nghiệm mới phải có tệp cấu hình để chỉ đạo hệ thống xây dựng với siêu dữ liệu mô-đun, phụ thuộc thời gian biên dịch và hướng dẫn đóng gói. Trong hầu hết các trường hợp, tùy chọn tệp Blueprint dựa trên Soong là đủ. Xem Cấu hình kiểm tra đơn giản để biết chi tiết.

Tập tin cấu hình phức tạp

Thay vào đó, để sử dụng Liên đoàn thương mại, hãy viết tệp cấu hình thử nghiệm cho khai thác thử nghiệm của Android, Liên đoàn thương mại .

Cấu hình thử nghiệm có thể chỉ định các tùy chọn thiết lập thiết bị đặc biệt và các đối số mặc định để cung cấp lớp thử nghiệm.

Xây dựng và thử nghiệm cục bộ

Đối với các trường hợp sử dụng phổ biến nhất, sử dụng Atest .

Đối với các trường hợp phức tạp hơn đòi hỏi tùy chỉnh nặng hơn, hãy làm theo các hướng dẫn thiết bị .