Phân phối ứng dụng iOS cho người kiểm thử bằng Firebase CLI

Bạn có thể phân phối bản dựng cho người thử nghiệm bằng Firebase CLI. Công cụ CLI cho phép bạn chỉ định người thử nghiệm và ghi chú phát hành cho một bản dựng, đồng thời phân phối bản dựng đó cho phù hợp.

Để phân phối ứng dụng cho người thử nghiệm, hãy tải tệp IPA lên bằng Firebase CLI:

1. Cài đặt hoặc cập nhật lên phiên bản mới nhất của Firebase CLI (bạn nên tải tệp nhị phân độc lập xuống cho CLI dành riêng cho hệ điều hành của mình). Đảm bảo đăng nhập và kiểm tra để có thể truy cập vào các dự án của mình.

2. Chạy lệnh appdistribution:distribute để tải ứng dụng lên và phân phối cho người thử nghiệm. Sử dụng các tham số sau để định cấu hình hoạt động phân phối:

   appdistribution:distribute options
   --app	Bắt buộc: Mã ứng dụng Firebase của ứng dụng. Bạn có thể tìm thấy Mã ứng dụng trong bảng điều khiểnFirebase, trên trang Cài đặt chung. --app 1:1234567890:ios:0a1b2c3d4e5f67890
   --token	Mã làm mới được in khi bạn xác thực môi trường CI bằng Firebase CLI (đọc Sử dụng CLI với hệ thống CI để biết thêm thông tin). --token "$FIREBASE_TOKEN"
   --release-notes --release-notes-file	Ghi chú phát hành cho bản dựng này. Bạn có thể chỉ định trực tiếp ghi chú phát hành: --release-notes "Text of release notes" Hoặc chỉ định đường dẫn đến một tệp văn bản thuần tuý: --release-notes-file "/path/to/release-notes.txt"
   --testers --testers-file	Địa chỉ email của những người thử nghiệm mà bạn muốn mời. Bạn có thể chỉ định người thử nghiệm dưới dạng danh sách địa chỉ email được phân tách bằng dấu phẩy: --testers "ali@example.com, bri@example.com, cal@example.com" Hoặc bạn có thể chỉ định đường dẫn đến một tệp văn bản thuần tuý chứa danh sách địa chỉ email được phân tách bằng dấu phẩy: --testers-file "/path/to/testers.txt"
   --groups --groups-file	Các nhóm người thử nghiệm mà bạn muốn mời (tham khảo bài viết Quản lý người thử nghiệm). Các nhóm được chỉ định bằng bí danh nhóm mà bạn có thể tra cứu trong bảng điều khiển Firebase. Bạn có thể chỉ định các nhóm dưới dạng danh sách được phân tách bằng dấu phẩy: --groups "qa-team, trusted-testers" Hoặc bạn có thể chỉ định đường dẫn đến một tệp văn bản thuần tuý chứa danh sách tên nhóm được phân tách bằng dấu phẩy: --groups-file "/path/to/groups.txt"
   --debug	Một cờ mà bạn có thể đưa vào để in đầu ra nhật ký chi tiết.
   --test-devices --test-devices-file	Các loại phân phối sau đây là một phần của Tính năng thử nghiệm tự động (phiên bản beta). Các thiết bị thử nghiệm mà bạn muốn phân phối bản dựng (tham khảo Kiểm thử tự động). Bạn có thể chỉ định người thử nghiệm dưới dạng danh sách địa chỉ email được phân tách bằng dấu phẩy: --test-devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait" Hoặc bạn có thể chỉ định đường dẫn đến một tệp văn bản thuần tuý chứa danh sách thiết bị thử nghiệm được phân tách bằng dấu chấm phẩy: --test-devices-file: "/path/to/test-devices.txt"
   --test-username	Tên người dùng để đăng nhập tự động được sử dụng trong quá trình kiểm thử tự động.
   --test-password --test-password-file	Mật khẩu để đăng nhập tự động được sử dụng trong quá trình kiểm thử tự động. Hoặc bạn có thể chỉ định đường dẫn đến một tệp văn bản thuần tuý chứa mật khẩu: --test-password-file: "/path/to/test-password.txt"
   --test-username-resource	Tên tài nguyên cho trường tên người dùng để đăng nhập tự động được sử dụng trong quá trình kiểm thử tự động.
   --test-password-resource	Tên tài nguyên cho trường mật khẩu để đăng nhập tự động được sử dụng trong quá trình kiểm thử tự động.
   --test-non-blocking	Chạy kiểm thử tự động không đồng bộ. Truy cập vào bảng điều khiển của Firebase để xem kết quả kiểm thử tự động.

   Ví dụ:

   firebase appdistribution:distribute test.ipa  \
       --app 1:1234567890:ios:0a1b2c3d4e5f67890  \
       --release-notes "Bug fixes and improvements" --testers-file testers.txt

   Firebase CLI xuất ra các đường liên kết sau khi tải bản phát hành lên. Các đường liên kết này giúp bạn quản lý tệp nhị phân và đảm bảo rằng người thử nghiệm và các nhà phát triển khác có bản phát hành phù hợp:

   • firebase_console_uri – Đường liên kết đến bảng điều khiển Firebase hiển thị một bản phát hành duy nhất. Bạn có thể chia sẻ đường liên kết này với các nhà phát triển khác trong tổ chức của mình.
   • testing_uri – Đường liên kết đến bản phát hành trong trải nghiệm của người thử nghiệm (đoạn mã web iOS) cho phép người thử nghiệm xem ghi chú phát hành và cài đặt ứng dụng trên thiết bị của họ. Người thử nghiệm cần có quyền truy cập vào bản phát hành để sử dụng đường liên kết này.
   • binary_download_uri – Đường liên kết đã ký trực tiếp tải xuống và cài đặt tệp nhị phân của ứng dụng (tệp IPA) . Đường liên kết này sẽ hết hạn sau một giờ.

   Quản lý người thử nghiệm và nhóm

   Ngoài việc phân phối bản phát hành, bạn cũng có thể sử dụng appdistribution:testers:add và appdistribution:testers:remove để mời người thử nghiệm mới hoặc xoá người thử nghiệm hiện có khỏi dự án Firebase.

   Sau khi thêm người thử nghiệm vào dự án Firebase, bạn có thể thêm họ vào từng bản phát hành. Sau khi bạn xoá người thử nghiệm, họ sẽ không còn quyền truy cập vào các bản phát hành trong dự án của bạn nữa. Xin lưu ý rằng những người thử nghiệm mới bị xoá vẫn có thể giữ quyền truy cập vào các bản phát hành của bạn trong một khoảng thời gian.

   Ví dụ:

   firebase appdistribution:testers:add anothertester@email.com moretesters@email.com
   
   firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com

   Bạn phải phân tách email của người thử nghiệm bằng dấu cách. Bạn cũng có thể chỉ định người thử nghiệm bằng --file /path/to/testers.txt.

   Nếu có nhiều người thử nghiệm, bạn nên cân nhắc sử dụng nhóm: Bạn có thể sử dụng appdistribution:group:create và appdistribution:group:delete để tạo hoặc xoá nhóm trong dự án Firebase của mình.

   Sử dụng --group-alias để chỉ định một nhóm cho các lệnh appdistribution:testers:add và appdistribution:testers:remove.

   Ví dụ:

   firebase appdistribution:group:create "QA team" qa-team
   
   firebase appdistribution:testers:add --group-alias=qa-team anothertester@email.com moretesters@email.com
   
   firebase appdistribution:testers:remove --group-alias=qa-team anothertester@email.com moretesters@email.com
   
   firebase appdistribution:group:delete qa-team

Sau khi bạn phân phối bản dựng, bản dựng đó sẽ có sẵn trong trang tổng quan App Distribution của bảng điều khiển Firebase trong 150 ngày (5 tháng). Khi bản dựng còn 30 ngày nữa là hết hạn, thông báo hết hạn sẽ xuất hiện trong cả bảng điều khiển và danh sách bản dựng của người thử nghiệm trên thiết bị thử nghiệm của họ.

Những người thử nghiệm chưa được mời kiểm thử ứng dụng sẽ nhận được email mời bắt đầu và những người thử nghiệm hiện có sẽ nhận được thông báo qua email rằng một bản dựng mới đã sẵn sàng để kiểm thử. Để tìm hiểu cách cài đặt ứng dụng thử nghiệm, hãy xem bài viết Thiết lập để trở thành người thử nghiệm. Bạn có thể theo dõi trạng thái của từng người thử nghiệm (liệu họ có chấp nhận lời mời và có tải ứng dụng xuống hay không) trong bảng điều khiển của Firebase.

Người thử nghiệm có 30 ngày để chấp nhận lời mời kiểm thử ứng dụng trước khi lời mời đó hết hạn. Khi lời mời còn 5 ngày nữa là hết hạn, thông báo hết hạn sẽ xuất hiện trong bảng điều khiển của Firebase bên cạnh người thử nghiệm trên một bản phát hành. Bạn có thể gia hạn lời mời bằng cách gửi lại lời mời đó bằng trình đơn thả xuống trên hàng người thử nghiệm.

Các bước tiếp theo

• Để đăng ký thêm thiết bị theo cách thủ công hoặc theo phương thức lập trình, hãy xem bài viết Đăng ký thêm thiết bị iOS.

• Tìm hiểu các phương pháp hay nhất để phân phối ứng dụng Apple cho người thử nghiệm QA bằng CI/CD và fastlane.