Firebase Remote Config'i kullanmaya başlayın


Uygulamanızda parametreler tanımlamak ve bulutta değerlerini güncellemek için Firebase Remote Config'i kullanabilirsiniz. Böylece, uygulama güncellemesi dağıtmadan uygulamanızın görünümünü ve davranışını değiştirebilirsiniz. Bu kılavuz, başlangıç adımlarında size yol gösterir ve örnek koddur.

1. adım: Firebase ve Remote Config SDK'sını uygulamanıza ekleyin

  1. Henüz yapmadıysanız Flutter için Firebase SDK'larını yükleyip başlatın.

  2. Remote Config için, uygulama örneklerinin koşullu hedeflemesi kullanıcı özelliklerine ve kitlelere girebilir. Şunlardan emin olun: projenizde Google Analytics'i etkinleştirmelisiniz.

  3. Remote Config eklentisini yüklemek için Flutter projenizin kök dizininden aşağıdaki komutu çalıştırın:

    flutter pub add firebase_remote_config

    Ayrıca, Remote Config kurulumunun bir parçası olarak Firebase SDK'sını eklemeniz gerekir. uygulamanız için aşağıdaki adımları uygulayın:

    flutter pub add firebase_analytics

  4. Projenizi yeniden oluşturun:

    flutter run

  5. macOS'te Remote Config kullanıyorsanız Xcode'da Anahtar Zinciri Paylaşımı'nı etkinleştirin.

2. Adım: Remote Config singleton nesnesini alın

Remote Config nesne örneği alma ve minimum getirme aralığı (sık yenilemeler için):

final remoteConfig = FirebaseRemoteConfig.instance;
await remoteConfig.setConfigSettings(RemoteConfigSettings(
    fetchTimeout: const Duration(minutes: 1),
    minimumFetchInterval: const Duration(hours: 1),
));

Tekil nesne, uygulama içi varsayılan parametre değerlerini depolamak, arka uçtan güncellenmiş parametre değerlerini almak ve alınan 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 değeri ayarlamanız önerilir. seçebilirsiniz. Daha fazla bilgi için Düşük hızlandırma bölümüne bakın.

3. Adım: Uygulama içi varsayılan parametre değerlerini ayarlayın

Remote Config nesnesinde uygulama içi varsayılan parametre değerleri ayarlayarak uygulamanızın Remote Config arka ucuna bağlanmadan önce istenen şekilde davranmasını sağlayabilir ve arka uçta ayarlanmamışsa varsayılan değerlerin kullanılmasını sağlayabilirsiniz.

await remoteConfig.setDefaults(const {
    "example_param_1": 42,
    "example_param_2": 3.14159,
    "example_param_3": true,
    "example_param_4": "Hello, world!",
});

4. adım: Uygulamanızda kullanacağınız parametre değerlerini alın

Artık Remote Config nesnesinden parametre değerleri alabilirsiniz. Mevcut arka uçtaki değerleri kullanıp bunları getirmeli ve daha sonra uygulamanızda kullanılabiliyor. Aksi takdirde uygulama içi parametre değerleri setDefaults() kullanılarak yapılandırılır.

Bu değerleri almak için aşağıda listelenen ve uygulamanızın beklediği veri türüyle eşleşen yöntemi çağırın. Parametre anahtarını bağımsız değişken olarak sağlayın:

  • getBool()
  • getDouble()
  • getInt()
  • getString()

5. adım: Remote Config arka ucunda parametre değerlerini ayarlayın

Firebase konsolunu veya Remote Config arka uç API'leri uygulama içi değerleri geçersiz kılan yeni sunucu tarafı varsayılan değerleri oluşturabilirsiniz istediğiniz koşullu mantığa veya kullanıcı hedeflemesine göre. Bu bölüm , bu değerleri oluşturmak için Firebase konsolunda uygulanacak adımları açıklar.

  1. Firebase konsolunda projenizi açın.
  2. Remote Config'i görüntülemek için menüden Remote Config'i seçin kontrol paneli
  3. Uygulamanızda tanımladığınız parametrelerle aynı ada sahip parametreler tanımlayın. Her parametre için bir varsayılan değer (sonuçta ilgili uygulama içi varsayılan değeri geçersiz kılar) ve koşullu değerler de ayarlayabilirsiniz. Daha fazla bilgi için Remote Config Parametreleri ve Koşulları başlıklı makaleyi inceleyin.

6. Adım: Değerleri getirin ve etkinleştirin

  1. Remote Config arka ucundan parametre değerlerini almak için fetch() yöntemini çağırın. Arka uçta ayarladığınız tüm değerler getirilir ve Remote Config nesnesinde depolanır.

  2. Getirilen parametre değerlerini uygulamanızda kullanılabilir hale getirmek için activate() yöntemini çağırın.

    Değerleri tek bir çağrıda getirip etkinleştirmek istediğiniz durumlarda fetchAndActivate() Remote Config arka ucu ve bunları uygulamanın kullanımına sunun:

    await remoteConfig.fetchAndActivate();

Bu güncellenen parametre değerleri davranışı ve görünümü etkilediği için getirmeyi seçerseniz, getirilen değerleri uygulamanın sağlandığından sorunsuz bir deneyim sunmasını sağlar (örneğin, kullanıcı uygulamasını indirin. Remote Config yükleme stratejilerine bakın daha fazla bilgi ve örnek bulabilirsiniz.

7. adım: Güncellemeleri gerçek zamanlı olarak dinleyin

Parametre değerlerini getirdikten sonra, gerçek zamanlı Remote Config'i kullanarak Remote Config arka ucundan gelen güncellemelere göz atın. Gerçek zamanlı Remote Config sinyalleri otomatik olarak getirir ve verileri otomatik olarak getirir. yeni bir Remote Config sürümü yayınlamanızın ardından

Gerçek zamanlı Remote Config'in Web'de kullanılamadığını unutmayın.

  1. Uygulamanızda güncellemeleri dinlemeye başlamak ve yeni parametre değerlerini otomatik olarak almak için onConfigUpdated değerini kullanın.

     remoteConfig.onConfigUpdated.listen((event) async {
   await remoteConfig.activate();

   // Use the new config values here.
 });

  2. Remote Config'inizin yeni bir sürümünü yayınladığınızda, uygulamanızı çalıştıran ve değişiklikleri dinleyen cihazlar yeni yapılandırmayı etkinleştirir.

Kısıtlama

Bir uygulama kısa bir süre içinde çok fazla veri getirirse getirme aramaları kısıtlandı ve FirebaseRemoteConfig öğesinin lastFetchStatus değeri özellik RemoteConfigFetchStatus.throttle olacak.

Remote Config için varsayılan minimum getirme aralığı 12 saattir. Bu, aslında kaç getirme çağrısı yapıldığından bağımsız olarak yapılandırmaların 12 saatlik bir zaman aralığında arka uçtan bir defadan fazla getirilmeyeceği anlamına gelir.

Uygulama geliştirme sırasında, gerçek zamanlı Remote Config kullanmıyorsanız kullanmanızı öneririz. Yapılandırmaları sıklıkla getirmek ve etkinleştirmek isteyebilirsiniz. (saatte birçok kez) bu özellik, geliştirme ve test etme sürecinde hızla yineleme uygulamasını indirin. 10’a kadar geliştiricinin bulunduğu bir projede hızlı iterasyon yapabilmek için setConfigSettings() ile geçici olarak düşük bir minimum getirme aralığı ayarlayabilir.

final remoteConfig = FirebaseRemoteConfig.instance;
await remoteConfig.setConfigSettings(RemoteConfigSettings(
    fetchTimeout: const Duration(minutes: 1),
    minimumFetchInterval: const Duration(minutes: 5),
));

Sonraki adımlar

Henüz yapmadıysanız Remote Configkullanım alanlarını inceleyin ve aşağıdakiler gibi temel kavramlar ve gelişmiş strateji dokümanlarından bazılarına göz atın: