Remote Config şablonları ve sürüm oluşturma

Remote Config şablonları, Firebase projeniz için oluşturulan JSON biçimli parametreler ve koşullar kümeleridir. Remote Config yapılandırmaları oluşturulabilen, güncellenebilen, sürümlendirilebilen ve geri alınabilen şablonlar halinde düzenler.

Mimarinize bağlı olarak müşteri şablonları, sunucu şablonları veya her ikisini de oluşturup yönetebilirsiniz:

  • İstemci şablonları: Apple, Android, Web, Flutter, Unity ve C++ platformlarındaki istemci uygulaması örneklerine yapılandırmalar sunun. İstemci şablonları, Google Analytics kitleler, uygulama sürümleri, platform, cihaz dili, ülke, kullanıcı yüzdelik dilimleri ve özel sinyallere dayalı koşulları destekler.

  • Sunucu şablonları: Node.js, Python, Go ve Java için Firebase Admin SDK kullanılarak Cloud Run, Cloud Functions for Firebase veya kapsayıcılı sunucular gibi arka uç ortamlarına yapılandırmalar sunun. Sunucu şablonları, sunucu özel sinyalleri ve rastgele yüzdelik kullanıma sunma işlemleriyle parametreleri sunucu tarafında neredeyse sıfır gecikmeyle değerlendirir.

İstemci ve sunucu şablonlarını karşılaştırma

İstemci ve sunucu şablonları, Firebase projenizde bağımsız olarak tutulur. İstemci ve sunucu şablonlarının nasıl farklılık gösterdiğini anlamak için aşağıdaki tabloyu kullanın:

Özellik Müşteri şablonları Sunucu şablonları
Hedef ortamlar İstemci uygulamaları (Apple, Android, Web, Flutter, Unity, C++) Sunucu ortamları (Cloud Run, Cloud Functions for Firebase, GKE, arka uç hizmetleri)
Desteklenen SDK'lar Firebase istemci SDK'ları Firebase Admin SDK (Node.js, Python, Go, Java)
Yönetim araçları Firebase konsolu, Firebase KSA, REST API, Firebase Admin SDK Firebase konsol
Konsol konumu Parametreler ve Koşullar Parametreler ve Koşullar
Şablon varsayılanlarını indirme Desteklenir (Android için XML, iOS için PLIST, web için JSON) Geçerli değil (sunucu kodunda veya arka uçta tanımlanan varsayılan değerler)
Ayrıntılı kılavuz Müşteri şablonlarını yönetme Sunucu şablonlarını yönetme

Şablon yaşam döngüsü ve sürüm oluşturma

İster istemci şablonlarıyla ister sunucu şablonlarıyla çalışın, Remote Config yerleşik sürüm kontrolü ve yaşam döngüsü yönetimi sağlar:

Sürüm oluşturma ve izleme

Parametreleri veya koşulları her güncellediğinizde Remote Config yeni bir sürüm oluşturur Remote Config ve önceki şablonu, gerektiğinde alabileceğiniz veya geri dönebileceğiniz bir sürüm olarak saklar. Sürüm numaraları, Remote Config tarafından depolanan ilk değerden başlayarak sırayla artırılır.

Tüm şablonlarda, söz konusu sürümle ilgili meta verileri içeren bir version alanı bulunur. Bu alan, aşağıdakileri içerir:

  • versionNumber: Şablonun sıralı sürüm numarası.
  • updateTime: Şablonun yayınlandığı zaman damgası.
  • updateUser: Güncellemeyi yapan kullanıcının e-posta adresi veya kimliği.
  • updateOrigin: Değişikliğin nasıl yapıldığı (örneğin, CONSOLE, REST_API veya ADMIN_SDK_NODE).
  • updateType: Değişikliğin niteliği (örneğin, INCREMENTAL_UPDATE veya FORCED_UPDATE).

Sürüm sınırları ve saklama

Şablon türü başına toplam 300 kullanıcı ömrü boyunca saklanan sürüm sınırı vardır (300 istemci şablonu ve 300 sunucu şablonu). Bu sayıya, silinen şablonların saklanan sürüm numaraları da dahildir. Bir projenin kullanım ömrü boyunca şablon türü başına 300'den fazla şablon sürümü yayınlarsanız en eski sürümler silinir ve bu türden en fazla 300 sürüm korunur.

Geri alma sayısı

Dilediğiniz zaman bir şablonun depolanan herhangi bir sürümüne geri dönebilirsiniz. Geri aldığınızda Remote Config, içeriği seçilen geçmiş sürümle eşleşen yeni bir sürüm oluşturur. Örneğin, 10. sürümden 6. sürüme geri dönüldüğünde 6. sürümdeki yapılandırmayla 11. sürüm oluşturulur.

İçe ve dışa aktarma

Etkin şablonunuzu JSON dosyası olarak indirebilir ve aynı projede veya başka bir projede yayınlayabilirsiniz. Bu özellik sayesinde:

  • Şablon tanımlarını kaynak kontrolünde (ör. Git) saklayın.
  • Yapılandırma dağıtımlarını CI/CD ardışık düzenlerine entegre edin.
  • Yapılandırmaları aşamalar arasında taşıyın (örneğin, geliştirme veya hazırlama projesinden üretime).
  • Yapılandırmaları projeler arasında taşıyabilirsiniz.

Özellikle bir A/B Testing denemesindeki varyantlar olarak oluşturulan parametreler ve parametre değerleri, dışa aktarılan şablonlara dahil edilmez.

Şablon varsayılanları

İstemci uygulamaları için, uygulamanızla birlikte paketlemek üzere XML, PLIST veya JSON biçiminde parametre varsayılan değerlerini içeren dosyaları indirebilirsiniz. Talimatlar için Remote Config şablon varsayılanlarını indirme başlıklı makaleyi inceleyin.

Sonraki adımlar