تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

أنظمة Apple الأساسية

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

تفعيل ميزة "فحص التطبيقات" من خلال موفِّر خدمة تصحيح الأخطاء مباشرةً بعد الانتهاء لتطبيقك على 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());
}

فعِّل تسجيل تصحيح الأخطاء في مشروع Xcode (الإصدار 11.0 أو إصدار أحدث):
1. افتح المنتج >. المخطط > تعديل المخطّط
2. حدد تشغيل من القائمة اليمنى، ثم حدد علامة التبويب الوسيطات.
3. في قسم الوسيطات التي تم تمريرها عند الإطلاق، أضِف -FIRDebugEnabled.
افتح ios/Runner.xcworkspace باستخدام Xcode وشغِّل تطبيقك في المحاكي. سيطبع تطبيقك رمز تنشيط تصحيح أخطاء محليًا في مخرجات تصحيح الأخطاء عندما يحاول Firebase إرسال طلب إلى الخلفية. على سبيل المثال:
```
Firebase App Check Debug Token:
123a4567-b89c-12d3-e456-789012345678
```
في قسم App Check من وحدة تحكّم Firebase، اختَر إدارة الرموز المميّزة لتصحيح الأخطاء من قائمةoverflow التطبيق. بعد ذلك، سجِّل الرمز المميّز لتصحيح الأخطاء الذي سجّلت الدخول باستخدامه في الخطوة السابقة.

بعد تسجيل الرمز المميّز، ستقبل خدمات الخلفية في 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

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

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

الويب

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

في الملف "web/index.html"، يمكنك تفعيل وضع تصحيح الأخطاء من خلال ضبط. من self.FIREBASE_APPCHECK_DEBUG_TOKEN إلى true:
```
<body>
  <script>
    self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
  </script>

  ...

</body>
```
شغِّل تطبيق الويب على الجهاز وافتح أداة المطوّر في المتصفّح. في جلسة المعمل، وحدة تحكم تصحيح الأخطاء، سيظهر لك رمز مميز لتصحيح الأخطاء:
```
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.
في قسم App Check من وحدة تحكّم Firebase، اختَر إدارة الرموز المميّزة لتصحيح الأخطاء من قائمةoverflow التطبيق. ثم سجّل الرمز المميز لتصحيح الأخطاء الذي سجلته في المرة السابقة .

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

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