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

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

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

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

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

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

    لقطة شاشة لعنصر القائمة &quot;Manage Debug Tokens&quot; (إدارة الرموز المميّزة لتصحيح الأخطاء)

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

    لقطة شاشة لعنصر القائمة &quot;Manage Debug Tokens&quot; (إدارة الرموز المميّزة لتصحيح الأخطاء)

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

    لقطة شاشة لعنصر القائمة &quot;Manage Debug Tokens&quot; (إدارة الرموز المميّزة لتصحيح الأخطاء)

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

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