Google is committed to advancing racial equity for Black communities. See how.
Bu sayfa, Cloud Translation API ile çevrilmiştir.
Switch to English

İOS'ta Firebase Remote Config'i kullanmaya başlayın

Uygulamanızda parametreleri tanımlamak ve buluttaki değerlerini güncellemek için Firebase Remote Config'i kullanarak, bir uygulama güncellemesi dağıtmadan uygulamanızın görünümünü ve davranışını değiştirmenize olanak tanır.

Bu kılavuz, başlangıç ​​adımlarında size yol gösterir ve tümü firebase / quickstart-ios GitHub deposundan klonlamak veya indirmek için mevcut olan bazı örnek kodlar sağlar.

Uygulamanıza Remote Config ekleyin

  1. İOS için Firebase SDK'sını yükleyin .

  2. Aşağıdaki örnekte gösterildiği gibi, tekli Remote Config nesnesini oluşturun:

    Swift

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

    Amaç-C

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

Bu nesne, uygulama içi varsayılan parametre değerlerini depolamak, Remote Config arka ucundan güncellenmiş parametre değerlerini almak ve getirilen değerlerin uygulamanızda ne zaman kullanıma sunulacağını kontrol etmek için kullanılır.

Geliştirme sırasında, nispeten düşük bir minimum getirme aralığı ayarlamanız önerilir. Daha fazla bilgi için Kısma bölümüne bakın.

Uygulama içi varsayılan parametre değerlerini ayarlayın

Remote Config nesnesinde uygulama içi varsayılan parametre değerlerini ayarlayabilirsiniz, böylece uygulamanız Remote Config arka uca bağlanmadan önce amaçlandığı gibi davranır ve böylece arka uçta hiçbiri ayarlanmadıysa varsayılan değerler kullanılabilir.

  1. NSDictionary nesnesi veya plist dosyası kullanarak bir dizi parametre adı ve varsayılan parametre değerleri tanımlayın.
  2. SetDefaults: öğesini kullanarak bu değerleri Remote Config nesnesine ekleyin. Aşağıdaki örnek, bir plist dosyasından uygulama içi varsayılan değerleri ayarlar:

Swift

remoteConfig.setDefaults(fromPlist: "RemoteConfigDefaults")

Amaç-C

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

Uygulamanızda kullanmak için parametre değerlerini alın

Artık Remote Config nesnesinden parametre değerleri alabilirsiniz. Daha sonra Remote Config arka ucunda değerler ayarlarsanız, bunları alın ve ardından etkinleştirirseniz, bu değerler uygulamanızda kullanılabilir. Aksi takdirde, setDefaults kullanılarak yapılandırılan uygulama içi parametre değerlerini alırsınız :. Bu değerleri almak için, parametre anahtarını bir bağımsız değişken olarak sağlayarak configValueForKey: yöntemini çağırın.

Parametre değerlerini ayarlayın

Firebase konsolunu veya Remote Config arka uç API'larını kullanarak, istediğiniz koşullu mantığa veya kullanıcı hedeflemesine göre uygulama içi değerleri geçersiz kılan yeni arka uç varsayılan değerleri oluşturabilirsiniz. Bu bölüm, bu değerleri oluşturmak için Firebase konsolu adımlarında size yol gösterir.

  1. Firebase konsolunda projenizi açın.
  2. Remote Config panosunu görüntülemek için menüden Remote Config'i seçin.
  3. Uygulamanızda tanımladığınız parametrelerle aynı adlara sahip parametreleri tanımlayın. Her parametre için varsayılan bir değer belirleyebilir (bu değer sonunda uygulama içi varsayılan değeri geçersiz kılar) ve ayrıca koşullu değerler de ayarlayabilirsiniz. Daha fazla bilgi edinmek için bkz. Uzaktan Yapılandırma Parametreleri ve Koşulları .

Değerleri getir ve etkinleştir

Remote Config'den parametre değerlerini almak için fetchWithCompletionHandler: veya fetchWithExpirationDuration: completeHandler: yöntemini çağırın . Arka uçta ayarladığınız tüm değerler, Remote Config nesnesinde alınır ve önbelleğe alınır.

Değerleri tek bir çağrıda getirmek ve etkinleştirmek istediğiniz durumlar için fetchAndActivateWithCompletionHandler: kullanın.

Bu örnek, Remote Config arka ucundan değerleri alır (önbelleğe alınmış değerler değil) ve activateWithCompletionHandler: çağrılarını uygulamada kullanılabilir hale getirmek için:

Swift

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()
}

Amaç-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];
}];

Bu güncellenen parametre değerleri uygulamanızın davranışını ve görünümünü etkilediğinden, getirilen değerleri, örneğin kullanıcının uygulamanızı bir sonraki açışında olduğu gibi, kullanıcınız için sorunsuz bir deneyim sağlayan bir zamanda etkinleştirmelisiniz. Daha fazla bilgi ve örnekler için Remote Config yükleme stratejilerine bakın.

Kısma

Bir uygulama kısa bir süre içinde çok fazla kez FIRRemoteConfigFetchStatusThrottled , getirme çağrıları FIRRemoteConfigFetchStatusThrottled ve SDK, FIRRemoteConfigFetchStatusThrottled döndürür. SDK 6.3.0 sürümünden önce, sınır 60 dakikalık bir pencerede 5 getirme isteğiydi (daha yeni sürümler daha fazla izin verme sınırına sahiptir).

Uygulama geliştirme sırasında, uygulamanızı geliştirip test ederken hızlı bir şekilde yineleme yapmanıza izin vermek için önbelleği çok sık (saatte birçok kez) yenilemek isteyebilirsiniz. Çok sayıda geliştiricinin olduğu bir projede hızlı yinelemeyi sağlamak için, uygulamanıza geçici olarak düşük minimum getirme aralığına ( MinimumFetchInterval ) sahip bir FIRRemoteConfigSettings özelliği ekleyebilirsiniz.

Remote Config için varsayılan ve önerilen üretim getirme aralığı 12 saattir, bu da yapılandırmaların arka uçtan 12 saatlik bir pencerede, gerçekte kaç getirme çağrısı yapıldığına bakılmaksızın birden fazla kez getirilmeyeceği anlamına gelir. Spesifik olarak, minimum getirme aralığı şu sırayla belirlenir:

  1. fetch(long) parametre fetch(long)
  2. FIRRemoteConfigSettings.MinimumFetchInterval içindeki parametre
  3. 12 saatlik varsayılan değer

Sonraki adımlar

Henüz yapmadıysanız, Remote Config kullanım örneklerini keşfedin ve aşağıdakiler dahil bazı temel kavramlara ve gelişmiş strateji belgelerine göz atın: