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

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

استخدام مقدّم خدمة تصحيح الأخطاء في محاكي

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

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

    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. احصل على الرمز المميّز لتصحيح الأخطاء:

    1. شغِّل تطبيقك في المحاكي أو على جهاز الاختبار.

    2. افتح وحدة تحكّم Xcode وابحث عن رمز تصحيح الأخطاء App Check. على سبيل المثال:

      <Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.

    3. انسخ الرمز المميّز (على سبيل المثال، 123a4567-b89c-12d3-e456-789012345678).

  3. سجِّل رمز تصحيح الأخطاء باستخدام App Check:

    1. في وحدة تحكّم Firebase، انتقِل إلى الأمان > فحص التطبيقات > علامة التبويب التطبيقات.

    2. ابحث عن تطبيقك، وانقر على القائمة الكاملة التي تظهر على شكل ثلاث نقاط ()، ثم اختَر إدارة الرموز المميّزة لتصحيح الأخطاء.

    3. اتّبِع التعليمات الظاهرة على الشاشة لتسجيل الرمز المميّز لتصحيح الأخطاء.

    لقطة شاشة لعنصر قائمة &quot;إدارة الرموز المميّزة لتصحيح الأخطاء&quot; في وحدة تحكّم Firebase

بعد تسجيل الرمز المميّز في App Check، ستقبله خدمات الخلفية كرمز صالح.

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

استخدام مقدّم خدمة تصحيح الأخطاء في بيئة CI

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

  1. في وحدة تحكّم Firebase، أنشئ رمز تصحيح الأخطاء:

    1. في وحدة تحكّم Firebase، انتقِل إلى الأمان > فحص التطبيقات > علامة التبويب التطبيقات.

    2. ابحث عن تطبيقك، وانقر على القائمة الكاملة التي تظهر على شكل ثلاث نقاط ()، ثم اختَر إدارة الرموز المميّزة لتصحيح الأخطاء.

    3. اتّبِع التعليمات الظاهرة على الشاشة لإنشاء رمز تصحيح أخطاء جديد.

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

    لقطة شاشة لعنصر القائمة &quot;إدارة الرموز المميّزة لتصحيح الأخطاء&quot;

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

  3. إذا لزم الأمر، يمكنك ضبط نظام CI لإتاحة رمز تصحيح الأخطاء ضمن بيئة CI كمتغيّر بيئة. أدخِل اسمًا للمتغيّر، مثل APP_CHECK_DEBUG_TOKEN_FROM_CI.

  4. في Xcode، أضِف متغيّر بيئة إلى مخطّط الاختبار باسم AppCheckDebugToken وقيمة مثل $(APP_CHECK_DEBUG_TOKEN).

  5. اضبط النص البرمجي لاختبار CI لتمرير الرمز المميّز لتصحيح الأخطاء كمتغيّر بيئة. على سبيل المثال:

    xcodebuild test -scheme YOUR_TEST_SCHEME -workspace YOUR_PROJECT.xcworkspace \
APP_CHECK_DEBUG_TOKEN=$(APP_CHECK_DEBUG_TOKEN_FROM_CI)

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

    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، ستقبل خدمات الخلفية الرمز المميّز الذي يرسله التطبيق على أنّه صالح.