Play 연령 신호 출시 노트

이 페이지에서는 Play Age Signals Library와 관련된 Maven 저장소의 최근 업데이트 내용을 설명합니다.

0.0.5(2026년 11월)

  • 적정 연령 기능의 새로운 메서드: requestAgeSignalsAccess()를 호출하기 전에 현재 사용자에게 적용되는 연령 관련 기능(예: ApplicableAgeFeature.MANDATORY_SHARING)을 확인하는 getApplicableAgeFeatures()가 도입되었습니다.

  • 새 오류 코드: 지원되지 않는 기기 유형에 DEVICE_NOT_SUPPORTED(-11)가 추가되었습니다.

  • 업데이트 테스트: Play 스토어에 연결하지 않고도 앱이 getApplicableAgeFeatures() 응답을 처리하는 방식을 테스트할 수 있도록 FakeAgeSignalsManager에 다음 메서드를 추가했습니다.

    • setNextApplicableAgeFeaturesResult(): 다음 getApplicableAgeFeatures() 호출이 반환하는 ApplicableAgeFeaturesResult를 설정합니다. 이 메서드를 사용하여 필수 연령 공유가 적용되는 지역(ApplicableAgeFeature.MANDATORY_SHARING) 또는 적용되지 않는 지역(빈 집합)의 사용자를 시뮬레이션합니다.

    • setNextApplicableAgeFeaturesException(): 지정한 AgeSignalsException로 다음 getApplicableAgeFeatures() 호출이 실패합니다. 이 메서드를 사용하여 NETWORK_ERROR의 재시도 로직과 같은 앱의 오류 처리를 테스트합니다.

0.0.4(2026년 7월)

  • 두 가지 함수 아키텍처: 이 버전부터는 다음 메서드를 사용하여 연령 신호를 수신해야 합니다.
    • requestAgeSignalsAccess()(새 메서드): 연령대 공유 요청을 위한 Play 인앱 메시지를 명시적으로 트리거합니다.
    • checkAgeSignals()(기존 방법): 연령 신호를 수신합니다.
  • userStatus 지원 중단: userStatus는 지원 중단되었으며 버전 0.0.4 이상에서 더 이상 지원되지 않습니다. userStatus가 이제 ageRangeSource 및 significantChangeStatus로 대체되었습니다.
  • 주요 변경사항을 위한 새 필드: 주요 변경사항의 대기 중, 승인됨 또는 거부됨 상태를 추적하는 significantChangeStatus enum 필드를 도입하고 명확성을 위해 mostRecentApprovalDate의 이름을 significantChangeApprovalDate로 변경했습니다.

0.0.3(2026년 2월)

  • 사용자 상태 DECLARED를 추가합니다.
  • 오류 코드 SDK_VERSION_OUTDATED를 추가합니다.
  • AgeSignalsResult 빌더를 호출할 때 발생하는 단위 테스트 실패를 수정합니다.

0.0.2(2025년 12월)

  • 이번 출시에서는 빈 값이 null로 반환되도록 합니다.
  • 이 라이브러리 버전은 API가 사용 설정된 경우 실제 결과를 반환합니다.

0.0.1(2025년 12월)

  • 라이브러리의 베타가 아닌 첫 번째 버전은 API가 사용 설정된 경우 실제 결과를 반환합니다.

0.0.1-beta02(2025년 10월)

  • AgeSignalsManager의 가짜 구현인 FakeAgeSignalsManager가 추가되었습니다.
  • com.google.type.Date를 java.util.Date로 바꿉니다.
  • 이 버전은 API가 사용 설정된 경우 실제 결과를 반환하지 않습니다.

0.0.1-beta01(2025년 10월)

  • 첫 출시입니다.
  • 이 버전은 API가 사용 설정된 경우 실제 결과를 반환하지 않습니다.