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
Aşağıdaki şartları karşılıyorsanız Flutter için Firebase SDK'larını yükleyip başlatın bunu yapmıyoruz.
Remote Config için, uygulama örneklerinin koşullu hedeflemesi kullanıcı özelliklerine ve kitlelere girebilir. Şunlardan emin olun: projenizde Google Analytics'i etkinleştirmelisiniz.
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
Projenizi yeniden derleyin:
flutter run
macOS'te Remote Config kullanıyorsanız Anahtar Zinciri Paylaşımı kullanabilirsiniz.
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.
- Firebase konsolunda projenizi açın.
- Remote Config'i görüntülemek için menüden Remote Config'i seçin kontrol paneli
- Ş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
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.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.
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. });
Remote Config'inizin yeni bir sürümünü yayınladığınızda 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 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: