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

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

منصات أبل

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

  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. افتح المنتج > المخطط > تحرير المخطط .
    2. حدد "تشغيل" من القائمة اليسرى، ثم حدد علامة التبويب "الوسائط" .
    3. في قسم الوسائط التي تم تمريرها عند التشغيل ، أضف -FIRDebugEnabled .

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

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

  4. في قسم التحقق من التطبيق بوحدة تحكم Firebase، اختر إدارة الرموز المميزة لتصحيح الأخطاء من القائمة الكاملة لتطبيقك. ثم قم بتسجيل رمز التصحيح الذي قمت بتسجيله في الخطوة السابقة.

    لقطة شاشة لعنصر القائمة "إدارة رموز التصحيح".

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

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

ذكري المظهر

لاستخدام موفر تصحيح الأخطاء أثناء تشغيل تطبيق 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، اختر إدارة الرموز المميزة لتصحيح الأخطاء من القائمة الكاملة لتطبيقك. ثم قم بتسجيل رمز التصحيح الذي قمت بتسجيله في الخطوة السابقة.

    لقطة شاشة لعنصر القائمة "إدارة رموز التصحيح".

بعد تسجيل الرمز المميز، ستقبله خدمات 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. في قسم التحقق من التطبيق بوحدة تحكم Firebase، اختر إدارة الرموز المميزة لتصحيح الأخطاء من القائمة الكاملة لتطبيقك. ثم قم بتسجيل رمز التصحيح الذي قمت بتسجيله في الخطوة السابقة.

    لقطة شاشة لعنصر القائمة "إدارة رموز التصحيح".

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

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