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


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متد یا تکمیل فراخوانی نخواهد شد.

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

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

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

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

مراحل بعدی

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