Bắt đầu thử nghiệm với hệ thống tích hợp liên tục (CI)

Bạn có thể sử dụng Phòng thí nghiệm kiểm tra Firebase khi phát triển ứng dụng của mình bằng bất kỳ hệ thống tích hợp liên tục (CI) nào. Hệ thống tích hợp liên tục cho phép bạn tự động xây dựng và thử nghiệm ứng dụng của mình mỗi khi bạn kiểm tra các bản cập nhật cho mã nguồn ứng dụng của mình.

Sử dụng Phòng thí nghiệm kiểm tra Firebase với Jenkins CI

Phần này mô tả cách sử dụng Test Lab với Jenkins CI .

Yêu cầu

Trước khi có thể sử dụng Phòng thí nghiệm kiểm tra Firebase với Jenkins, bạn cần hoàn thành các bước sau:

  1. Thiết lập gcloud. Làm theo hướng dẫn từ Sử dụng Phòng thí nghiệm kiểm tra Firebase từ Dòng lệnh gcloud để tạo dự án Firebase và định cấu hình môi trường Google Cloud SDK cục bộ của bạn.

  2. Tạo và ủy quyền một tài khoản dịch vụ. Các tài khoản dịch vụ không bị kiểm tra thư rác hoặc lời nhắc xác thực, những điều này có thể chặn các bản dựng CI của bạn. Tạo một tài khoản dịch vụ có vai trò Biên tập viên trong bảng điều khiển Google Cloud rồi kích hoạt tài khoản đó (xem tài liệu gcloud auth activate-service-account để tìm hiểu cách thực hiện).

  3. Kích hoạt các API cần thiết. Sau khi đăng nhập bằng tài khoản dịch vụ: Trong trang Thư viện API Google Developers Console , hãy bật API kiểm tra đám mây của GoogleAPI kết quả của công cụ đám mây . Để bật các API này, hãy nhập các tên API này vào hộp tìm kiếm ở đầu bảng điều khiển, sau đó nhấp vào Bật API trên trang tổng quan cho API đó.

Cài đặt và thiết lập Jenkins

Bạn có thể cài đặt và thiết lập Jenkins CI trên Linux hoặc Windows. Một số chi tiết nhất định của hướng dẫn này dành riêng cho việc cài đặt và chạy Jenkins CI trên Linux, bao gồm cả việc sử dụng dấu gạch chéo ( / ) trong đường dẫn tệp.

Để tải xuống và cài đặt Jenkins trên máy tính chạy Linux hoặc Windows, hãy làm theo hướng dẫn trên Cài đặt Jenkins . Sau khi cài đặt Jenkins, hãy làm theo hướng dẫn trên Khởi động và truy cập Jenkins để hoàn tất thiết lập và truy cập bảng thông tin Jenkins.

Định cấu hình cài đặt bảo mật toàn cầu

Jenkins không định cấu hình xác thực người dùng và kiểm soát truy cập khi cài đặt lần đầu. Trước khi sử dụng Jenkins với Phòng thí nghiệm kiểm tra Firebase, hãy định cấu hình cài đặt bảo mật toàn cầu để thực thi kiểm soát truy cập và xác thực người dùng.

Để định cấu hình cài đặt bảo mật toàn cầu

  1. Điều hướng đến bảng điều khiển Jenkins trên máy chủ của bạn. Để thực hiện việc này, hãy duyệt đến http://<servername>:8080 , trong đó <servername> là tên của máy tính mà bạn đã cài đặt Jenkins.
  2. Trên bảng điều khiển Jenkins, nhấp vào Quản lý Jenkins , sau đó nhấp vào Định cấu hình bảo mật toàn cầu .
  3. Trên trang Định cấu hình bảo mật toàn cầu , nhấp vào Bật bảo mật rồi nhấp vào Lưu .

Để biết thêm thông tin về cách định cấu hình cài đặt bảo mật cho Jenkins, hãy xem Bảo mật nhanh chóng và đơn giản , Thiết lập bảo mật tiêu chuẩnBảo mật Jenkins .

Tạo một dự án Jenkins

Tiếp theo, tạo một dự án để chạy thử nghiệm tích hợp liên tục cho ứng dụng của bạn với Phòng thí nghiệm kiểm tra Firebase.

Để tạo một dự án Jenkins

  1. Điều hướng đến bảng điều khiển Jenkins trên máy chủ của bạn. Để thực hiện việc này, hãy duyệt đến http://<servername>:8080 , trong đó <servername> là tên của máy tính mà bạn đã cài đặt Jenkins.
  2. Trên bảng điều khiển Jenkins, nhấp vào Mục mới .
  3. Nhập tên cho dự án của bạn vào trường Tên mục :
    • Chọn dự án Freestyle để tạo dự án sử dụng một cấu hình bản dựng duy nhất.
    • Chọn Xây dựng dự án đa cấu hình để tạo dự án chạy trên nhiều cấu hình bản dựng khác nhau. Nếu bạn dự định xây dựng ứng dụng của mình với nhiều cấu hình xây dựng khác nhau (nhiều ngôn ngữ, nhiều cấp độ API Android, v.v.), thì dự án nhiều cấu hình là lựa chọn tốt nhất.
  4. Nhấp vào để lưu .

Sau khi dự án của bạn được tạo, trình duyệt web của bạn sẽ hiển thị trang chính cho dự án của bạn.

Thêm các bước kiểm soát sửa đổi và xây dựng Gradle

Phần này mô tả cách tích hợp Jenkins với các hệ thống kiểm soát sửa đổi như GitHub và cách thêm các bước xây dựng Gradle để xây dựng các gói APK từ mã nguồn.

Tích hợp với GitHub và các hệ thống kiểm soát sửa đổi khác

Nếu sử dụng GitHub hoặc hệ thống kiểm soát sửa đổi khác để quản lý mã nguồn cho ứng dụng của mình, bạn có thể định cấu hình Jenkins để chạy các bản dựng tự động và chạy thử nghiệm mỗi khi kiểm tra các bản cập nhật cho ứng dụng của bạn. Bạn cũng có thể định cấu hình Jenkins để chạy các bản dựng theo định kỳ.

Để tìm hiểu về cách định cấu hình bản dựng trong Jenkins, hãy xem Định cấu hình bản dựng tự động .

Thêm các bước xây dựng Gradle để xây dựng lại gói APK

Nếu sử dụng hệ thống kiểm soát sửa đổi để quản lý mã nguồn cho ứng dụng của mình, bạn cần bao gồm bước xây dựng Gradle để tạo các tệp nhị phân APK mới mỗi khi Jenkins tải mã nguồn xuống từ hệ thống kiểm soát sửa đổi của bạn.

  1. Thêm bước xây dựng để chạy các lệnh sau trong thư mục chính cho ứng dụng của bạn:

    ./gradlew :app:assembleDebug
    ./gradlew :app:assembleDebugAndroidTest
    

  2. Thêm bước xây dựng để sử dụng (các) gói APK do Gradle tạo khi thử nghiệm với Test Lab. Bạn có thể sử dụng đường dẫn này làm <local_server_path> trong ví dụ về tập lệnh shell được cung cấp bên dưới, trong đó <AppFolder> là thư mục dự án Android Studio cho ứng dụng của bạn:

    <AppFolder>/app/build/outputs/apk
    

Thêm các bước xây dựng Test Lab vào Jenkins

Bây giờ bạn đã sẵn sàng thêm bước xây dựng vào Jenkins để chạy Test Lab bằng dòng lệnh gcloud.

Để thêm bước xây dựng gcloud

  1. Từ trang chính cho dự án của bạn, nhấp vào Cấu hình .
  2. Trên trang cấu hình dự án , cuộn xuống phần Xây dựng , sau đó chọn Thực thi shell từ menu Thêm bước xây dựng .

  3. Trong cửa sổ lệnh shell Jenkins Thực thi , hãy nhập thông tin sau, thay thế <local_server_path> cho đường dẫn đến ứng dụng mẫu trên máy chủ, <app_apk> cho APK của ứng dụng của bạn và <app_test_apk> cho APK thử nghiệm của ứng dụng của bạn:

    gcloud firebase test android run --app <local_server_path>/<app_apk>.apk
    --test <local_server_path>/<app_test_apk>.apk
    

Phân tích kết quả kiểm tra

Sau khi Test Lab hoàn tất quá trình thử nghiệm ứng dụng của bạn, bạn có thể xem lại kết quả thử nghiệm trong bảng điều khiển Firebase hoặc trong nhóm Google Cloud Storage trong dự án của mình. Bạn cũng có thể thêm lệnh gsutil vào lệnh shell được hiển thị ở trên để sao chép dữ liệu kết quả kiểm tra vào máy tính cục bộ của bạn. Để tìm hiểu thêm, hãy xem Phân tích kết quả phòng thí nghiệm kiểm tra Firebase .

Tích hợp liên tục với các hệ thống CI khác

Để tìm hiểu cách sử dụng Phòng thí nghiệm kiểm tra Firebase với các hệ thống CI khác, hãy xem tài liệu của họ: