الترقية إلى وضع الإنتاج

توضّح هذه الصفحة كيفية استخدام Firebase Phone Number Verification مع تطبيق Android في مرحلة الإنتاج. يُرجى الاطّلاع على دليل البدء على Android لمعرفة كيفية اختبار "Firebase PNV" في تطبيق Android باستخدام وضع الاختبار بدون شريحة SIM.

بعد تفعيل وضع الإنتاج، سيتمكّن تطبيقك من الحصول على أرقام هواتف تم التحقّق منها على أجهزة حقيقية، طالما أنّها تحتوي على أجهزة ومشغّل شبكة جوّال متوافقَين.

قبل البدء

  • يجب تنفيذ واختبار مسار المستخدم في Firebase PNV وعملية الدمج في الخلفية من خلال اتّباع الخطوات الواردة في دليل البدء على Android.

  • يجب تسجيل الدخول إلى وحدة تحكّم "Firebase" بصفتك عضوًا في المشروع ولديك امتيازات المالك في مشروع Firebase الخاص بالتطبيق.

  • يجب أن يكون لديك صفحة رئيسية وسياسة خصوصية متاحتان للجميع على نطاق خاص تملكه لإكمال عملية التحقّق من العلامة التجارية في OAuth. يمكنك استخدام Firebase Hosting لاستضافة هذه الصفحات، طالما أنّك تربط نطاقًا خاصًا، لأنّ نطاقات .web.app و.firebaseapp.com التلقائية غير مقبولة لإثبات ملكية العلامة التجارية.

1. إيقاف وضع الاختبار في برنامج التطبيق

يجب ألا يطلب برنامج الإصدار العلني enableTestSession().

إذا اتّبعت الخطوات الواردة في قسم البدء، ستتخطّى بنيات الإصدار enableTestSession()، لأنّ الطلب لا يتم تشغيله إلا في الإصدارات المخصّصة لتصحيح الأخطاء، وتضبط بنية الإصدار FPNV_TEST_TOKEN على قيمة فارغة. تأكَّد من عدم ضبط أيّ من أنواع أو خيارات بنية الإصدار على FPNV_TEST_TOKEN، ووزِّع بنية الإصدار كعميل إنتاج.

إذا كنت تستدعي enableTestSession() في مكان آخر، عليك إزالة هذا الاستدعاء من برنامج الإنتاج:

Kotlin 

fpnv.enableTestSession(/* token */)  // Remove this.

يمكنك مواصلة إنشاء إصدارات تطوير غير علنية من برنامج تطبيقك الذي يستدعي enableTestSession().

يُرجى العِلم أنّ عملية تأكيد رقم الهاتف لن تعمل في مرحلة الإنتاج إلا بعد إكمال الخطوات الواردة في القسم التالي أيضًا.

2. تفعيل الإنتاج في مشروعك

اتّبِع الخطوات التالية لتفعيل وضع الإنتاج في Firebase PNV لمشروع Firebase:

  1. اضبط قيود واجهة برمجة التطبيقات لواجهة برمجة التطبيقات Firebase Phone Number Verification.

    1. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد

    2. افتح مفتاح واجهة برمجة التطبيقات لنظام التشغيل Android وأضِف واجهة برمجة التطبيقات Firebase Phone Number Verification إلى قائمة واجهات برمجة التطبيقات المحدّدة.

  2. إذا لم يسبق لك إعداد الفوترة، يمكنك إعدادها الآن.

    تتطلّب أداة Firebase PNV خطة Blaze المَرِنة للدفع حسب الاستخدام. إذا لم تكن قد رقّيت مشروعك إلى خطة Blaze المَرِنة، سيُطلب منك ذلك أثناء إعداد وضع الإنتاج.

  3. حدِّد الملف المرجعي لشهادة SHA-256 الخاصة بتطبيقك إذا لم يسبق لك ذلك.

    1. في وحدة تحكّم Firebase، انتقِل إلى الإعدادات > علامة التبويب الإعدادات العامة.

    2. انتقِل للأسفل إلى بطاقة تطبيقاتك، واختَر تطبيق Android، وأضِف الملف المرجعي لشهادة SHA-256 في حقل الملفات المرجعية لشهادة SHA.

    يُرجى الرجوع إلى مقالة مصادقة العميل للاطّلاع على تفاصيل حول كيفية الحصول على الملف المرجعي لشهادة SHA-256 الخاصة بتطبيقك.

  4. الترقية إلى وضع الإنتاج

    1. في وحدة تحكّم Firebase، انتقِل إلى الأمان > تأكيد الحساب عبر الهاتف > علامة التبويب نظرة عامة، واختَر بيئة التشغيل الفعلي.

    2. انقر على الترقية للإصدار العلني.

      ستظهر لك قائمة بالتطبيقات في مشروعك التي سيتم تفعيلها لمرحلة الإصدار العلني، وستتاح لك الفرصة لإضافة تطبيقات أخرى.

    3. يجب إرسال تطبيقك لإجراء عملية التحقّق من العلامة التجارية باستخدام OAuth ومراجعة سياسة الخصوصية. ستتحقّق Google Cloud من أنّك تحدّد تطبيقك وسياسة الخصوصية الخاصة به بوضوح ودقة.

      إذا كنت تستضيف صفحتك الرئيسية وسياسة الخصوصية على Firebase Hosting (أو خدمة استضافة مشتركة أخرى)، تأكَّد من:

      • ربط نطاق خاص تتحكّم فيه (مثل example.com أو نطاق فرعي لنطاق تملكه) لا يمكن لنطاقات الاستضافة المشتركة، مثل .web.app و.firebaseapp.com، اجتياز عمليات التحقّق من ملكية النطاق.
      • أثبِت ملكية النطاق الخاص في Google Search Console باعتباره موقعًا إلكترونيًا على النطاق باستخدام سجلّ TXT لنظام أسماء النطاقات (وليس موقعًا إلكترونيًا يحمل بادئة عنوان URL)، وذلك من خلال تسجيل الدخول باستخدام حساب يملك دور المالك في مشروعك على Google Cloud.
      • اضبط عنوان URL لصفحتك الرئيسية وعنوان URL لسياسة الخصوصية والنطاقات المصرَّح بها في Google Auth Platform باستخدام نطاقك الخاص، وتأكَّد من أنّ صفحتك الرئيسية تعرض اسم تطبيقك بوضوح وتصف وظيفة التطبيق وتتضمّن رابطًا يؤدي إلى سياسة الخصوصية.

      لبدء المراجعة، انقر على المتابعة في Google Cloud. قد تستغرق هذه العملية أحيانًا 24 ساعة أو أكثر.

    4. أثناء انتظار التحقّق من العلامة التجارية، يُرجى مراجعة البنود الخاصة بخدمة Firebase Phone Number Verification، والتي يمكن الوصول إليها من خلال الرابط في وحدة تحكّم Firebase.

    5. بعد اجتياز عملية التحقّق من العلامة التجارية، ضَع علامة في المربّع للإقرار بالبنود الخاصة بالخدمة، ثم انقر على تفعيل.

      تم تفعيل "Firebase Phone Number Verification" الآن في وضع الإنتاج.