Đăng ký thiết bị iOS bổ sung

Nếu muốn phân phối các bản dựng iOS đặc biệt bằng App Distribution, 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à bản dựng không được ký bằng hồ sơ Doanh nghiệp. Thiết bị chỉ có thể cài đặ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, App Distribution 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 (nhà phát triển). Trước khi tải bản dựng đặc biệt xuống, App Distribution 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ọ, App Distribution 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 hồ sơ cấp phép bằng UDID 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 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 fastlane.

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

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

      Trong thẻ Testers & Groups (Người kiểm thử và nhóm) của trang tổng quan App Distribution, hãy chọn All testers (Tất cả người kiểm thử), sau đó nhấp vào Export Apple UDIDs (Xuất mã nhận dạng duy nhất của thiết bị Apple) để tải tệp CSV xuống. Tiếp theo, hãy nhập tệp vào tài khoản nhà phát triển của Apple bằng tuỳ chọn Register Multiple Devices (Đă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 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 mã nhận dạng thiết bị duy nhất (UDID) qua email.

      Trên trang Add Devices (Thêm thiết bị) của 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 bạn nhận được.

  2. Thêm các thiết bị đã đăng ký vào hồ sơ cấp phép.
  3. Tải hồ sơ cấp phép xuống và sử dụng hồ sơ đó để tạo lại ứng dụng. Nếu bạn chỉ tạo 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 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ì App Distribution 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ỉ người dùng của các 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 fastlane

  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 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 của Apple bằng cách sử dụng tuỳ chọn Register Multiple Devices (Đă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 của Apple có thể chỉ cho phép bạn nhập một số lượng thiết bị có 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. Tải hồ sơ cấp phép xuống và sử dụng hồ sơ đó để tạo lại ứng dụng. Nếu bạn chỉ tạo 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.

  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, App Distribution 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ỉ người dùng của các thiết bị mới đăng ký mới nhận được email thông báo.

Nhận cảnh báo

Nhận thông báo mặc định

Theo mặc định, Firebase có thể gửi cảnh báo App Distribution cho các lượt đăng ký thiết bị iOS mới qua email.

Để nhận cảnh báo App Distribution thô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 đây sẽ có quyền bắt buộc 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 (có quyền cần thiết để nhận cảnh báo) sẽ nhận được email khi một 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 App Distribution mà không ảnh hưởng đến các thành viên khác trong 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 App Distribution, hãy làm theo các bước sau:

  1. Ở góc trên cùng bên phải trong bảng điều khiển Firebase, hãy chuyển đến Cảnh báo Firebase.
  2. Sau đó, hãy chuyển đến Cài đặt rồi đặt tuỳ chọn tài khoản cho cảnh báo App Distribution.

Thiết lập tính năng 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 App Distribution đến kênh thông báo ưu tiên của nhóm bằng Cloud Functions for Firebase. Ví dụ: bạn có thể viết một hàm để ghi lại sự kiện cảnh báo khi đă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, chẳng hạn 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 các tính năng cảnh báo nâng cao bằng Cloud Functions for Firebase, hãy làm theo các bước sau:

  1. Thiết lập Cloud Functions cho Firebase, bao gồm các nhiệm vụ 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 CLI Firebase.
    3. Khởi động Cloud Functions for Firebase bằng CLI Firebase.

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

Để tìm hiểu về tất cả sự kiện cảnh báo mà bạn có thể ghi lại, hãy chuyển đến tài liệu tham khảo về cảnh báo App Distribution.

Các bước tiếp theo