معلمات وشروط التكوين عن بعد

عند استخدام وحدة تحكم Firebase أو واجهات برمجة التطبيقات الخلفية للتكوين عن بُعد ، فإنك تحدد معلمة واحدة أو أكثر (أزواج من قيم المفاتيح) وتوفر قيمًا افتراضية داخل التطبيق لهذه المعلمات. يمكنك تجاوز القيم الافتراضية داخل التطبيق من خلال تحديد قيم المعلمات من جانب الخادم. مفاتيح المعلمات وقيم المعلمات عبارة عن سلاسل ، ولكن يمكن تحويل قيم المعلمات إلى أنواع بيانات أخرى عند استخدام هذه القيم في تطبيقك.

باستخدام وحدة تحكم Firebase أو Remote Config REST API ، يمكنك إنشاء قيم افتراضية جديدة لمعلماتك ، بالإضافة إلى القيم الشرطية المستخدمة لاستهداف مجموعات من مثيلات التطبيق. في كل مرة تقوم فيها بتحديث التكوين الخاص بك في وحدة تحكم Firebase ، يقوم Firebase بإنشاء ونشر إصدار جديد من نموذج Remote Config الخاص بك. يتم تخزين الإصدار السابق ، مما يسمح لك بالاسترداد أو التراجع حسب الحاجة. هذه العمليات متاحة لك أيضًا عبر REST API.

يشرح هذا الدليل المعلمات والشروط والقواعد والقيم الشرطية وكيفية إعطاء الأولوية لقيم المعلمات المختلفة على خادم التكوين عن بُعد وفي تطبيقك. كما يوفر تفاصيل حول أنواع القواعد المستخدمة لإنشاء الشروط.

الشروط والقواعد والقيم الشرطية

يُستخدم الشرط لاستهداف مجموعة من مثيلات التطبيق. تتكون الشروط من قاعدة واحدة أو أكثر والتي يجب أن يتم تقييمها جميعًا على أنها true حتى يتم تقييم الشرط إلى true بالنسبة لمثيل تطبيق معين. إذا كانت قيمة القاعدة غير محددة (على سبيل المثال ، عندما لا تتوفر قيمة) ، فسيتم تقييم هذه القاعدة إلى false .

على سبيل المثال ، يمكن للمعلمة التي تحدد صفحة البداية للتطبيق أن تعرض صورًا مختلفة بناءً على نوع نظام التشغيل باستخدام القاعدة البسيطة if device_os = Android :

أو ، يمكن استخدام شرط زمني للتحكم في وقت عرض تطبيقك لعناصر ترويجية خاصة.

يمكن أن تحتوي المعلمة على قيم شرطية متعددة تستخدم شروطًا مختلفة ، ويمكن للمعلمات مشاركة الشروط داخل المشروع.

أولوية قيمة المعلمة

قد تحتوي المعلمة على العديد من القيم الشرطية المرتبطة بها. تحدد القواعد التالية القيمة التي يتم جلبها من خادم التكوين البعيد ، والقيمة التي يتم استخدامها في مثيل تطبيق معين في وقت معين:

يتم جلب قيم المعلمات من جانب الخادم وفقًا لقائمة الأولويات التالية

1. أولاً ، يتم تطبيق القيم الشرطية ، إن وجدت لها شروط يتم تقييمها على أنها true لمثيل تطبيق معين. إذا تم تقييم عدة شروط على أنها true ، فإن أول (أعلى) يظهر في واجهة مستخدم وحدة تحكم Firebase يكون له الأسبقية ، ويتم توفير القيم الشرطية المرتبطة بهذا الشرط عندما يجلب التطبيق قيمًا من الواجهة الخلفية. يمكنك تغيير أولوية الشروط عن طريق سحب الشروط وإفلاتها في علامة التبويب " الشروط" .

2. إذا لم تكن هناك قيم شرطية بشروط يتم تقييمها على أنها true ، يتم توفير القيمة الافتراضية من جانب الخادم عندما يجلب التطبيق قيمًا من الواجهة الخلفية. إذا كانت المعلمة غير موجودة في الواجهة الخلفية ، أو إذا تم تعيين القيمة الافتراضية على بلا قيمة ، فلن يتم تقديم أي قيمة لهذه المعلمة عندما يجلب التطبيق القيم.

في تطبيقك ، يتم إرجاع قيم المعلمات من خلال طرق get وفقًا لقائمة الأولويات التالية

1. إذا تم جلب قيمة من الواجهة الخلفية ثم تنشيطها ، فسيستخدم التطبيق القيمة التي تم جلبها. قيم المعلمات المنشطة ثابتة.
2. إذا لم يتم جلب أي قيمة من الواجهة الخلفية ، أو إذا لم يتم تنشيط القيم التي تم جلبها من الواجهة الخلفية لـ Remote Config ، فسيستخدم التطبيق القيمة الافتراضية داخل التطبيق.
3. إذا لم يتم تعيين قيمة افتراضية داخل التطبيق ، فسيستخدم التطبيق قيمة نوع ثابتة (مثل 0 لـ int و false لـ boolean ).

يلخص هذا الرسم كيفية إعطاء الأولوية لقيم المعلمات في خلفية Remote Config وفي تطبيقك:

مجموعات المعلمات

يسمح لك Remote Config بتجميع المعلمات معًا للحصول على واجهة مستخدم ونموذج عقلي أكثر تنظيماً.

على سبيل المثال ، لنفترض أنك بحاجة إلى تمكين أو تعطيل ثلاثة أنواع مختلفة من المصادقة أثناء طرح ميزة تسجيل دخول جديدة. باستخدام Remote Config ، يمكنك إنشاء المعلمات الثلاثة لتمكين الأنواع حسب الرغبة ، ثم تنظيمها في مجموعة تسمى "تسجيل دخول جديد" ، دون الحاجة إلى إضافة بادئات أو فرز خاص.

يمكنك إنشاء مجموعات معلمات باستخدام وحدة تحكم Firebase أو Remote Config REST API. كل مجموعة معلمات تقوم بإنشائها لها اسم فريد في قالب "التكوين البعيد". عند إنشاء مجموعات المعلمات ، ضع في اعتبارك:

• يمكن تضمين المعلمات في مجموعة واحدة فقط في أي وقت ، ويجب أن يظل مفتاح المعلمة فريدًا عبر جميع المعلمات.
• أسماء مجموعة المعلمات محددة بـ 256 حرفًا.
• إذا كنت تستخدم كلاً من REST API ووحدة تحكم Firebase ، فتأكد من تحديث أي منطق REST API للتعامل مع مجموعات المعلمات عند النشر.

قم بإنشاء أو تعديل مجموعات المعلمات باستخدام وحدة تحكم Firebase

يمكنك تجميع المعلمات في علامة التبويب " المعلمات" في وحدة تحكم Firebase. لإنشاء مجموعة أو تعديلها:

1. حدد إدارة المجموعات .
2. حدد مربعات الاختيار للمعلمات التي تريد إضافتها وحدد نقل إلى المجموعة .
3. حدد مجموعة موجودة ، أو أنشئ مجموعة جديدة بإدخال اسم ووصف ، واختيار إنشاء مجموعة جديدة . بعد حفظ مجموعة ، يكون متاحًا للنشر باستخدام الزر نشر التغييرات .

إنشاء مجموعات برمجيًا

يوفر Remote Config REST API طريقة آلية لإنشاء مجموعات المعلمات ونشرها. بافتراض أنك على دراية بـ REST وتم إعدادك للسماح للطلبات بواجهة برمجة التطبيقات ، يمكنك تنفيذ هذه الخطوات لإدارة المجموعات برمجيًا:

1. استرجع القالب الحالي
2. أضف كائنات JSON لتمثيل مجموعات المعلمات الخاصة بك
3. انشر مجموعات المعلمات باستخدام طلب HTTP PUT.

يحتوي كائن parameterGroups على مفاتيح المجموعة ، مع وصف متداخل وقائمة بالمعلمات المجمعة. لاحظ أن كل مفتاح مجموعة يجب أن يكون فريدًا بشكل عام.

على سبيل المثال ، هذا مقتطف من مراجعة القالب التي تضيف مجموعة المعلمات "قائمة جديدة" بمعامل واحد ، pumpkin_spice_season :

{
  "parameters": {},
  "version": {
    "versionNumber": "1",

    …


  },
  "parameterGroups": {
    "new menu": {
      "description": "New Menu",
      "parameters": {
        "pumpkin_spice_season": {
          "defaultValue": {
            "value": "true"
          },
          "description": "Whether it's currently pumpkin spice season."
        }
      }
    }
  }
}

أنواع قواعد الشرط

أنواع القواعد التالية مدعومة في وحدة تحكم Firebase. تتوفر الوظائف المكافئة في Remote Config REST API ، كما هو مفصل في مرجع التعبير الشرطي .

البحث عن المعلمات والشروط

يمكنك البحث في مفاتيح معلمات المشروع وقيم المعلمات والشروط من وحدة تحكم Firebase باستخدام مربع البحث في أعلى علامة التبويب " معلمات التكوين عن بُعد".

حدود المعلمات والشروط

ضمن مشروع Firebase ، يمكن أن يكون لديك ما يصل إلى 2000 معلمة وما يصل إلى 500 شرط. يمكن أن يصل طول مفاتيح المعلمات إلى 256 حرفًا ، ويجب أن تبدأ بشرطة سفلية أو حرف إنجليزي (AZ ، az) ، وقد تتضمن أيضًا أرقامًا. لا يمكن أن يتجاوز الطول الإجمالي لسلاسل قيمة المعلمة ضمن مشروع 800000 حرف.

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

لبدء تكوين مشروع Firebase الخاص بك ، راجع إعداد مشروع Firebase Remote Config .