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 cách sử dụng CLI Firebase. 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 cho CLI dành riêng cho hệ điều hành của mình). Hãy nhớ đăng nhập và kiểm thử để đảm bảo bạn 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:

   các tuỳ chọn appdistribution:distribute
   --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 cách sử dụng email đại diện của 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 được phân tách bằng dấu phẩy gồm tên nhóm: --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 thiết bị thử nghiệm mà bạn muốn chạy tác nhân Kiểm thử ứng dụng các bài kiểm thử trên đó. Bạn có thể chỉ định các thiết bị thử nghiệm dưới dạng danh sách thông số kỹ thuật của thiết bị được phân tách bằng dấu chấm phẩy: --test-devices: "model=shiba,version=34,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 sẽ được sử dụng trong các bài kiểm thử tác nhân Kiểm thử ứng dụng.
   --test-password --test-password-file	Mật khẩu để đăng nhập tự động sẽ được sử dụng trong các bài kiểm thử tác nhân Kiểm thử ứng dụ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 sẽ được sử dụng trong các bài kiểm thử tác nhân Kiểm thử ứng dụng.
   --test-password-resource	Tên tài nguyên cho trường mật khẩu để đăng nhập tự động sẽ được sử dụng trong các bài kiểm thử tác nhân Kiểm thử ứng dụng.
   --test-non-blocking	Nếu được thiết lập khi chạy tác nhân Kiểm thử ứng dụng các bài kiểm thử, lệnh này sẽ bắt đầu các bài kiểm thử rồi trả về ngay lập tức thay vì chờ các bài kiểm thử hoàn tất. Để xem kết quả kiểm thử, hãy truy cập vào bảng điều khiển của Firebase. Nếu bạn không thiết lập cờ này, lệnh sẽ chặn cho đến khi các bài kiểm thử hoàn tất và thoát bằng mã lỗi nếu có bài kiểm thử nào không thành công.

   Ví dụ:

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

   CLI của Firebase sẽ xuất 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 cũng như 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 vào 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 của mình.

   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

   Địa chỉ email của người thử nghiệm phải được phân tách bằng dấu cách. Bạn cũng có thể chỉ định người thử nghiệm bằng cách sử dụ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 các nhóm: Bạn có thể sử dụng appdistribution:group:create và appdistribution:group:delete để tạo hoặc xoá các 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ó 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 sắp hết hạn trong vòng 30 ngày, thông báo hết hạn sẽ xuất hiện cả trong 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 thử nghiệm ứ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 bản dựng mới đã sẵn sàng để thử nghiệm. Để 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ọ đã chấp nhận lời mời và tải ứng dụng xuống hay chưa) trong bảng điều khiển Firebase.

Người thử nghiệm có 30 ngày để chấp nhận lời mời thử nghiệm ứng dụng trước khi lời mời đó hết hạn. Khi lời mời sắp hết hạn trong vòng 5 ngày, thông báo hết hạn sẽ xuất hiện trong bảng điều khiển 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 của 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.