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

قوالب 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 console وFirebase CLI و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.

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