قالب‌های پیکربندی از راه دور و نسخه‌بندی

قالب‌های Remote Config مجموعه‌ای از پارامترها و شرایط با فرمت JSON هستند که برای پروژه Firebase شما ایجاد می‌شوند. Remote Config پیکربندی‌ها را در قالب‌هایی سازماندهی می‌کند که می‌توانند ایجاد، به‌روزرسانی، نسخه‌بندی و به حالت قبل بازگردند.

بسته به معماری سیستم خود، می‌توانید قالب‌های کلاینت، قالب‌های سرور یا هر دو را ایجاد و مدیریت کنید:

  • قالب‌های کلاینت : پیکربندی‌ها را به نمونه‌های برنامه کلاینت در سراسر پلتفرم‌های اپل، اندروید، وب، فلاتر، یونیتی و ++C ارائه دهید. قالب‌های کلاینت از شرایط مبتنی بر مخاطبان Google Analytics ، نسخه‌های برنامه، پلتفرم، زبان دستگاه، کشور، درصد کاربران و سیگنال‌های سفارشی پشتیبانی می‌کنند.

  • قالب‌های سرور : پیکربندی‌ها را برای محیط‌های backend مانند Cloud Run ، Cloud Functions for Firebase یا سرورهای کانتینری با استفاده از Firebase Admin SDK برای Node.js، Python، Go و Java ارائه دهید. قالب‌های سرور، پارامترها را در سمت سرور با تأخیر نزدیک به صفر با استفاده از سیگنال‌های سفارشی سرور و درصدهای تصادفی ارزیابی می‌کنند.

مقایسه قالب‌های کلاینت و سرور

قالب‌های کلاینت و سرور به طور مستقل در پروژه Firebase شما نگهداری می‌شوند. از جدول زیر برای درک تفاوت قالب‌های کلاینت و سرور استفاده کنید:

ویژگی قالب‌های مشتری قالب‌های سرور
محیط‌های هدف برنامه‌های کلاینت (اپل، اندروید، وب، فلاتر، یونیتی، سی‌پلاس‌پلاس) محیط‌های سرور ( Cloud Run ، Cloud Functions for Firebase ، GKE ، سرویس‌های بک‌اند)
SDK های پشتیبانی شده SDK های کلاینت فایربیس Firebase Admin SDK (Node.js، پایتون، گو، جاوا)
ابزارهای مدیریتی کنسول Firebase ، رابط خط فرمان Firebase ، رابط برنامه‌نویسی کاربردی REST، Firebase Admin SDK کنسول Firebase
محل کنسول پارامترها و شرایط پارامترها و شرایط
دانلود پیش‌فرض‌های قالب پشتیبانی‌شده (XML برای اندروید، PLIST برای iOS، JSON برای وب) قابل اجرا نیست (مقادیر پیش‌فرض در کد سرور یا backend تعریف شده‌اند)
راهنمای دقیق مدیریت قالب‌های مشتری مدیریت قالب‌های سرور

چرخه حیات قالب و نسخه‌بندی

چه با قالب‌های کلاینت کار کنید و چه با قالب‌های سرور، Remote Config کنترل نسخه داخلی و مدیریت چرخه عمر را ارائه می‌دهد:

ایجاد و ردیابی نسخه

هر بار که پارامترها یا شرایط را به‌روزرسانی می‌کنید، Remote Config یک الگوی Remote Config نسخه‌بندی‌شده جدید ایجاد می‌کند و الگوی قبلی را به عنوان نسخه‌ای ذخیره می‌کند که می‌توانید در صورت نیاز آن را بازیابی یا به حالت قبل برگردانید. شماره نسخه‌ها به ترتیب از مقدار اولیه ذخیره شده توسط Remote Config افزایش می‌یابند.

همه قالب‌ها شامل یک فیلد version هستند که شامل ابرداده‌هایی درباره آن نسخه خاص است، مانند:

  • versionNumber : شماره نسخه ترتیبی الگو.
  • updateTime : نشانگر زمانی که قالب منتشر شده است.
  • updateUser : ایمیل یا هویت کاربری که به‌روزرسانی را انجام داده است.
  • updateOrigin : نحوه‌ی اعمال تغییر (برای مثال، CONSOLE ، REST_API یا ADMIN_SDK_NODE ).
  • updateType : ماهیت تغییر (برای مثال، INCREMENTAL_UPDATE یا FORCED_UPDATE ).

محدودیت‌های نسخه و نگهداری

در مجموع، محدودیت ۳۰۰ نسخه ذخیره‌شده مادام‌العمر برای هر نوع الگو (۳۰۰ الگوی کلاینت و ۳۰۰ الگوی سرور) وجود دارد که شامل شماره نسخه‌های ذخیره‌شده برای الگوهای حذف‌شده نیز می‌شود. اگر در طول عمر یک پروژه، بیش از ۳۰۰ نسخه الگو برای هر نوع الگو منتشر کنید، نسخه‌های اولیه حذف می‌شوند و حداکثر ۳۰۰ نسخه از آن نوع حفظ می‌شود.

عقبگردها

شما می‌توانید در هر زمانی به هر نسخه ذخیره شده از یک الگو برگردید. وقتی به عقب برمی‌گردید، Remote Config یک نسخه جدید ایجاد می‌کند که محتوای آن با نسخه تاریخی انتخاب شده مطابقت دارد. به عنوان مثال، برگشت از نسخه 10 به نسخه 6، نسخه 11 را با پیکربندی نسخه 6 ایجاد می‌کند.

واردات و صادرات

شما می‌توانید قالب فعال خود را به صورت یک فایل JSON دانلود کرده و آن را در همان پروژه یا پروژه دیگری منتشر کنید. این قابلیت به شما امکان می‌دهد:

  • تعاریف قالب را در کنترل منبع (مانند Git) ذخیره کنید.
  • پیاده‌سازی‌های پیکربندی را در خطوط لوله CI/CD ادغام کنید.
  • پیکربندی‌ها را در مراحل مختلف (مثلاً از یک پروژه توسعه یا مرحله‌بندی تا تولید) ارتقا دهید.
  • انتقال پیکربندی‌ها بین پروژه‌ها

پارامترها و مقادیر پارامتری که به طور خاص به عنوان گونه‌های مختلف در یک آزمایش A/B Testing ایجاد شده‌اند، در قالب‌های صادر شده لحاظ نمی‌شوند.

پیش‌فرض‌های قالب

برای برنامه‌های کلاینت، می‌توانید فایل‌های حاوی مقادیر پیش‌فرض پارامترها را در قالب XML، PLIST یا JSON دانلود کنید تا با برنامه خود همراه کنید. برای دستورالعمل‌ها، به «دانلود پیش‌فرض‌های قالب Remote Config » مراجعه کنید.

مراحل بعدی