الگوها و نسخه‌بندی «پیکربندی از راه دور»

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

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

  • الگوهای کارخواه: پیکربندی‌ها را به نمونه‌های برنامه کارخواه در پلاتفرم‌های Apple،‏ Android،‏ Web،‏ Flutter،‏ Unity، و C++‎ ارائه می‌دهد. الگوهای کارخواه از شرایط براساس مخاطبان Google Analytics، نسخه‌های برنامه، پلاتفرم، زبان دستگاه، کشور، صدک‌های کاربر، و سیگنال‌های سفارشی پشتیبانی می‌کنند.

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

مقایسه الگوهای کارخواه و سرور

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

ویژگی الگوهای کارخواه الگوهای سرور
محیط‌های هدف برنامه‌های کارخواه (Apple،‏ Android،‏ Web،‏ Flutter،‏ Unity،‏ C++) محیط‌های سرور (Cloud Run، Cloud Functions for Firebase، GKE، سرویس‌های پس‌زمینه)
کیت‌های توسعه نرم‌افزار پشتیبانی‌شده کیت‌های توسعه نرم‌افزار کارخواه Firebase Firebase Admin SDK (Node.js،‏ Python،‏ Go،‏ Java)
ابزارهای مدیریت کنسول Firebase، 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).

محدودیت‌های نسخه و حفظ

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

برگشتن‌ها

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

وارد و صادر کردن

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

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

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

پیش‌فرض‌های الگو

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

مراحل بعدی