Korzystając z wyzwalania funkcji zdalnej konfiguracji w tle zapewnianej przez Cloud Functions dla Firebase wraz z FCM , możesz propagować aktualizacje zdalnej konfiguracji w czasie rzeczywistym. W tym scenariuszu tworzysz funkcję, która jest wyzwalana podczas publikowania lub wycofywania szablonu zdalnej konfiguracji z pulpitu nawigacyjnego lub interfejsu API. Aktualizacja szablonu uruchamia funkcję wysyłania wiadomości FCM, aby poinformować klientów, że ich obecna konfiguracja jest nieaktualna i że ich następne pobranie powinno nastąpić z serwera:
Pozostała część tego dokumentu przeprowadzi Cię przez te kroki, aby propagować aktualizacje Zdalnej konfiguracji w czasie rzeczywistym.
Subskrybuj wystąpienia aplikacji klienckiej do tematu FCM
W przypadku kierowania komunikatu FCM do dużej grupy wystąpień aplikacji klienckiej, takiej jak cała baza użytkowników, komunikaty tematyczne są najbardziej wydajnym mechanizmem. Każda instancja aplikacji, która powinna otrzymywać aktualizacje zdalnej konfiguracji w czasie rzeczywistym, musi subskrybować nazwę tematu, na przykład PUSH_RC
:
Szybki
extension AppDelegate : MessagingDelegate { func messaging(_ messaging: Messaging, didReceiveRegistrationToken fcmToken: String) { messaging.subscribe(toTopic: "PUSH_RC") { error in print("Subscribed to PUSH_RC topic") } } }
Cel C
- (void)messaging:(FIRMessaging *)messaging didReceiveRegistrationToken:(NSString *)fcmToken { [[FIRMessaging messaging] subscribeToTopic:@"PUSH_RC" completion:^(NSError * _Nullable error) { NSLog(@"Subscribed to PUSH_RC topic"); }]; }
Android
@Override public void onNewToken(String s) { FirebaseMessaging.getInstance().subscribeToTopic("PUSH_RC"); }
Utwórz funkcję wysyłania pingu FCM w przypadku aktualizacji szablonu
Możesz uruchomić funkcję w odpowiedzi na zdarzenia zdalnej konfiguracji, w tym publikację nowej wersji konfiguracji lub przywrócenie starszej wersji. Aby propagować aktualizacje szablonów w czasie rzeczywistym, utwórz funkcję nasłuchującą zdarzeń publikacji szablonów, a następnie użyj pakietu FCM Admin SDK ze swojej funkcji, aby wysłać ciche polecenie ping do instancji aplikacji klienckiej:
exports.pushConfig = functions.remoteConfig.onUpdate(versionMetadata => { // Create FCM payload to send data message to PUSH_RC topic. const payload = { topic: "PUSH_RC", data: { "CONFIG_STATE": "STALE" } }; // Use the Admin SDK to send the ping via FCM. return admin.messaging().send(payload).then(resp => { console.log(resp); return null; }); });
Ta funkcja ustawia parametr CONFIG_STATE
, a następnie wysyła go jako ładunek danych komunikatu FCM do wszystkich klientów subskrybujących temat PUSH_RC
.
Ustaw stan Zdalnej konfiguracji na kliencie
Ładunek danych pokazany w poprzednim kroku zawsze ustawia CONFIG_STATE
na STALE
w udostępnionych preferencjach aplikacji. Oznacza to, że szablon zdalnej konfiguracji przechowywany już w aplikacji jest teraz nieaktualny z powodu utworzenia nowego, zaktualizowanego szablonu, którego publikacja wyzwoliła funkcję. Zaktualizuj swój program obsługi powiadomień, aby przetestować ten warunek:
Szybki
func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable: Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) { if (userInfo.index(forKey: "CONFIG_STATE") != nil) { print("Config set to stale") UserDefaults.standard.set(true, forKey:"CONFIG_STALE") } completionHandler(UIBackgroundFetchResult.newData) }
Cel C
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler { if (userInfo[@"CONFIG_STATE"]) { NSLog(@"Config set to stale"); [[NSUserDefaults standardUserDefaults] setBool:YES forKey:@"CONFIG_STALE"]; } completionHandler(UIBackgroundFetchResultNewData); }
Android
@Override public void onMessageReceived(RemoteMessage remoteMessage) { if (remoteMessage.getData().containsKey("CONFIG_STATE")) { SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this); sharedPreferences.edit().putBoolean("CONFIG_STALE", true).apply(); } }
Pobierz aktualizacje Zdalnej konfiguracji podczas uruchamiania aplikacji
Szybki
func fetchConfig() { welcomeLabel.text = remoteConfig[loadingPhraseConfigKey].stringValue var expirationDuration = 3600 // If your app is using developer mode, expirationDuration is set to 0, so each fetch will // retrieve values from the service. if remoteConfig.configSettings.isDeveloperModeEnabled || UserDefaults.standard.bool(forKey: "CONFIG_STALE") { expirationDuration = 0 } remoteConfig.fetch(withExpirationDuration: TimeInterval(expirationDuration)) { (status, error) -> Void in if status == .success { print("Config fetched!") self.remoteConfig.activateFetched() } else { print("Config not fetched") print("Error: \(error?.localizedDescription ?? "No error available.")") } self.displayWelcome() } }
Cel C
- (void)fetchConfig { self.welcomeLabel.text = self.remoteConfig[kLoadingPhraseConfigKey].stringValue; long expirationDuration = 3600; // If your app is using developer mode, expirationDuration is set to 0, so each fetch will // retrieve values from the Remote Config service. if (self.remoteConfig.configSettings.isDeveloperModeEnabled || [[NSUserDefaults standardUserDefaults] boolForKey:@"CONFIG_STALE"]) { expirationDuration = 0; } [self.remoteConfig fetchWithExpirationDuration:expirationDuration completionHandler:^(FIRRemoteConfigFetchStatus status, NSError *error) { if (status == FIRRemoteConfigFetchStatusSuccess) { NSLog(@"Config fetched!"); [self.remoteConfig activateFetched]; [[NSUserDefaults standardUserDefaults] setBool:NO forKey:@"CONFIG_STALE"]; } else { NSLog(@"Config not fetched"); NSLog(@"Error %@", error.localizedDescription); } [self displayWelcome]; }]; }
Android
private void fetchWelcomeMessage() { mWelcomeTextView.setText(mFirebaseRemoteConfig.getString("loading_phrase")); long cacheExpiration = 43200; // 12 hours in seconds. // If your app is using developer mode or cache is stale, cacheExpiration is set to 0, // so each fetch will retrieve values from the service. if (mFirebaseRemoteConfig.getInfo().getConfigSettings().isDeveloperModeEnabled() || mSharedPreferences.getBoolean("CONFIG_STALE", false)) { cacheExpiration = 0; } mFirebaseRemoteConfig.fetch(cacheExpiration) .addOnCompleteListener(this, new OnCompleteListener<Void>() { @Override public void onComplete(@NonNull Task<Void> task) { if (task.isSuccessful()) { Toast.makeText(MainActivity.this, "Fetch Succeeded", Toast.LENGTH_SHORT).show(); // After config data is successfully fetched, it must be activated before newly fetched // values are returned. mFirebaseRemoteConfig.activateFetched(); } else { Toast.makeText(MainActivity.this, "Fetch Failed", Toast.LENGTH_SHORT).show(); } mWelcomeTextView.setText(mFirebaseRemoteConfig.getString("welcome_message")); } }); }
Na koniec dodaj logikę do swojej aplikacji, aby wymusić pobieranie zdalnej konfiguracji z sieci (ignorując pamięć lokalną), ponieważ CONFIG_STATE
to STALE
. Jeśli Twoja aplikacja pobiera się z sieci zbyt często, Firebase może ją ograniczać. Zobacz Ograniczanie .