مسار 5 دقائق
حساب → تطبيق → مفاتيح test → pub.dev → CLI → تحقق test → مفاتيح live → جاهز للإنتاج.
الخطوة 1 — إنشاء حساب
سجّل من صفحة التسجيل، فعّل بريدك، ثم ادخل لوحة التحكم.
الخطوة 2 — إنشاء تطبيق
من لوحة التحكم افتح التطبيقات ثم + تطبيق جديد. أول تطبيق قد يفتح نموذج الإنشاء تلقائياً.
أدخل اسم التطبيق فقط.
حقل Webhook اختياري — اتركه فارغاً الآن إن لم يكن لديك endpoint جاهز.
للإنتاج أضف Webhook لاحقاً من تبويب الإعدادات (راجع الخطوة 8).
اضغط إنشاء التطبيق.
بعد الإنشاء: تبويب البدء السريع للمعالج، وتبويب مفاتيح API لنسخ المفاتيح.
الصورة أدناه لتطبيق موجود — زر حفظ التغييرات يظهر عند تعديل الإعدادات وليس عند الإنشاء الأول.
الخطوة 3 — انسخ مفاتيح test
انسخ pk_test_ و sk_test_. استخدمها للتطوير فقط.
الخطوة 4 — تثبيت SDK الأساسي
استخدم shernova_core — وليس shernova
حزمة shernova (1.x) مهملة. ثبّت دائماً shernova_core (^2.0.0). shernova_ui اختياري.
dart pub add shernova_core:^2.0.0
dart pub add --dev shernova_cli:^2.0.0shernova_core إلزامي. shernova_ui اختياري — dart pub add shernova_ui:^2.0.0 أو --with-ui.
الخطوة 5 — shernova_cli setup
dart run shernova_cli setup --pk pk_test_YOUR_KEY --app-id YOUR_APP_UUID
# UI اختياري: --with-uiالخطوة 6 — تحقق بمفاتيح test
Headless: Shernova.verify + Shernova.watch. أو verifyPhone() إذا أضفت shernova_ui. أنشئ جلسة test ثم اتصل برقم البوابة من نفس الهاتف — مفاتيح test تستخدم بوابات حقيقية وتستهلك رصيداً.
الخطوة 7 — التبديل إلى live
استبدل pk_test_ بـ pk_live_ في التطبيق و sk_live_ على الخادم. المكالمة الحقيقية في الإنتاج.
الخطوة 8 — جاهز للإنتاج
- Webhook + التحقق من receipt على الخادم.
- تابع رصيد المؤسسة من الفوترة. بعد انتهاء التجربة: اشترك بباقة أو اشحن رصيداً.
- Android مع shernova_ui: أكمل إعلانات Google Play.
- iOS: راجع دليل iOS.
