لمن هذا الدليل
ينطبق عند استخدام shernova_ui (^2.2.0+) مع verifyPhone() على Android. shernova_core وحده (headless) لا يدمج الصلاحيات الأصلية أدناه — ما زلت تحتاج سياسة خصوصية ونموذج Data safety، لكن Play قد لا يطلب إعلانات foreground service.
واجهة Shernova الاختيارية تستخدم APIs رسمية لمراقبة مكالمة التحقق وإعادة التطبيق تلقائياً بعد انتهائها. Google Play قد يطلب إعلاناً عن هذه القدرات قبل الموافقة. هذا طبيعي ولا يعني مخالفة السياسات عند الاستخدام كما في التوثيق.
لماذا يطلب Google Play إعلاناً
Google تقيّد الصلاحيات الحساسة وخدمات المقدمة (FGS) لمنع إساءة الخلفية. عند دمج صلاحيات مثل FOREGROUND_SERVICE أو READ_PHONE_STATE أو CALL_PHONE، يطلب Play Console شرح لماذا ومتى تُستخدم.
- Foreground service — Android يتطلب إشعاراً مرئياً أثناء تشغيل الخدمة. Shernova تبدأها فقط أثناء جلسة تحقق نشطة.
- Phone state — للاستماع لتغيّر حالة المكالمة ومعرفة متى ينتهي اتصال التحقق.
- Call phone (اختياري) — إن منحها المستخدم، يمكن إجراء الاتصال مباشرة؛ وإلا يُفتح Dialer.
متى يظهر الطلب
- أول رفع لـ build يتضمن shernova_ui 2.2.0+.
- App content → Sensitive app permissions — نموذج Phone وForeground service.
- مراجعة يدوية — قد يطلب Google فيديو قصير للتدflow (تم قبول تطبيقات إنتاج مع Shernova).
- التحديثات — عادة لا إعادة إعلان إلا عند إضافة صلاحيات جديدة.
الصلاحيات المدمجة من shernova_ui
| الصلاحية | الغرض | إجراء Play Console |
|---|---|---|
| READ_PHONE_STATE | اكتشاف انتهاء مكالمة التحقق | Phone permissions / Data safety |
| FOREGROUND_SERVICE + DATA_SYNC | إبقاء المراقبة حية أثناء Dialer | Foreground service declaration |
| CALL_PHONE | اتصال مباشر اختياري | إعلان صلاحية حساسة إن طُلب |
| POST_NOTIFICATIONS | قناة إشعار FGS (Android 13+) | طلب وقت التشغيل |
| REORDER_TASKS | إعادة التطبيق للمقدمة | بدون إعلان خاص |
| WAKE_LOCK | استيقاظ قصير عند العودة | بدون إعلان خاص |
الأجهزة اللوحية
من shernova_ui 2.3.1+، telephony مطلوب=false — القائمة لا تُقيّد على الهواتف فقط. التحقق ما زال يحتاج جهازاً يمكنه الاتصال.
لماذا Shernova متوافقة مع سياسات Google Play
- تحقق بمبادرة المستخدم — لا معالجة خلفية مستمرة.
- FGS محدود زمنياً — يبدأ مع التحقق ويتوقف عند الإكمال أو الإلغاء.
- APIs رسمية فقط — بدون قراءة سجل مكالمات أو full-screen intent (أُزيل في 2.3.1).
- بدون تسجيل مكالمات — البوابة تطابق الرقم فقط.
- حالة استخدام مشروعة — التحقق الهاتفي ميزة قياسية.
كيف تكمل الإعلان
إعلان Foreground service
في Play Console → App content → Foreground service permissions، اختر النوع المطابق للـ manifest (Data sync). استخدم النص أدناه (قُبل مع تطبيق إنتاج يستخدم Shernova).
The app uses a foreground service only during phone number verification. The service monitors the verification call state and automatically returns the user to the app after the call ends. It starts immediately when verification begins and stops as soon as the verification process is completed. The service is not used for continuous background processing.دقة النص (shernova_ui 2.3.1)
يطابق التنفيذ الحالي: FGS أثناء verifyPhone() فقط، مراقبة call state، عودة صامتة (بدون إشعار heads-up منذ 2.2.1)، إيقاف الخدمة عند الانتهاء.
Phone / READ_PHONE_STATE
READ_PHONE_STATE is used only during phone number verification to detect when the verification call ends. The app does not access call logs or contacts.CALL_PHONE (إن طُلب منفصلاً)
CALL_PHONE is used only when the user taps "Call to verify" during phone number verification, to place a single outbound call to the verification gateway number. If permission is denied, the system dialer opens instead.فيديو توضيحي (موصى به)
- سجّل 30–90 ثانية على جهاز حقيقي.
- أظهر: فتح التطبيق → بدء التحقق → منح الصلاحيات → اتصال → عودة تلقائية → نجاح.
- ارفع في رد المراجعة عند الطلب.
نصائح لتقليل التأخير أو الرفض
- سياسة خصوصية — تذكر التحقق الهاتفي والصلاحيات.
- Data safety — أعلن جمع رقم الهاتف ومعالجة call state للتحقق.
- إفصاح داخل التطبيق — قبل أول تحقق، اشرح لماذا Phone/Notifications.
- لا تحذف الصلاحيات المدمجة دون فهم الأثر — READ_PHONE_STATE ضروري للعودة التلقائية.
- اختبر build إصدار بنفس SHA256 المسجّل في Dashboard.
- رد سريع بالنموذج + الفيديو.
بديل: تجنّب إعلانات FGS
استخدم shernova_core فقط: المستخدم يعود يدوياً وت poll من التطبيق. مقايضة: UX أضعف على Android. معظم تطبيقات الإنتاج تفضل shernova_ui مع الإعلانات.
iOS / App Store
راجع دليل iOS.
