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

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

منصات Apple

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

1. فعِّل App Check باستخدام مقدّم خدمة تصحيح الأخطاء مباشرةً بعد تهيئة تطبيق 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. احصل على رمز تصحيح الأخطاء باتّباع الخطوات التالية:

   1. افتح ios/Runner.xcworkspace باستخدام Xcode وشغِّل تطبيقك في المحاكي أو على جهاز الاختبار.

   2. افتح وحدة تحكّم Xcode وابحث عن رمز تصحيح الأخطاء App Check. على سبيل المثال:

      <Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.
      

   3. انسخ الرمز المميّز (مثلاً، 123a4567-b89c-12d3-e456-789012345678).

4. سجِّل رمز تصحيح الأخطاء في App Check باتّباع الخطوات التالية:

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

   2. ابحث عن تطبيقك، وانقر على قائمة الخيارات الإضافية (more_vert)، ثم اختَر إدارة رموز تصحيح الأخطاء.

   3. اتّبِع التعليمات الظاهرة على الشاشة لتسجيل رمز تصحيح الأخطاء.

   

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

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

Android

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

1. فعِّل App Check باستخدام مقدّم خدمة تصحيح الأخطاء مباشرةً بعد تهيئة تطبيق 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 androidProvider to `AndroidProvider.debug`
       androidProvider: AndroidProvider.debug,
     );
     runApp(App());
   }
   
   

2. احصل على رمز تصحيح الأخطاء باتّباع الخطوات التالية:

   1. شغِّل تطبيقك في المحاكي أو على جهاز الاختبار.

   2. ابحث عن رمز تصحيح الأخطاء App Check في سجلاتك. على سبيل المثال:

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

   3. انسخ الرمز المميّز (مثلاً، 123a4567-b89c-12d3-e456-789012345678).

3. سجِّل رمز تصحيح الأخطاء في App Check باتّباع الخطوات التالية:

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

   2. ابحث عن تطبيقك، وانقر على قائمة الخيارات الإضافية (more_vert)، ثم اختَر إدارة رموز تصحيح الأخطاء.

   3. اتّبِع التعليمات الظاهرة على الشاشة لتسجيل رمز تصحيح الأخطاء.

   

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

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

الويب

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

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. سجِّل رمز تصحيح الأخطاء في App Check باتّباع الخطوات التالية:

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

   2. ابحث عن تطبيقك، وانقر على قائمة الخيارات الإضافية (more_vert)، ثم اختَر إدارة رموز تصحيح الأخطاء.

   3. اتّبِع التعليمات الظاهرة على الشاشة لتسجيل رمز تصحيح الأخطاء.

   

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

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