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

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

استخدام موفِّر تصحيح الأخطاء قيد التطوير

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

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

    Swift

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

FirebaseApp.configure()

    Objective-C

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

    Swift

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

FirebaseApp.configure()

    Objective-C

    FIRAppCheckDebugProviderFactory *providerFactory =
      [[FIRAppCheckDebugProviderFactory alloc] init];
[FIRAppCheck setAppCheckProviderFactory:providerFactory];

// Use Firebase library to configure APIs
[FIRApp configure];

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