Firebase Remote Config'i kullanmaya başlayın


Firebase Remote Config'i kullanarak uygulamanızdaki parametreleri tanımlayabilir ve değerlerini buluttaki gibi göstererek, görünümünü ve davranışını değiştirebilirsiniz. uygulamanızı yüklemenizi sağlar. Bu kılavuz, başlangıç adımlarında size yol gösterir ve örnek koddur.

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

  1. Aşağıdaki şartları karşılıyorsanız Flutter için Firebase SDK'larını yükleyip başlatın bunu yapmıyoruz.

  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. Flutter projenizin kök dizininden aşağıdaki kodu çalıştırın: Remote Config eklentisini yüklemek için 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 derleyin:

    flutter run
    
  5. macOS'te Remote Config kullanıyorsanız Anahtar Zinciri Paylaşımı kullanabilirsiniz.

ziyaret edin.

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

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

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

Singleton nesnesi, uygulama içi varsayılan parametre değerlerini depolamak, getirmek ve arka uçtan güncel parametre değerlerini kontrol edebilir ve kullanılabilir hale gelir.

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

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

Uygulama içi varsayılan parametre değerlerini Remote Config'de ayarlayabilirsiniz ile bağlantı kurmadan önce amaçlandığı gibi davranmasını sağlamak için Remote Config arka ucu; arka uçta ayarlanır.

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 kullanılacak 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 veri türüyle eşleşen yöntemi çağırın parametre anahtarını bağımsız değişken olarak sağlar:

  • 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. Şu parametrede tanımladığınız parametrelerle aynı adlara sahip parametreleri tanımlayın: en iyi şekilde yararlanabilirsiniz. Her parametre için bir varsayılan değer ( karşılık gelen uygulama içi varsayılan değeri geçersiz kılabilir) koşullu değerler oluşturabilirsiniz. Daha fazla bilgi edinmek için Remote Config Parametreleri ve Koşullar.

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 saklanı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

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

  1. Uygulamanızda güncellemeleri dinlemeye başlamak için onConfigUpdated yeni parametre değerlerini otomatik olarak getirir.

     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 yeni yapılandırmayı etkinleştirir.

ziyaret edin.

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 ve yapılandırmaların 12 saat içinde arka uçtan bir kereden fazla alınmadığı anlamına gelir sayısını belirler.

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 Config hakkında bilgi edinin. kullanım alanlarına göz atın ve Aşağıdakileri içeren temel kavramlar ve gelişmiş stratejilerle ilgili belgeler: