Remote Config şablonları, Firebase projeniz için oluşturduğunuz JSON biçimli parametre ve koşullar gruplarıdır. Uygulamanızın değerleri getireceği istemci şablonları ve sunucu istemcilerinin değerleri getirebileceği sunucu şablonları oluşturabilirsiniz.
Bu bölümde sunucu şablonları açıklanmaktadır. İstemciye özel şablonlar hakkında bilgi edinmek için İstemci şablonları'nı tıklayın.Şablonun içeriği Parametreler ve Koşullar sekmelerinde grafik biçiminde görüntülenen Firebase konsolunu kullanarak şablonu değiştirir ve yönetirsiniz.
Aşağıda bir sunucu şablon dosyası örneği verilmiştir:
{
"parameters": {
"preamble_prompt": {
"defaultValue": {
"value": "You are a helpful assistant who knows everything there is to know about Firebase! "
},
"description": "Add this prompt to the user's prompt",
"valueType": "STRING"
},
"model_name": {
"defaultValue": {
"value": "gemini-pro-test"
},
"valueType": "STRING"
},
"generation_config": {
"defaultValue": {
"value": "{\"temperature\": 0.9, \"maxOutputTokens\": 2048, \"topP\": 0.9, \"topK\": 20}"
},
"valueType": "JSON"
},
},
"version": {
"versionNumber": "19",
"isLegacy": true
}
}
Firebase konsoluyla aşağıdaki sürüm yönetimi görevlerini gerçekleştirebilirsiniz:
- Depolanan tüm şablon sürümlerini listele
- Belirli bir sürümü alma
- Belirli bir istemci sürümüne geri döndür
- Remote Config şablonlarını Değişiklik geçmişi sayfasından silin
Şablon türü (300 istemci şablonu ve 300 sunucu şablonu) başına toplam 300 ömür boyu depolanan sürüm sınırı vardır. Bu sınıra, silinen şablonlar için depolanan sürüm numaraları dahildir. Bir projenin kullanım süresi boyunca şablon türü başına 300'den fazla şablon sürümü yayınlarsanız en eski sürümler silinir. Böylece, ilgili türün en fazla 300 sürümü korunur.
Parametreleri her güncellediğinizde Remote Config, sürümü yeni bir Remote Config şablonu oluşturur ve önceki şablonu gerektiğinde alıp geri alabileceğiniz bir sürüm olarak depolar. Sürüm numaraları, Remote Config tarafından depolanan ilk değerden itibaren sırayla artırılır.
Tüm şablonlarda, gösterildiği gibi söz konusu sürümle ilgili meta verileri içeren bir version alanı bulunur.
Remote Config şablonlarını gereken şekilde Değişiklik geçmişi sayfasından silebilirsiniz.
Remote Config şablon sürümlerini yönetin
Bu bölümde Remote Config şablonunuzun sürümlerini nasıl yöneteceğiniz açıklanmaktadır.
Remote Config şablonunun depolanan tüm sürümlerini listeleme
Remote Config şablonunun depolanan tüm sürümlerinin listesini alabilirsiniz. Bunun için:
Firebase konsolunda Remote Config'i açın.
Ardından, Parametreler sekmesinden sağ üstte görüntülenen "saat" simgesini seçin.
Bu işlem, saklanan tüm şablon sürümlerinin sağ tarafındaki bir liste menüsünde listelendiği Değişiklik geçmişi sayfasını açar.
Şablon listesi, güncellemenin zamanı, işlemi yapan kullanıcı ve nasıl yapıldığı da dahil olmak üzere depolanan tüm sürümlerin meta verilerini içerir.
Remote Config şablonunun belirli bir sürümünü alma
Remote Config şablonunun depolanmış herhangi bir sürümünü alabilirsiniz. Depolanan bir şablon sürümünü almak için:
Değişiklik geçmişi'nin ayrıntılar bölmesini açın.
Listedeki başka bir sürümün ayrıntılarını görüntülemek için sağdaki menüden sürümü seçin.
Seçilmemiş herhangi bir sürüm için içerik menüsünün üzerine gelip Seçilen sürümle karşılaştır'ı seçerek etkin şablon ve depolanan diğer sürümlerin ayrıntılı farkını görüntüleyin.
Remote Config şablonunun depolanan belirli bir sürümüne geri döndür
Şablonun depolanan herhangi bir sürümüne geri dönebilirsiniz. Bir şablonu geri çekmek için:
- Değişiklik geçmişi sayfasının sağ üst kısmındaki seçenek düğmesini bulun. Bunu yalnızca ilgili sürüme geri dönmek ve bu değerleri tüm uygulamalar ile kullanıcılar için hemen kullanmak istediğinizden eminseniz tıklayıp onaylayın.
Bu geri alma işleminin, etkili bir şekilde yeni bir numaralı sürüm oluşturduğunu unutmayın. Örneğin, sürüm 10'dan sürüm 6'ya geri dönmek, sürüm 6'nın etkili bir şekilde yeni bir kopyasını oluşturur. Bu kopya, orijinal sürümden yalnızca sürüm numarasının 11 olmasıyla farklıdır. Orijinal sürüm 6, geçerlilik bitiş tarihine ulaşmadığı varsayılarak hâlâ depolanır ve sürüm 11, etkin şablon haline gelir.
Remote Config şablonu silme
Firebase konsolundan Remote Config şablonlarını silebilirsiniz. Bir Remote Config şablonunu silmek için:
1. Remote Config Parametreler sayfasında, Değişiklik geçmişi'ni tıklayın.Silmek istediğiniz şablona geçin, Diğer'i tıklayın ve Sil'i seçin.
Silme işlemini onaylamanız istendiğinde Sil'i tıklayın.
Remote Config şablonlarını indirin ve yayınlayın
Kaynak kontrolü ve derleme sistemlerinize entegre etmek, yapılandırma güncellemelerini otomatikleştirmek ve parametreler ile değerleri birden çok projede senkronize etmek için Remote Config şablonlarını indirip yayınlayın.
Şu anda etkin olan Remote Config şablonunu Firebase konsolundan indirebilirsiniz. Daha sonra, dışa aktarılan JSON dosyasını güncelleyip aynı projede yayınlayabilir veya yeni ya da mevcut bir projede yayınlayabilirsiniz.
Yazılım geliştirme yaşam döngünüzün geliştirme, test, hazırlık ve üretim ortamları gibi farklı aşamalarını temsil eden birden fazla projeniz olduğunu varsayalım. Bu durumda, tamamen test edilmiş bir şablonu hazırlık ortamınızdan indirip üretim projenize yayınlayarak üretim ortamınıza yükseltebilirsiniz.
Bu yöntemi bir projeden diğerine yapılandırmaları taşımak veya yeni bir projeyi mevcut bir projenin parametre ve değerleriyle doldurmak için de kullanabilirsiniz.
Bir A/B testi denemesinde özel olarak varyant olarak oluşturulan parametreler ve parametre değerleri, dışa aktarılan şablonlara dahil edilmez.
Remote Config şablonlarını dışa ve içe aktarmak için:
- Geçerli Remote Config Config şablonunu indirin.
- Remote Config şablonunu doğrulayın.
- Remote Config şablonunu yayınlayın.
Mevcut Remote Config şablonunu indirin
Etkin Remote Config şablonunu JSON biçiminde indirmek için aşağıdakileri kullanın:
- Remote Config Parameters veya Koşullar (Uzak Yapılandırma Parametreleri veya Koşullar) sekmesinden Menü'yü açın ve Geçerli yapılandırma dosyasını indir'i seçin.
- İstendiğinde Yapılandırma dosyasını indir'i tıklayın, dosyayı kaydetmek istediğiniz konumu seçin ve ardından Kaydet'i tıklayın.
Remote Config şablonunu doğrulayın
Firebase konsolundan yayınlamaya çalıştığınızda sunucu şablonları doğrulanır. Rastgele Yüzde koşullarındaki Kullanıcı özelliğinin içe aktarılabileceğini, ancak desteklenmeyen herhangi bir koşulun yükleme sırasında hata oluşturacağını unutmayın. Orijinal olarak istemci şablonundan dışa aktarılan bir şablonu yayınlamaya çalışıyorsanız önce müşteriye özel koşulları kaldırdığınızdan emin olun.
Remote Config şablonunu yayınlayın
Şablonu indirdikten, JSON içeriğinde gerekli değişiklikleri yaptıktan ve doğruladıktan sonra dosyayı bir projeye yayınlayabilirsiniz.
Şablon yayınladığınızda, mevcut yapılandırma şablonunun tamamı güncellenen dosyayla değiştirilir ve şablon sürümü bir birim artar. Yapılandırmanın tamamı değiştirildiği için JSON dosyasından bir parametreyi silip yayınlarsanız parametre sunucudan silinir ve artık istemciler tarafından kullanılamaz.
Yayınlama işleminden sonra, parametrelerde ve değerlerde yapılan değişiklikler uygulamalarınız ve kullanıcılarınız için anında kullanıma sunulur. Gerekirse önceki sürüme dönebilirsiniz.
Şablonunuzu yayınlamak için aşağıdaki komutları kullanın:
- Remote Config Parameters veya Koşullar (Uzak Yapılandırma Parametreleri veya Koşullar) sekmesinde Menü'yü açın ve Publish from a file (Dosyadan yayınla) seçeneğini belirleyin.
- İstendiğinde Browse'u (Göz at) tıklayın, yayınlamak istediğiniz Remote Config dosyasına gidip bu dosyayı seçin ve ardından Select'i (Seç) tıklayın.
- Dosya doğrulanır ve başarılı olursa yapılandırmayı uygulamalarınız ve kullanıcılarınız için hemen kullanılabilir hale getirmek için Yayınla'yı tıklayabilirsiniz.
Sonraki adımlar
- Sunucu ortamlarında Remote Config'i kullanma hakkında daha fazla bilgi edinin.
- Cloud Functions ve Vertex AI ile sunucu tarafı Remote Config'i deneyin.