Đăng ký thêm thiết bị iOS

Nếu muốn phân phối các bản dựng iOS đột xuất bằng tính năng Phân phối ứng dụng, bạn phải làm theo hướng dẫn này để đăng ký thiết bị của người kiểm thử. Bản dựng đặc biệt là một bản dựng không được ký bằng hồ sơ Doanh nghiệp. Một thiết bị chỉ có thể cài đặt một bản dựng đặc biệt nếu giá trị nhận dạng thiết bị duy nhất (UDID) của thiết bị đó có trong hồ sơ cấp phép của bản dựng đó.

Khi người kiểm thử chấp nhận lời mời kiểm thử ứng dụng của bạn, tính năng Phân phối ứng dụng sẽ yêu cầu quyền chia sẻ giá trị nhận dạng thiết bị của người kiểm thử với bạn, với nhà phát triển. Trước khi tải một bản dựng đặc biệt xuống, tính năng Phân phối ứng dụng sẽ yêu cầu người kiểm thử đăng ký thiết bị của họ. Nếu người kiểm thử đăng ký thiết bị của họ, thì tính năng Phân phối ứng dụng sẽ thu thập UDID từ thiết bị và thông báo cho bạn về UDID qua email.

Khi bạn nhận được email chứa UDID, hãy cập nhật UDID trong hồ sơ cấp phép và phân phối bản dựng mới cho người kiểm thử. Bạn có thể xuất UDID theo cách thủ công bằng bảng điều khiển của Firebase hoặc Firebase CLI, hoặc bạn có thể xuất UDID theo phương thức lập trình bằng cách sử dụng fastlane.

Xuất UDID theo cách thủ công

  1. Thêm thiết bị vào cổng thông tin dành cho nhà phát triển của Apple.
    • Cách 1: Nhập UDID của thiết bị dưới dạng tệp CSV.

      Trong thẻ Testers & Groups (Nhân viên kiểm thử và nhóm) trên trang tổng quan Phân phối ứng dụng, hãy chọn Tất cả người kiểm thử, sau đó nhấp vào Xuất UDID của Apple để tải tệp CSV xuống. Tiếp theo, hãy nhập tệp này vào tài khoản nhà phát triển Apple bằng cách sử dụng tuỳ chọn Đăng ký nhiều thiết bị. Để tìm hiểu thêm, hãy xem phần Phân phối ứng dụng của bạn cho các thiết bị đã đăng ký.

      Xin lưu ý rằng tài khoản nhà phát triển của Apple có thể chỉ cho phép bạn nhập một số lượng thiết bị hạn chế mỗi năm.

    • Cách 2: Thu thập và nhập UDID qua email.

      Trên trang Add Devices (Thêm thiết bị) trong cổng thông tin dành cho nhà phát triển của Apple, hãy đăng ký UDID mới được chỉ định trong email mà bạn nhận được.

  2. Thêm các thiết bị đã đăng ký vào hồ sơ cấp phép.
  3. Hãy tải hồ sơ cấp phép xuống và dùng hồ sơ này để tạo lại ứng dụng. Nếu bạn chỉ tạo bản dựng lại để cập nhật các thiết bị đã đăng ký, đừng cập nhật số bản dựng hoặc phiên bản.
  4. Phân phối lại ứng dụng của bạn từ bảng điều khiển của Firebase hoặc CLI. Nếu bạn không thay đổi phiên bản, số bản dựng hoặc mã của ứng dụng, thì tính năng Phân phối ứng dụng sẽ không tạo bản phát hành mới và sẽ không thông báo cho người kiểm thử. Nếu bạn đã phân phối một bản dựng có cùng số bản dựng và phiên bản, thì chỉ những người dùng thiết bị mới đăng ký mới nhận được email thông báo.

Xuất UDID theo phương thức lập trình bằng cách sử dụng công cụ phân phối nhanh

  1. Xuất tất cả UDID của thiết bị của người kiểm thử dưới dạng tệp CSV từ Fastlane. Ví dụ: tạo và chạy một làn đường download_udids mới:

    lane :download_udids do
    firebase_app_distribution_get_udids(
        app: "<your Firebase app ID>",
        output_file: "<path to output file>",
    )
end

  2. Nhập(các) UDID vào tài khoản nhà phát triển Apple của bạn bằng cách sử dụng tuỳ chọn Đăng ký nhiều thiết bị. Để tìm hiểu thêm, hãy xem tài liệu của Apple. Xin lưu ý rằng tài khoản nhà phát triển Apple có thể chỉ cho phép bạn nhập một số lượng thiết bị giới hạn mỗi năm.

  3. Thêm các thiết bị đã đăng ký vào hồ sơ cấp phép.

  4. Hãy tải hồ sơ cấp phép xuống và dùng hồ sơ này để tạo lại ứng dụng. Nếu bạn chỉ tạo bản dựng cho mục đích cập nhật các thiết bị đã đăng ký, đừng cập nhật số bản dựng hoặc phiên bản.

  5. Phân phối lại ứng dụng. Nếu bạn không thay đổi phiên bản, số bản dựng hoặc mã của ứng dụng, thì tính năng Phân phối ứng dụng sẽ không tạo bản phát hành mới và sẽ không thông báo cho người kiểm thử. Nếu bạn đã phân phối một bản dựng có cùng số bản dựng và phiên bản, thì chỉ những người dùng thiết bị mới đăng ký mới nhận được email thông báo.

Nhận thông báo

Nhận cảnh báo mặc định

Theo mặc định, Firebase có thể gửi thông báo Phân phối ứng dụng qua email cho các lượt đăng ký thiết bị iOS mới.

Để nhận cảnh báo Phân phối ứng dụng qua cơ chế mặc định này, bạn phải có quyền firebase.projects.update. Theo mặc định, các vai trò sau sẽ có quyền cần thiết này: Quản trị viên Firebase hoặc Chủ sở hữu hoặc Người chỉnh sửa dự án.

Theo mặc định, mọi thành viên của dự án (những người có quyền cần thiết để nhận thông báo) sẽ nhận được email khi thiết bị iOS mới được đăng ký.

Bật/tắt cảnh báo cho tài khoản của riêng bạn

Đối với tài khoản của riêng mình, bạn có thể bật/tắt cảnh báo Phân phối ứng dụng mà không ảnh hưởng đến các thành viên khác của dự án. Xin lưu ý rằng bạn vẫn cần có các quyền cần thiết để nhận cảnh báo.

Để bật hoặc tắt cảnh báo Phân phối ứng dụng, hãy làm theo các bước sau:

  1. Trong bảng điều khiển của Firebase, ở góc trên cùng bên phải, hãy chuyển đến mục Cảnh báo của Firebase.
  2. Sau đó, hãy chuyển đến phần Cài đặt rồi đặt lựa chọn ưu tiên cho tài khoản của bạn cho cảnh báo Phân phối ứng dụng.

Thiết lập cảnh báo nâng cao cho các dịch vụ của bên thứ ba

Bạn cũng có thể gửi cảnh báo Phân phối ứng dụng đến kênh thông báo ưu tiên của nhóm bằng cách sử dụng Cloud Functions cho Firebase. Ví dụ: bạn có thể viết một hàm ghi lại một sự kiện thông báo để đăng ký một thiết bị iOS mới và đăng thông tin cảnh báo lên một dịch vụ của bên thứ ba, như Discord, Slack hoặc Jira.

Để tự động hoá hoàn toàn quy trình giới thiệu người kiểm thử iOS mới, bạn có thể viết một hàm để thêm UDID của thiết bị iOS mới vào hồ sơ cấp phép của ứng dụng, tạo lại ứng dụng và phân phối lại ứng dụng bằng hồ sơ cấp phép đã cập nhật.

Để thiết lập tính năng cảnh báo nâng cao bằng Cloud Functions cho Firebase, hãy làm theo các bước sau:

  1. Thiết lập Cloud Functions cho Firebase, bao gồm những việc sau:

    1. Thiết lập môi trường phát triển cho Node.js hoặc Python.
    2. Cài đặt và đăng nhập vào Firebase CLI.
    3. Khởi chạy Cloud Functions cho Firebase bằng CLI của Firebase.

  2. Viết và triển khai một hàm để ghi lại một sự kiện cảnh báo từ tính năng Phân phối ứng dụng và xử lý tải trọng của sự kiện (ví dụ: đăng thông tin cảnh báo trong một tin nhắn trên Discord).

Để tìm hiểu về tất cả các sự kiện cảnh báo mà bạn có thể thu thập, hãy chuyển đến tài liệu tham khảo về cảnh báo Phân phối ứng dụng.

Các bước tiếp theo