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

انتخاب پلتفرم: 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 باشید تا مطمئن شوید که به محض انتشار آخرین مقادیر در سرور، آن‌ها را در اختیار دارید.

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

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

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

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

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

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

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

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

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

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

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

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

مراحل بعدی

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