نماذج الإعداد عن بُعد وإصداراتها

نماذج Remote Config هي مجموعات من المَعلمات والشروط بتنسيق JSON تم إنشاؤها لمشروع Firebase. ينظّم Remote Config الإعدادات في نماذج يمكن إنشاؤها وتعديلها وإصدارها والعودة إلى إصدار سابق منها.

بناءً على البنية التي تستخدمها، يمكنك إنشاء نماذج العميل أو نماذج الخادم أو كليهما وإدارتها:

  • نماذج العملاء: تتيح عرض الإعدادات على نُسخ تطبيق العميل على أنظمة Apple وAndroid والويب وFlutter وUnity وC++. تتيح نماذج العملاء استخدام الشروط استنادًا إلى شرائح جمهور "Google Analytics" وإصدارات التطبيق والنظام الأساسي ولغة الجهاز والبلد والشرائح المئوية للمستخدمين والإشارات المخصّصة.

  • نماذج الخادم: يمكنك عرض الإعدادات في بيئات الخلفية، مثل Cloud Run أو Cloud Functions for Firebase أو الخوادم المستندة إلى حاويات باستخدام Firebase Admin SDK للغات Node.js وPython وGo وJava. تُقيّم نماذج الخادم المَعلمات من جهة الخادم بوقت استجابة يقترب من الصفر باستخدام إشارات الخادم المخصّصة وعمليات الطرح بنسبة مئوية عشوائية.

مقارنة نماذج العميل والخادم

تتم إدارة نماذج العميل والخادم بشكل مستقل ضمن مشروعك على Firebase. استخدِم الجدول التالي لفهم أوجه الاختلاف بين نماذج العميل والخادم:

الميزة نماذج العملاء نماذج الخوادم
البيئات المستهدَفة تطبيقات العملاء (Apple وAndroid والويب وFlutter وUnity وC++‎) بيئات الخادم (Cloud Run وCloud Functions for Firebase وGKE وخدمات الخلفية)
حِزم SDK المتوافقة حِزم تطوير البرامج (SDK) لعملاء Firebase Firebase Admin SDK (Node.js وPython وGo وJava)
أدوات الإدارة وحدة تحكّم Firebase، وواجهة سطر أوامر Firebase، وREST API، وFirebase Admin SDK وحدة تحكّم "Firebase"
موقع وحدة التحكّم المَعلمات و الشروط المَعلمات و الشروط
تنزيل الإعدادات التلقائية للنماذج متوافقة (XML لنظام التشغيل Android وPLIST لنظام التشغيل iOS وJSON للويب) لا ينطبق (القيم التلقائية المحدّدة في رمز الخادم أو الخلفية)
دليل مفصّل إدارة نماذج العملاء إدارة نماذج الخادم

دورة حياة النماذج وإصداراتها

سواء كنت تعمل مع نماذج العميل أو نماذج الخادم، يوفّر Remote Config إمكانية التحكّم في الإصدارات وإدارة مراحل النشاط:

إنشاء النُسخ وتتبُّعها

في كل مرة تعدّل فيها المَعلمات أو الشروط، تنشئ "Remote Config" نموذج "Remote Config" جديدًا بإصدار محدّد وتخزّن النموذج السابق كإصدار يمكنك استرداده أو الرجوع إليه حسب الحاجة. تتم زيادة أرقام الإصدارات بشكل تسلسلي من القيمة الأولية المخزّنة بواسطة Remote Config.

تتضمّن جميع النماذج حقل version يحتوي على بيانات وصفية حول هذا الإصدار المحدّد، مثل:

  • ‫versionNumber: رقم الإصدار التسلسلي للنموذج
  • ‫updateTime: الطابع الزمني لوقت نشر النموذج
  • ‫updateUser: البريد الإلكتروني أو هوية المستخدم الذي أجرى التعديل
  • updateOrigin: طريقة إجراء التغيير (على سبيل المثال، CONSOLE أو REST_API أو ADMIN_SDK_NODE)
  • ‫updateType: طبيعة التغيير (على سبيل المثال، INCREMENTAL_UPDATE أو FORCED_UPDATE).

حدود النُسخ والاحتفاظ بالبيانات

هناك حدّ أقصى إجمالي يبلغ 300 نسخة مخزَّنة على مدار فترة الاستخدام لكل نوع نموذج (300 نموذج للعميل و300 نموذج للخادم)، ويشمل ذلك أرقام النُسخ المخزَّنة للنماذج المحذوفة. إذا نشرت أكثر من 300 نسخة من النماذج لكل نوع نموذج خلال فترة عمل المشروع، سيتم حذف النُسخ الأقدم، مع الاحتفاظ بحد أقصى 300 نسخة من هذا النوع.

عمليات العودة إلى الحالة السابقة

يمكنك الرجوع إلى أي نسخة مخزَّنة من نموذج في أي وقت. عند العودة إلى إصدار سابق، ينشئ Remote Config إصدارًا جديدًا يتطابق محتواه مع الإصدار السابق المحدّد. على سبيل المثال، تؤدي العودة من الإصدار 10 إلى الإصدار 6 إلى إنشاء الإصدار 11 بالإعدادات من الإصدار 6.

الاستيراد والتصدير

يمكنك تنزيل النموذج النشط كملف JSON ونشره في المشروع نفسه أو في مشروع آخر. تتيح لك هذه الميزة ما يلي:

  • تخزين تعريفات النماذج في نظام التحكّم بالمصادر (مثل Git)
  • دمج عمليات نشر الإعدادات في مسارات CI/CD
  • نقل الإعدادات من مرحلة إلى أخرى (على سبيل المثال، من مشروع تطوير أو مرحلة تجريبية إلى مرحلة الإنتاج)
  • نقل الإعدادات بين المشاريع

لا يتم تضمين المَعلمات وقيم المَعلمات التي تم إنشاؤها خصيصًا كصيغ في تجربة A/B Testing في النماذج التي يتم تصديرها.

الإعدادات التلقائية للنماذج

بالنسبة إلى تطبيقات العميل، يمكنك تنزيل ملفات تحتوي على القيم التلقائية للمَعلمات بتنسيق XML أو PLIST أو JSON لتضمينها في تطبيقك. للحصول على التعليمات، يُرجى الاطّلاع على تنزيل القيم التلقائية لنموذج Remote Config.

الخطوات التالية