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

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

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

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

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

    سويفت

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

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

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

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

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

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

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

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

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

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

  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، قم بإنشاء وتعيين مصنع موفر تصحيح أخطاء التحقق من التطبيق:

    سويفت

    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 الخلفية الرمز المميز الذي يرسله باعتباره صالحًا.