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 tra để đả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 Thử nghiệm ứng dụng thử nghiệm 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 được dùng trong các thử nghiệm tác nhân Thử nghiệm ứng dụng.
    --test-password
    --test-password-file

    Mật khẩu để đăng nhập tự động được dùng trong các thử nghiệm tác nhân Thử nghiệm ứ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 được dùng trong các thử nghiệm tác nhân Thử nghiệm ứng dụng.
    --test-password-resource

    Tên tài nguyên cho trường mật khẩu để đăng nhập tự động được dùng trong các thử nghiệm tác nhân Thử nghiệm ứng dụng.
    --test-non-blocking

    Nếu được thiết lập khi chạy tác nhân Thử nghiệm ứng dụng các thử nghiệm, lệnh này sẽ bắt đầu các thử nghiệm rồi trả về ngay lập tức thay vì chờ các thử nghiệm đó hoàn tất. Để xem kết quả thử nghiệm, 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 thử nghiệm hoàn tất và thoát bằng mã lỗi nếu có thử nghiệm 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 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 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 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