ملاحظات إصدار "مؤشرات الفئات العمرية" في Play

توضّح هذه الصفحة محتوى التعديلات الأخيرة التي أُجريت على مستودع Maven الخاص بـ Play Age Signals Library.

الإصدار 0.0.6 (نوفمبر 2026)

  • طريقة جديدة لميزات السنّ المعمول به: تم تقديم getApplicableAgeFeatures() للتحقّق من الميزات المرتبطة بالسنّ (مثل ApplicableAgeFeature.MANDATORY_SHARING) التي تنطبق على المستخدم الحالي قبل استدعاء requestAgeSignalsAccess().

  • رمز خطأ جديد: تمت إضافة DEVICE_NOT_SUPPORTED (-11) لأنواع الأجهزة غير المتوافقة.

  • تحديثات الاختبار: تمت إضافة الطرق التالية إلى FakeAgeSignalsManager لتتمكّن من اختبار كيفية تعامل تطبيقك مع استجابات getApplicableAgeFeatures() بدون الاتصال بـ "متجر Google Play":

    • ‫setNextApplicableAgeFeaturesResult(): لضبط ApplicableAgeFeaturesResult التي يعرضها طلب getApplicableAgeFeatures() التالي. استخدِم هذه الطريقة لمحاكاة المستخدمين في المناطق التي ينطبق فيها شرط مشاركة العمر (ApplicableAgeFeature.MANDATORY_SHARING) أو لا ينطبق (مجموعة فارغة).

    • setNextApplicableAgeFeaturesException(): يؤدي إلى تعذُّر إجراء طلب getApplicableAgeFeatures() التالي باستخدام AgeSignalsException الذي تحدّده. استخدِم هذه الطريقة لاختبار معالجة الأخطاء في تطبيقك، مثل منطق إعادة المحاولة لـ NETWORK_ERROR.

الإصدار 0.0.4 (يوليو 2026)

  • بنية ثنائية الوظائف: بدءًا من هذا الإصدار، يجب استخدام الطرق التالية لتلقّي إشارات العمر:
    • requestAgeSignalsAccess() (طريقة جديدة): تظهر رسالة المطالبة في التطبيق على Google Play بشكل صريح لطلب مشاركة الفئة العمرية.
    • checkAgeSignals() (الطريقة الحالية): تلقّي مؤشرات الفئات العمرية
  • إيقاف userStatus نهائيًا: تم إيقاف userStatus نهائيًا ولم يعُد متاحًا في الإصدار 0.0.4 أو الإصدارات الأحدث. تم استبدال "userStatus" بـ "ageRangeSource" و"significantChangeStatus".
  • حقل جديد للتغييرات المهمة: تم تقديم حقل التعداد significantChangeStatus لتتبُّع حالة التغييرات المهمة، سواء كانت في انتظار المراجعة أو تمت الموافقة عليها أو تم رفضها، وتمت إعادة تسمية mostRecentApprovalDate إلى significantChangeApprovalDate لمزيد من الوضوح.

الإصدار 0.0.3 (فبراير 2026)

  • إضافة حالة المستخدم DECLARED
  • يُرجى إضافة رمز الخطأ SDK_VERSION_OUTDATED.
  • إصلاح حالات تعذُّر اختبار الوحدة عند استدعاء أداة إنشاء AgeSignalsResult

الإصدار 0.0.2 (ديسمبر 2025)

  • يضمن هذا الإصدار عرض القيم الفارغة على النحو التالي: null.
  • سيعرض هذا الإصدار من المكتبة نتائج فعلية عند تفعيل واجهة برمجة التطبيقات.

الإصدار 0.0.1 (ديسمبر 2025)

  • سيعرض الإصدار الأول غير التجريبي من المكتبة نتائج حقيقية عند تفعيل واجهة برمجة التطبيقات.

‫0.0.1-beta02 (أكتوبر 2025)

  • أضِف FakeAgeSignalsManager، وهو تنفيذ مزيّف لـ AgeSignalsManager.
  • استبدِل com.google.type.Date بـ java.util.Date.
  • لن يعرض هذا الإصدار نتائج حقيقية عند تفعيل واجهة برمجة التطبيقات.

‫0.0.1-beta01 (أكتوبر 2025)

  • الإصدار الأوّلي
  • لن يعرض هذا الإصدار نتائج حقيقية عند تفعيل واجهة برمجة التطبيقات.