Save the date - Google I/O returns May 18-20. Register to get the most out of the digital experience: Build your schedule, reserve space, participate in Q&As, earn Google Developer profile badges, and more. Register now
Bu sayfa, Cloud Translation API ile çevrilmiştir.
Switch to English

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 klonlanıp indirilebilen 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ıza ne zaman 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: 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 setDefaults: 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ı hedeflemeye 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 (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

Parametre değerlerini Remote fetchWithCompletionHandler: için fetchWithCompletionHandler: veya fetchWithExpirationDuration:completionHandler: yöntemini fetchWithExpirationDuration:completionHandler: . 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 bulunduğ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, yani yapılandırmalar, gerçekte kaç getirme çağrısı yapıldığına bakılmaksızın, arka uçtan 12 saatlik bir pencerede birden fazla kez alınmayacaktır. Özellikle, minimum getirme aralığı aşağıdaki 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 bir göz atın: