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

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

استخدم موفر التصحيح في جهاز محاكاة

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

  1. في إصدار تصحيح الأخطاء ، قبل استخدام أي خدمات خلفية في Firebase ، قم بإنشاء وتعيين مصنع موفر تصحيح أخطاء App Check:

    سويفت

    let providerFactory = AppCheckDebugProviderFactory()
    AppCheck.setAppCheckProviderFactory(providerFactory)
    
    FirebaseApp.configure()

    ج موضوعية

    FIRAppCheckDebugProviderFactory *providerFactory =
          [[FIRAppCheckDebugProviderFactory alloc] init];
    [FIRAppCheck setAppCheckProviderFactory:providerFactory];
    
    // Use Firebase library to configure APIs
    [FIRApp configure];
  2. تمكين تسجيل التصحيح في مشروع Xcode الخاص بك (الإصدار 11.0 أو أحدث):

    1. افتح المنتج> مخطط> تحرير المخطط .
    2. حدد تشغيل من القائمة اليسرى ، ثم حدد علامة التبويب وسائط .
    3. في قسم Arguments Passed on Launch ، أضف -FIRDebugEnabled .
  3. قم بتشغيل التطبيق. سيتم تسجيل رمز التصحيح المحلي عندما يحاول SDK إرسال طلب إلى الواجهة الخلفية. فمثلا:

    [Firebase/AppCheck][I-FAA001001] Firebase App Check Debug Token:
    123a4567-b89c-12d3-e456-789012345678
  4. في قسم فحص التطبيق بوحدة تحكم Firebase ، اختر إدارة رموز تصحيح الأخطاء من القائمة الكاملة لتطبيقك. بعد ذلك ، قم بتسجيل رمز التصحيح المميز الذي قمت بتسجيل الدخول إليه في الخطوة السابقة.

    لقطة شاشة لعنصر القائمة Manage Debug Tokens

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

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

استخدم موفر التصحيح في بيئة CI

لاستخدام موفر تصحيح الأخطاء في بيئة تكامل مستمر (CI) ، قم بما يلي:

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

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

    لقطة شاشة لعنصر القائمة Manage Debug Tokens

  2. أضف رمز تصحيح الأخطاء الذي أنشأته للتو إلى مخزن المفاتيح الآمن لنظام CI الخاص بك (على سبيل المثال ، الأسرار المشفرة لـ GitHub Actions أو المتغيرات المشفرة لـ Travis CI).

  3. إذا لزم الأمر ، قم بتكوين نظام CI الخاص بك لإتاحة رمز التصحيح المميز الخاص بك داخل بيئة CI كمتغير بيئة. قم بتسمية المتغير بشيء مثل APP_CHECK_DEBUG_TOKEN_FROM_CI .

  4. في Xcode ، أضف متغير بيئة إلى مخطط الاختبار الخاص بك باسم FIRAAppCheckDebugToken وشيء مثل $(APP_CHECK_DEBUG_TOKEN) كقيمة.

  5. قم بتكوين البرنامج النصي لاختبار CI لتمرير الرمز المميز لتصحيح الأخطاء كمتغير بيئة. فمثلا:

    xcodebuild test -scheme YourTestScheme -workspace YourProject.xcworkspace \
    APP_CHECK_DEBUG_TOKEN=$(APP_CHECK_DEBUG_TOKEN_FROM_CI)
  6. في إصدار تصحيح الأخطاء ، قبل استخدام أي خدمات خلفية في Firebase ، قم بإنشاء وتعيين مصنع موفر تصحيح أخطاء App Check:

    سويفت

    let providerFactory = AppCheckDebugProviderFactory()
    AppCheck.setAppCheckProviderFactory(providerFactory)
    
    FirebaseApp.configure()

    ج موضوعية

    FIRAppCheckDebugProviderFactory *providerFactory =
          [[FIRAppCheckDebugProviderFactory alloc] init];
    [FIRAppCheck setAppCheckProviderFactory:providerFactory];
    
    // Use Firebase library to configure APIs
    [FIRApp configure];

عند تشغيل تطبيقك في بيئة CI ، ستقبل خدمات Firebase الخلفية الرمز المميز الذي يرسله على أنه صالح.