استخدام ميزة "التحقّق من التطبيقات" مع موفِّر تصحيح الأخطاء مع Flutter

بعد تسجيل تطبيقك في فحص التطبيقات، لن يتم تشغيله عادةً في محاكي أو من بيئة دمج متواصل (CI)، لأنّ هذه البيئات لا تُعدّ أجهزة صالحة. إذا أردت تشغيل تطبيقك في مثل هذه البيئة أثناء عملية التطوير والاختبار، يمكنك إنشاء إصدار مخصص لتصحيح الأخطاء من تطبيقك يستخدم موفّر تصحيح الأخطاء في فحص التطبيقات بدلاً من موفّر إثبات صحة حقيقي.

تحذير: يتيح موفّر تصحيح الأخطاء الوصول إلى موارد Firebase من أجهزة لم يتم التحقّق منها. لا تستخدِم موفّر تصحيح الأخطاء في إصدارات تطبيقك المخصّصة للإنتاج، ولا تشارك إصدارات تصحيح الأخطاء مع جهات غير موثوق بها.

منصات Apple

لاستخدام موفّر تصحيح الأخطاء أثناء تشغيل تطبيقك في محاكي بشكل تفاعلي (أثناء التطوير، على سبيل المثال)، اتّبِع الخطوات التالية:

1. فعِّل فحص التطبيقات باستخدام موفّر تصحيح الأخطاء بعد إعداد تطبيق Firebase مباشرةً:

   import 'package:flutter/material.dart';
   import 'package:firebase_core/firebase_core.dart';
   
   // Import the firebase_app_check plugin
   import 'package:firebase_app_check/firebase_app_check.dart';
   
   Future<void> main() async {
     WidgetsFlutterBinding.ensureInitialized();
     await Firebase.initializeApp();
     await FirebaseAppCheck.instance.activate(
       // Set appleProvider to `AppleProvider.debug`
       appleProvider: AppleProvider.debug,
     );
     runApp(App());
   }
   

2. فعِّل تسجيل معلومات تصحيح الأخطاء في مشروع Xcode (الإصدار 11.0 أو إصدار أحدث):

   1. افتح المنتج (Product) > المخطّط (Scheme) > تعديل المخطّط (Edit scheme).
   2. انقر على تشغيل (Run) من القائمة اليمنى، ثمّ انقر على علامة التبويب الوسيطات (Arguments).
   3. في قسم المَعلمات التي تم ضبطها عند الإطلاق (Arguments Passed on Launch)، أضِف -FIRDebugEnabled.

3. افتح ios/Runner.xcworkspace باستخدام Xcode وشغِّل تطبيقك في المحاكي. سيطبع تطبيقك رمز تصحيح أخطاء محليًا في ناتج تصحيح الأخطاء عندما تحاول Firebase إرسال طلب إلى الخلفية. على سبيل المثال:

   Firebase App Check Debug Token:
   123a4567-b89c-12d3-e456-789012345678

4. في وحدة تحكّم Firebase، انتقِل إلى الأمان > فحص التطبيقات > التطبيقات.

5. سجِّل رمز تصحيح الأخطاء الذي سجّلته للتو.

   1. من القائمة الكاملة لتطبيقك، اختَر إدارة الرموز المميزة لتصحيح الأخطاء.
   2. اتّبِع التعليمات الظاهرة على الشاشة لتسجيل رمز تصحيح الأخطاء.

   

بعد تسجيل الرمز المميّز، ستقبله خدمات الخلفية في Firebase كرمز صالح.

بما أنّ هذا الرمز المميّز يتيح الوصول إلى موارد Firebase بدون جهاز صالح، من الضروري الحفاظ على خصوصيته. لا ترسِل الرمز المميّز إلى مستودع عام، وإذا تم اختراق رمز مميّز مسجّل، عليك إبطاله على الفور في وحدة تحكّم Firebase.

Android

لاستخدام موفّر تصحيح الأخطاء أثناء تشغيل تطبيق Flutter في بيئة Android، نفِّذ الرمز التالي في تطبيق Flutter:

import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';

// Import the firebase_app_check plugin
import 'package:firebase_app_check/firebase_app_check.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  await FirebaseAppCheck.instance.activate(
    webRecaptchaSiteKey: 'recaptcha-v3-site-key',
    // Set androidProvider to `AndroidProvider.debug`
    androidProvider: AndroidProvider.debug,
  );
  runApp(App());
}

سيطبع تطبيقك رمز تصحيح أخطاء محليًا في ناتج تصحيح الأخطاء عندما تحاول Firebase إرسال طلب إلى الخلفية. على سبيل المثال:

D DebugAppCheckProvider: Enter this debug secret into the allow list in
the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678

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

2. سجِّل رمز تصحيح الأخطاء الذي سجّلته للتو.

   1. من القائمة الكاملة لتطبيقك، اختَر إدارة الرموز المميزة لتصحيح الأخطاء.
   2. اتّبِع التعليمات الظاهرة على الشاشة لتسجيل رمز تصحيح الأخطاء.

   

بعد تسجيل الرمز المميز، ستقبله خدمات الخلفية في Firebase على أنّه صالح.

الويب

لاستخدام موفّر تصحيح الأخطاء أثناء تشغيل تطبيقك من localhost (أثناء عملية التطوير مثلاً)، اتّبِع الخطوات التالية:

تحذير: لا تحاول تفعيل تصحيح أخطاء localhost من خلال إضافة localhost إلى النطاقات المسموح بها في reCAPTCHA. سيؤدي ذلك إلى السماح لأي شخص بتشغيل تطبيقك من الأجهزة المحلية.

1. في الملف web/index.html، فعِّل وضع تصحيح الأخطاء من خلال ضبط self.FIREBASE_APPCHECK_DEBUG_TOKEN على true:

   <body>
     <script>
       self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
     </script>
   
     ...
   
   </body>
   

2. شغِّل تطبيق الويب على جهازك وافتح أداة المطوّرين في المتصفّح. في وحدة تحكّم تصحيح الأخطاء، سيظهر رمز مميّز لتصحيح الأخطاء:

   AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678". You will
   need to safelist it in the Firebase console for it to work.

   يتم تخزين هذا الرمز المميّز محليًا في متصفّحك وسيتم استخدامه كلما استخدمت تطبيقك في المتصفّح نفسه على الجهاز نفسه. إذا أردت استخدام الرمز المميّز في متصفّح آخر أو على جهاز آخر، اضبط قيمة self.FIREBASE_APPCHECK_DEBUG_TOKEN على سلسلة الرمز المميّز بدلاً من true.

3. في وحدة تحكّم Firebase، انتقِل إلى الأمان > فحص التطبيقات > التطبيقات.

4. سجِّل رمز تصحيح الأخطاء الذي سجّلته للتو.

   1. من القائمة الكاملة لتطبيقك، اختَر إدارة الرموز المميزة لتصحيح الأخطاء.
   2. اتّبِع التعليمات الظاهرة على الشاشة لتسجيل رمز تصحيح الأخطاء.

   

بعد تسجيل الرمز المميّز، ستقبله خدمات الخلفية في Firebase كرمز صالح.

بما أنّ هذا الرمز المميّز يتيح الوصول إلى موارد Firebase بدون جهاز صالح، من الضروري الحفاظ على خصوصيته. لا ترسِل الرمز المميّز إلى مستودع عام، وإذا تم اختراق رمز مميّز مسجّل، عليك إبطاله على الفور في وحدة تحكّم Firebase.