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

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

    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 قبولها. الرمز المميز الذي يرسله على أنه صالح.