هل أحتاج Firebase؟
لا. Shernova منصة مستقلة. يمكنك استبدال Firebase Phone Authentication.
هل أحتاج Backend؟
ليس إلزامياً لتدفقات الجوال — Flutter SDK يكفي. للتحكم من الخادم أو webhooks يُفضّل backend.
هل أحتاج SMS؟
لا. التحقق عبر المكالمة الفائتة.
هل تعمل على Flutter؟
نعم. shernova_core يعمل على Android و iOS. سجّل SHA256 و Bundle ID + Team ID من الإعدادات. shernova_ui اختياري. shernova_cli setup. راجع Flutter SDK.
shernova أم shernova_core؟
استخدم shernova_core (^2.0.0) — SDK الأساسي الإلزامي. حزمة shernova (1.x) مهملة. shernova_ui اختياري — أضف shernova_core و shernova_ui معاً عند استخدام UI. لا تستخدم dart pub add shernova من شروحات قديمة.
ماذا يعني Test و Live؟
Test و Live يشيران إلى مفاتيح API لتطبيقك — وليس «اختبار Shernova». pk_test_ / sk_test_ للتطوير؛ pk_live_ / sk_live_ للإنتاج. أنت تختار المفتاح في كود التطبيق.
ما المقصود بـ «وصول الحساب» في الفوترة؟
منفصل عن مفاتيح Test/Live. بعد تأكيد البريد: قيد المراجعة، تجربة كاملة (رصيد مجاني)، بدون رصيد تجريبي (SANDBOX_ONLY — pk_test_ و pk_live_ عند وجود رصيد)، انتهت التجربة، أو تم إلغاء الوصول. راجع الفوترة.
بدون رصيد تجريبي vs مفاتيح test
مفاتيح test = build التطوير. بدون رصيد تجريبي = لا credits مجانية — pk_test_ و pk_live_ عند الشحن أو الاشتراك.
كيف أختبر في التطوير؟
استخدم مفاتيح test في build التطوير. أنشئ جلسة ثم اتصل برقم البوابة من نفس الهاتف. test بوابات حقيقية + رصيد — مثل live.
هل test يستخدم بوابات حقيقية؟
نعم. test و live بوابات Android حقيقية. الفرق: بادئة المفتاح وأي build.
لماذا رصيدي 0؟
قيد المراجعة أو بدون رصيد تجريبي → 0 حتى تشحن. test و live يستهلكان رصيداً.
ما الذي يؤثر على التجربة؟
درجة مخاطر عالية → بدون رصيد تجريبي. pk_live_ مسموح عند وجود رصيد.
ما هو receipt؟
JWT موقّع يثبت نجاح التحقق. تحقق منه مرة واحدة على الخادم — إعادة الاستخدام مرفوضة (SH_014).
كيف أحصل على رصيد؟
المؤسسات الجديدة تحصل على trial credits مرة واحدة بعد تأكيد البريد. بعد التجربة: اشتراك أو شحن من الفوترة.
كيف أغير Package Name؟
PATCH billing أو POST android-signatures. يجب مطابقة applicationId.
كيف أضيف SHA256؟
keytool -list -v ثم POST /v1/apps/:id/android-signatures.
هل رقم البوابة ثابت؟
live و test: gateway_phone_number ديناميكي لكل جلسة — لا تثبّته. اتصل من هاتف المستخدم.
هل يوجد iOS SDK؟
نعم — نفس حزمة shernova_core على iOS. سجّل Bundle ID + Team ID من الإعدادات. CLI يقرأ Info.plist و Xcode عند الإمكان.
ما حدود MVP؟
عدة تطبيقات لكل مؤسسة برصيد مشترك. TTL الجلسة 300 ثانية افتراضياً.
هل يحتاج المستخدم شريحة SIM؟
نعم — يجب الاتصال من نفس الرقم المُدخل. الأجهزة اللوحية بدون telephony لا تكمل التحقق.
هل auto-return يعمل على Xiaomi؟
عادة نعم مع shernova_ui 2.2.0+ عند منح Phone و Notifications و Call phone. بعض OEM قد تحتاج إعدادات بطارية/تشغيل تلقائي اختيارية.
هل Google Play يطلب إعلاناً؟
نعم عند استخدام shernova_ui على Android — إعلانات FGS و Phone. طبيعي وتم قبول تطبيقات إنتاج. راجع Google Play.