Google is committed to advancing racial equity for Black communities. See how.
Ta strona została przetłumaczona przez Cloud Translation API.
Switch to English

Zacznij korzystać z Firebase Remote Config na iOS

Możesz użyć Firebase Remote Config, aby zdefiniować parametry w swojej aplikacji i zaktualizować ich wartości w chmurze, umożliwiając modyfikowanie wyglądu i zachowania aplikacji bez dystrybuowania aktualizacji aplikacji.

Ten przewodnik przeprowadzi Cię przez wszystkie kroki, aby rozpocząć, i zawiera przykładowy kod, który można sklonować lub pobrać z repozytorium GitHub Firebase / quickstart-ios .

Dodaj zdalną konfigurację do swojej aplikacji

  1. Zainstaluj pakiet SDK Firebase na iOS.

  2. Utwórz pojedynczy obiekt Remote Config, jak pokazano w poniższym przykładzie:

    Szybki

    remoteConfig = RemoteConfig.remoteConfig()
    let settings = RemoteConfigSettings()
    settings.minimumFetchInterval = 0
    remoteConfig.configSettings = settings

    Cel C

    self.remoteConfig = [FIRRemoteConfig remoteConfig];
    FIRRemoteConfigSettings *remoteConfigSettings = [[FIRRemoteConfigSettings alloc] init];
    remoteConfigSettings.minimumFetchInterval = 0;
    self.remoteConfig.configSettings = remoteConfigSettings;

Ten obiekt służy do przechowywania domyślnych wartości parametrów w aplikacji, pobierania zaktualizowanych wartości parametrów z zaplecza Zdalnej konfiguracji i kontrolowania, kiedy pobrane wartości są udostępniane aplikacji.

Podczas programowania zaleca się ustawienie stosunkowo niskiego minimalnego interwału pobierania. Aby uzyskać więcej informacji, zobacz Ograniczanie .

Ustaw domyślne wartości parametrów w aplikacji

W obiekcie Remote Config można ustawić domyślne wartości parametrów w aplikacji, aby aplikacja zachowywała się zgodnie z przeznaczeniem przed nawiązaniem połączenia z zapleczem Remote Config i aby wartości domyślne były dostępne, jeśli żadna z nich nie została ustawiona w zapleczu.

  1. Zdefiniuj zestaw nazw parametrów i domyślne wartości parametrów przy użyciu obiektu NSDictionary lub pliku plist .
  2. Dodaj te wartości do obiektu Remote Config przy użyciu setDefaults:. Poniższy przykład ustawia domyślne wartości w aplikacji z pliku plist :

Szybki

remoteConfig.setDefaults(fromPlist: "RemoteConfigDefaults")

Cel C

[self.remoteConfig setDefaultsFromPlistFileName:@"RemoteConfigDefaults"];

Uzyskaj wartości parametrów do użycia w swojej aplikacji

Teraz możesz pobrać wartości parametrów z obiektu Remote Config. Jeśli później ustawisz wartości w zapleczu Zdalnej konfiguracji, pobierzesz je, a następnie aktywujesz, te wartości będą dostępne dla Twojej aplikacji. W przeciwnym razie otrzymasz wartości parametrów w aplikacji skonfigurowane przy użyciu setDefaults:. Aby uzyskać te wartości, wywołaj metodę configValueForKey:, podając klucz parametru jako argument.

Ustaw wartości parametrów

Korzystając z konsoli Firebase lub interfejsów API zaplecza Remote Config , możesz tworzyć nowe domyślne wartości zaplecza, które zastępują wartości w aplikacji zgodnie z wymaganą logiką warunkową lub kierowaniem na użytkowników. Ta sekcja przeprowadzi Cię przez proces tworzenia tych wartości w konsoli Firebase.

  1. W konsoli Firebase otwórz projekt.
  2. Wybierz Remote Config z menu, aby wyświetlić panel kontrolny Remote Config.
  3. Zdefiniuj parametry o takich samych nazwach, jak parametry zdefiniowane w aplikacji. Dla każdego parametru możesz ustawić wartość domyślną (która ostatecznie zastąpi wartość domyślną w aplikacji), a także możesz ustawić wartości warunkowe. Aby dowiedzieć się więcej, zobacz Parametry i warunki zdalnej konfiguracji .

Pobierz i aktywuj wartości

Aby pobrać wartości parametrów ze zdalnej konfiguracji , wywołaj metodę fetchWithCompletionHandler: lub fetchWithExpirationDuration: completeHandler:. Wszelkie wartości ustawione w zapleczu są pobierane i zapisywane w pamięci podręcznej w obiekcie Remote Config.

W przypadkach, w których chcesz pobrać i aktywować wartości w jednym wywołaniu, użyj funkcji fetchAndActivateWithCompletionHandler:

Ten przykład pobiera wartości z zaplecza Remote Config (nie są to wartości z pamięci podręcznej) i wywołuje activateWithCompletionHandler: celu udostępnienia ich aplikacji:

Szybki

remoteConfig.fetch() { (status, error) -> Void in
  if status == .success {
    print("Config fetched!")
    self.remoteConfig.activate() { (changed, error) in
      // ...
    }
  } else {
    print("Config not fetched")
    print("Error: \(error?.localizedDescription ?? "No error available.")")
  }
  self.displayWelcome()
}

Cel C

[self.remoteConfig fetchWithCompletionHandler:^(FIRRemoteConfigFetchStatus status, NSError *error) {
    if (status == FIRRemoteConfigFetchStatusSuccess) {
        NSLog(@"Config fetched!");
      [self.remoteConfig activateWithCompletion:^(BOOL changed, NSError * _Nullable error) {
        // ...
      }];
    } else {
        NSLog(@"Config not fetched");
        NSLog(@"Error %@", error.localizedDescription);
    }
    [self displayWelcome];
}];

Ponieważ te zaktualizowane wartości parametrów wpływają na zachowanie i wygląd aplikacji, należy aktywować pobrane wartości w momencie, który zapewni użytkownikowi płynne działanie, na przykład przy następnym otwarciu aplikacji przez użytkownika. Aby uzyskać więcej informacji i przykładów, zobacz Strategie ładowania Remote Config .

Dławienie

Jeśli aplikacja pobiera się zbyt wiele razy w krótkim czasie, wywołania pobierania są ograniczane, a FIRRemoteConfigFetchStatusThrottled SDK zwraca FIRRemoteConfigFetchStatusThrottled . Przed wersją SDK 6.3.0 limit wynosił 5 żądań pobierania w 60-minutowym oknie (nowsze wersje mają bardziej liberalne limity).

Podczas tworzenia aplikacji możesz chcieć bardzo często odświeżać pamięć podręczną (wiele razy na godzinę), aby umożliwić szybkie iteracje podczas opracowywania i testowania aplikacji. Aby dostosować się do szybkiej iteracji w projekcie z wieloma programistami, możesz tymczasowo dodać właściwość FIRRemoteConfigSettings z niskim minimalnym interwałem pobierania ( MinimumFetchInterval ) w swojej aplikacji.

Domyślny i zalecany interwał pobierania danych produkcyjnych dla Zdalnej konfiguracji to 12 godzin, co oznacza, że ​​konfiguracje nie będą pobierane z zaplecza więcej niż raz w ciągu 12 godzin, niezależnie od liczby faktycznie wykonywanych wywołań pobierania. W szczególności minimalny interwał pobierania jest określany w następującej kolejności:

  1. Parametr w fetch(long)
  2. Parametr w FIRRemoteConfigSettings.MinimumFetchInterval
  3. Wartość domyślna 12 godzin

Następne kroki

Jeśli jeszcze tego nie zrobiłeś, zapoznaj się z przypadkami użycia Remote Config i zapoznaj się z niektórymi kluczowymi pojęciami i dokumentacją dotyczącą zaawansowanych strategii, w tym: