Ghi chú phát hành Dấu hiệu về độ tuổi trên Play

Trang này giải thích những nội dung cập nhật gần đây đối với kho lưu trữ Maven cho thư viện Play Age Signals.

0.0.5 (Tháng 11 năm 2026)

  • Phương thức mới cho các tính năng theo độ tuổi áp dụng: Ra mắt getApplicableAgeFeatures() để kiểm tra xem tính năng nào liên quan đến độ tuổi (chẳng hạn như ApplicableAgeFeature.MANDATORY_SHARING) áp dụng cho người dùng hiện tại trước khi gọi requestAgeSignalsAccess().

  • Mã lỗi mới: Thêm DEVICE_NOT_SUPPORTED (-11) cho các loại thiết bị không được hỗ trợ.

  • Kiểm thử bản cập nhật: Thêm các phương thức sau vào FakeAgeSignalsManager để bạn có thể kiểm thử cách ứng dụng xử lý các phản hồi getApplicableAgeFeatures() mà không cần kết nối với Cửa hàng Play:

    • setNextApplicableAgeFeaturesResult(): Đặt ApplicableAgeFeaturesResult mà lệnh gọi getApplicableAgeFeatures() tiếp theo trả về. Sử dụng phương thức này để mô phỏng người dùng ở những khu vực áp dụng (ApplicableAgeFeature.MANDATORY_SHARING) hoặc không áp dụng (một tập hợp trống) quy định bắt buộc về việc chia sẻ độ tuổi.

    • setNextApplicableAgeFeaturesException(): Khiến lệnh gọi getApplicableAgeFeatures() tiếp theo không thành công với AgeSignalsException mà bạn chỉ định. Hãy sử dụng phương thức này để kiểm thử cách xử lý lỗi của ứng dụng, chẳng hạn như logic thử lại cho NETWORK_ERROR.

0.0.4 (Tháng 7 năm 2026)

  • Cấu trúc hai hàm: Kể từ bản phát hành này, bạn phải sử dụng các phương thức sau để nhận tín hiệu về độ tuổi:
    • requestAgeSignalsAccess() (phương thức mới): Kích hoạt rõ ràng lời nhắc trong ứng dụng của Play để yêu cầu chia sẻ nhóm tuổi.
    • checkAgeSignals() (phương thức hiện có): Nhận tín hiệu về độ tuổi.
  • Ngừng sử dụng userStatus: userStatus không còn được dùng và không còn được hỗ trợ trong phiên bản 0.0.4 trở lên. userStatus hiện được thay thế bằng ageRangeSource và significantChangeStatus.
  • Trường mới cho các thay đổi quan trọng: Ra mắt trường enum significantChangeStatus để theo dõi trạng thái đang chờ xử lý, đã phê duyệt hoặc bị từ chối đối với các thay đổi quan trọng, đồng thời đổi tên mostRecentApprovalDate thành significantChangeApprovalDate để rõ ràng hơn.

0.0.3 (Tháng 2 năm 2026)

  • Thêm trạng thái người dùng DECLARED.
  • Thêm mã lỗi SDK_VERSION_OUTDATED.
  • Khắc phục lỗi kiểm thử đơn vị khi gọi trình tạo AgeSignalsResult.

0.0.2 (tháng 12 năm 2025)

  • Bản phát hành này đảm bảo các giá trị trống được trả về dưới dạng null.
  • Bản phát hành này của thư viện sẽ trả về kết quả thực khi API được bật.

0.0.1 (tháng 12 năm 2025)

  • Bản phát hành đầu tiên không phải bản thử nghiệm của thư viện sẽ trả về kết quả thực khi API được bật.

0.0.1-beta02 (tháng 10 năm 2025)

  • Thêm FakeAgeSignalsManager, một cách triển khai giả mạo của AgeSignalsManager.
  • Thay thế com.google.type.Date bằng java.util.Date.
  • Bản phát hành này sẽ không trả về kết quả thực tế khi API được bật.

0.0.1-beta01 (tháng 10 năm 2025)

  • Bản phát hành đầu tiên.
  • Bản phát hành này sẽ không trả về kết quả thực tế khi API được bật.