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

Bạn có thể phân phối các 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 kiểm tra và phát hành ghi chú cho một bản dựng và phân phối bản dựng cho phù hợp.

Trước khi bắt đầu

Nếu bạn chưa có, hãy thêm Firebase vào dự án Apple của bạn .

Nếu không sử dụng bất kỳ sản phẩm Firebase nào khác, bạn chỉ phải tạo một dự án và đăng ký ứng dụng của mình. Tuy nhiên, nếu bạn quyết định sử dụng các sản phẩm bổ sung trong tương lai, hãy đảm bảo hoàn thành tất cả các bước trên trang được liên kết ở trên.

Bước 1 . Xây dựng ứng dụng của bạn

Khi bạn đã sẵn sàng phân phối phiên bản trước khi phát hành ứng dụng của mình cho những người thử nghiệm, hãy tạo một kho lưu trữ phân phối có chữ ký. Bạn có thể sử dụng quy trình xây dựng bình thường của mình miễn là bạn đáp ứng các yêu cầu sau:

  • Để phân phối ứng dụng của bạn ngoài nhóm phát triển, bạn phải sử dụng Ad Hoc hoặc hồ sơ phân phối Doanh nghiệp của mình.
  • Nếu ứng dụng của bạn sử dụng Game Center, APN (và theo tiện ích mở rộng, Nhắn tin qua đám mây ) hoặc iCloud, hãy đảm bảo rằng hồ sơ cấp phép của bạn sử dụng ID ứng dụng rõ ràng chứ không phải ID ký tự đại diện.
  • Nếu bạn đang sử dụng hồ sơ phân phối Ad Hoc, hãy bao gồm ID thiết bị (UDID) duy nhất của thiết bị của người thử nghiệm. Khi những người thử nghiệm iOS mới đăng ký vào chương trình thử nghiệm của bạn, bạn sẽ cần cập nhật hồ sơ cấp phép với UDID của thiết bị của họ. Xem Đăng ký thiết bị thử nghiệm bổ sung .
  • Bạn đã cập nhật số phiên bản mà người dùng có thể nhìn thấy ( Phiên bản ) và số phiên bản duy nhất (Phiên bản) của mục tiêu xây dựng . Nếu bạn đã thực hiện các thay đổi mã kể từ lần xây dựng cuối cùng (nghĩa là bạn không xây dựng lại chỉ để cập nhật các thiết bị đã đăng ký), bạn không cần cập nhật phiên bản và số phiên bản.

Khi quá trình xây dựng hoàn tất, nó sẽ lưu một tệp IPA và một số tệp nhật ký trong thư mục bạn chỉ định. Bạn phân phối tệp IPA cho người thử nghiệm của mình theo các bước sau.

Bước 2 . Phân phối ứng dụng của bạn cho người thử nghiệm

Để phân phối ứng dụng của bạn 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 (chúng tôi khuyên bạn nên tải xuống tệp nhị phân độc lập cho CLI dành riêng cho hệ điều hành của bạn). Đảm bảo đăng nhập và kiểm tra rằng bạn có thể truy cập các dự án của mình.
  2. Trong trang Phân phối ứng dụng của bảng điều khiển Firebase, hãy chọn ứng dụng bạn muốn phân phối, sau đó nhấp vào Bắt đầu .
  3. Chạy lệnh appdistribution:distribute để tải lên ứng dụng của bạn và phân phối nó cho người thử nghiệm. Sử dụng các thông số sau để định cấu hình phân phối:

    appdistribution: phân phối các tùy chọn
    --app

    Bắt buộc : ID ứng dụng Firebase của ứng dụng của bạn. Bạn có thể tìm thấy ID ứng dụng trong bảng điều khiển Firebase, 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 của mình bằng Firebase CLI (đọc Sử dụng hệ thống CLI với 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 các ghi chú phát hành:

    --release-notes "Text of release notes"

    Hoặc, chỉ định đường dẫn đến tệp văn bản thuần túy:

    --release-notes-file "/path/to/release-notes.txt"
    --testers
    --testers-file

    Địa chỉ email của những người thử nghiệ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 tệp văn bản thuần túy 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

    Nhóm người thử nghiệm bạn muốn mời (tham khảo Quản lý người thử nghiệm ). Các nhóm được chỉ định bằng cách sử dụng bí danh nhó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 tệp văn bản thuần túy 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ờ bạn có thể đưa vào để in đầu ra nhật ký chi tiết.

    Ví dụ:

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

    Ngoài việc phân phối các bản phát hành, bạn cũng có thể sử dụng appdistribution:testers:addappdistribution:testers:remove để mời những người thử nghiệm mới hoặc xóa những người thử nghiệm hiện có khỏi dự án Firebase của bạn. Sau khi người thử nghiệm đã được thêm vào dự án Firebase của bạn, bạn có thể thêm họ vào các bản phát hành riêng lẻ. Sau khi bạn xóa người thử nghiệm, họ sẽ không có quyền truy cập vào các bản phát hành trong dự án của bạn nữa. Lưu ý rằng những người thử nghiệm đã bị xóa gần đây vẫn có thể giữ lại 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
    

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

Sau khi bạn phân phối bản dựng của mình, bản dựng sẽ có sẵn trong trang tổng quan Phân phối ứng dụng của bảng điều khiển Firebase trong 150 ngày (năm tháng). Khi bản dựng còn 30 ngày nữa mới 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 các 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 lời mời qua email để bắt đầu và những người thử nghiệm hiện tại nhận được thông báo qua email rằng một 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 Thiết lập làm 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 hay không và liệu họ có tải xuống ứng dụng trong bảng điều khiển Firebase hay không.

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 ứng dụng hết hạn. Khi lời mời còn 5 ngày nữa mới hết hạn, 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 về bản phát hành. Có thể gia hạn lời mời bằng cách gửi lại bằng menu thả xuống trên hàng của người thử nghiệm.

Bước tiếp theo