استخدام ميزة "التحقّق من التطبيقات" مع موفِّر تصحيح الأخطاء مع 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 console، انتقِل إلى الأمان (Security) > فحص التطبيقات (App Check) > علامة التبويب التطبيقات (Apps).

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

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

   

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

يسمح هذا الرمز المميّز بالوصول إلى خدماتك في الخلفية بدون جهاز صالح، لذا من الضروري الحفاظ على سريته. _**لا**_ تُرسِله إلى مستودع علني أو تُضمّنه في إصدارات الإنتاج من تطبيقك. إذا تم اختراق رمز مميّز مسجَّل، احذفه على الفور باستخدام **إدارة الرموز المميّزة لإصدار تصحيح الأخطاء (Manage debug tokens)** في Firebase console.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 console، انتقِل إلى الأمان (Security) > فحص التطبيقات (App Check) > علامة التبويب التطبيقات (Apps).

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

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

   

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

يسمح هذا الرمز المميّز بالوصول إلى خدماتك في الخلفية بدون جهاز صالح، لذا من الضروري الحفاظ على سريته. _**لا**_ تُرسِله إلى مستودع علني أو تُضمّنه في إصدارات الإنتاج من تطبيقك. إذا تم اختراق رمز مميّز مسجَّل، احذفه على الفور باستخدام **إدارة الرموز المميّزة لإصدار تصحيح الأخطاء (Manage debug tokens)** في Firebase console.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 console، انتقِل إلى الأمان (Security) > فحص التطبيقات (App Check) > علامة التبويب التطبيقات (Apps).

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

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

   

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

يسمح هذا الرمز المميّز بالوصول إلى خدماتك في الخلفية بدون جهاز صالح، لذا من الضروري الحفاظ على سريته. _**لا**_ تُرسِله إلى مستودع علني أو تُضمّنه في إصدارات الإنتاج من تطبيقك. إذا تم اختراق رمز مميّز مسجَّل، احذفه على الفور باستخدام **إدارة الرموز المميّزة لإصدار تصحيح الأخطاء (Manage debug tokens)** في Firebase console.Firebase