پیکربندی از راه دور در زمان واقعی را درک کنید

انتخاب پلتفرم: iOS+ اندروید وب فلاتر یونیتی سی پلاس پلاس

Remote Config بلادرنگ به شما امکان می‌دهد کلیدها و مقادیر پارامتر به‌روزرسانی‌شده را به محض انتشار در سرور دریافت کنید. این به شما امکان می‌دهد هر نوع ویژگی برنامه را که با استفاده از مقدار پارامتر Remote Config کنترل می‌شود، به سرعت به‌روزرسانی کنید. با به‌روزرسانی‌های Remote Config ، می‌توانید:

  • با ارائه تدریجی ویژگی‌ها به کاربران هدف و انجام یک بازگشت اضطراری در صورت نیاز، ریسک را کاهش دهید.
  • با سفارشی‌سازی سریع تجربیات کاربری هنگام استفاده از برنامه، تعامل کاربر را افزایش دهید. به عنوان مثال، می‌توانید بنرها را به‌روزرسانی کنید و برای کاربرانی که با ویژگی‌های خاص کاربر Google Analytics مطابقت دارند، مشوق‌هایی ارائه دهید یا به صورت پویا سختی بازی را برای گروه‌های مختلف بازیکنان تنظیم کنید.
  • کاهش وابستگی‌های ساخت و افزایش بهره‌وری توسعه‌دهنده: از پارامترهای Remote Config به عنوان feature flags استفاده کنید تا عملکرد را برای تیم‌های توسعه و آزمایش خود آشکار کنید، در حالی که آن را برای کاربران در محیط تولید پنهان نگه می‌دارید.

برای کسب اطلاعات بیشتر در مورد روش‌های استفاده از Remote Config ، به بخش «با Remote Config چه کارهایی می‌توان انجام داد؟» مراجعه کنید.

در این راهنما، شما:

  • درباره رابطه کلاینت-سرور که از به‌روزرسانی‌های بلادرنگ پشتیبانی می‌کند، بیشتر بدانید.
  • درک کنید که عملکرد بلادرنگ در SDK چگونه کار می‌کند.
  • یاد بگیرید که چگونه از به‌روزرسانی‌های بلادرنگ برای به‌روز نگه داشتن پیکربندی برنامه خود استفاده کنید.

ارتباط کلاینت-سرور به صورت بلادرنگ

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

اگر سرور نسخه جدیدتری داشته باشد، فوراً سیگنال عدم اعتبارسنجی را ارسال می‌کند. اگر نسخه جدیدتری نداشته باشد، اتصال را باز نگه می‌دارد و منتظر می‌ماند تا نسخه‌ای روی سرور منتشر شود. هنگامی که SDK کلاینت سیگنال عدم اعتبارسنجی را دریافت می‌کند، به طور خودکار آن را دریافت می‌کند، سپس callback شنونده را که هنگام باز کردن اتصال شنونده ثبت شده است، فراخوانی می‌کند. این فراخوانی مشابه فراخوانی واکشی است که می‌توانید با SDK انجام دهید، اما هرگونه تنظیم ذخیره‌سازی یا minimumFetchInterval را نادیده می‌گیرد. اتصال کلاینت-سرور در حالی که برنامه در پیش‌زمینه است، حفظ می‌شود.

گردش کار کلاینت-سرور پیکربندی از راه دور به صورت بلادرنگ
گردش کار کلاینت-سرور Remote Config بلادرنگ

از آنجایی که اتصال کلاینت-سرور از طریق HTTP برقرار می‌شود، نیازی به وابستگی به کتابخانه‌های دیگر ندارد.

برای به‌روزرسانی‌ها گوش دهید

به‌روزرسانی‌های بلادرنگ، فراخوانی‌های Remote Config fetch تکمیل می‌کنند. توصیه می‌کنیم fetch را هنگام شروع برنامه (یا زمانی در طول چرخه حیات برنامه) فراخوانی کنید و در طول جلسه کاربر، منتظر به‌روزرسانی‌های Real-Time Remote Config باشید تا مطمئن شوید که به محض انتشار آخرین مقادیر در سرور، آن‌ها را در اختیار دارید.

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

فراخوانی برگشتی اغلب جای خوبی برای استفاده activate است تا پارامترهای پیکربندی به‌روزرسانی‌شده در دسترس برنامه شما قرار گیرند. برای استراتژی‌های بیشتر برای فعال کردن مقادیر پارامتر هنگام استفاده از Remote Config به Firebase Remote Config Loading Strategies مراجعه کنید.

مقادیر پارامتر را به صورت انتخابی فعال کنید

وقتی addOnConfigUpdateListener فراخوانی می‌کنید، می‌توانید منتظر تغییر بمانید و آن را فعال کنید.

تابع فراخوانی onUpdate زمانی فراخوانی می‌شود که هم نسخه جدیدی از قالب به طور خودکار دریافت شده باشد و هم تغییراتی در مقادیر پارامترهای فعال در برنامه در آن نسخه جدید ایجاد شده باشد.

این callbackها با پارامتر configUpdate فراخوانی می‌شوند. configUpdate شامل updatedKeys است که مجموعه‌ای از کلیدهای پارامتر تغییر یافته است که به‌روزرسانی بلادرنگ را آغاز کرده‌اند و شامل موارد زیر است:

  • کلیدهای پارامتری که اضافه یا حذف شده‌اند
  • کلیدهای پارامتری که مقادیرشان تغییر کرده است
  • کلیدهای پارامتری که فراداده‌های آنها تغییر کرده است (برای مثال، اطلاعات شخصی‌سازی Remote Config )
  • کلیدهای پارامتری که منبع مقدار آنها تغییر کرده است (برای مثال، یک مقدار پیش‌فرض درون برنامه‌ای که به یک مقدار سمت سرور به‌روزرسانی می‌شود)

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

گاهی اوقات، یک واکشی (چه هنگام فراخوانی متد fetch یا توسط Remote Config در لحظه آغاز شود) منجر به به‌روزرسانی برای کلاینت نمی‌شود. در این موارد، متد onUpdate یا completion فراخوانی نخواهند شد.

اضافه کردن و حذف کردن شنونده‌ها

addOnConfigUpdateListener نقطه ورودی اصلی برای Remote Config لحظه است. فراخوانی این listener برای اولین بار در چرخه حیات برنامه شما، اتصال به backend را باز می‌کند. فراخوانی‌های بعدی از همان اتصال استفاده مجدد می‌کنند و پیام نامعتبرسازی شرح داده شده در اتصال کلاینت-سرور در لحظه را مالتی‌پلکس می‌کنند.

این فراخوانی یک "ثبت شنونده" (listener registration) را برمی‌گرداند که متدی به نام remove دارد. برای توقف گوش دادن، ارجاع به ثبت شنونده را ذخیره کنید. برای توقف گوش دادن در این ثبت، remove فراخوانی کنید. اگر این تنها شنونده ثبت شده باشد، فراخوانی remove اتصال بلادرنگ به سرور را قطع می‌کند.

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

مراحل بعدی

برای پیکربندی Remote Config و شروع دریافت به‌روزرسانی‌ها به صورت بلادرنگ، به بخش «شروع به کار با Firebase Remote Config مراجعه کنید.