Remote Config Şablonları ve Sürüm Oluşturma


Remote Config şablonları, Firebase projeniz için oluşturduğunuz JSON biçimli parametre ve koşul kümeleridir. Uygulamanızın değerleri getirdiği istemci şablonları ve sunucu istemcilerinin değerleri getirebileceği sunucu şablonları oluşturabilirsiniz.

Bu bölümde sunucu şablonları ele alınmaktadır. Müşteriye özel şablonlar hakkında bilgi edinmek için Müşteri şablonları'nı tıklayın.

Şablonu, Firebase konsolunu kullanarak değiştirir ve yönetirsiniz. Konsol, şablonun içeriğini Parametreler ve Koşullar sekmelerinde grafik biçiminde gösterir.

Aşağıda bir sunucu şablonu 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
  }
}

Bu sürüm yönetimi görevlerini Firebase konsoluyla gerçekleştirebilirsiniz:

  • Saklanan tüm şablon sürümlerini listeleme
  • Belirli bir sürümü alma
  • Belirli bir istemci sürümüne geri dönme
  • Değişiklik geçmişi sayfasından Remote Config şablonlarını silme

Şablon türü başına toplam 300 kullanıcı ömrü boyunca depolanmış sürüm sınırı vardır (300 istemci şablonu ve 300 sunucu şablonu). Bu sayıya, silinen şablonların depolanmış 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.

Parametreleri her güncellediğinizde Remote Config, yeni bir sürüm oluşturulmuş Remote Config şablonu oluşturur 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, gösterildiği gibi, söz konusu sürümle ilgili meta verileri içeren bir version alanı bulunur.

Remote Config konsolundaki Değişiklik geçmişi sayfasından Remote Config şablonlarını gerektiği gibi silebilirsiniz.

Remote Config şablon sürümlerini yönetme

Bu bölümde, Remote Config şablonunuzun sürümlerini nasıl yöneteceğiniz açıklanmaktadır.

Remote Config şablonunun saklanan tüm sürümlerini listeleme

Remote Config şablonunun depolanmış tüm sürümlerinin listesini alabilirsiniz. Bunun için:

  1. Firebase konsolundan Remote Config hizmetini açın.

  2. Ardından, Parametreler sekmesinde sağ üstte gösterilen "saat" simgesini seçin.

    Bu işlem, sağdaki liste menüsünde depolanan tüm şablon sürümlerinin listelendiği Değişiklik geçmişi sayfasını açar.

    Şablon listesinde, güncelleme zamanı, güncellemeyi yapan kullanıcı ve güncellemenin nasıl yapıldığı dahil olmak üzere depolanan tüm sürümlerin meta verileri yer alır.

Remote Config şablonunun belirli bir sürümünü alma

Remote Config şablonunun saklanan belirli bir sürümünü alabilirsiniz. Kayıtlı bir şablon sürümünü almak için:

  1. Değişiklik geçmişi ayrıntılar bölmesini açın.

  2. Listedeki başka bir sürümün ayrıntılarını görüntülemek için sağ menüden ilgili sürümü seçin.

  3. Etkin şablonun ve depolanan diğer sürümlerin ayrıntılı farkını görüntülemek için seçilmeyen bir sürümün bağlam menüsünün üzerine gelin ve Seçili sürümle karşılaştır'ı seçin.

Remote Config şablonunun belirli bir kayıtlı sürümüne geri dönme

Şablonun depolanan herhangi bir sürümüne geri dönebilirsiniz. Bir şablonu geri almak için:

  1. Değişiklik geçmişi sayfasının sağ üst kısmındaki seçenek düğmesini bulun. Bu işlemi yalnızca söz konusu sürüme geri dönmek ve bu değerleri tüm uygulamalar ve kullanıcılar için hemen kullanmak istediğinizden eminseniz tıklayın ve onaylayın.

Bu geri alma işleminin aslında yeni bir numaralı sürüm oluşturduğunu unutmayın. Örneğin, 10. sürümden 6. sürüme geri dönmek, 6. sürümün yeni bir kopyasını oluşturur. Bu kopya, orijinalinden yalnızca sürüm numarasının 11 olmasıyla farklıdır. Orijinal 6. sürüm, geçerlilik süresi dolmamışsa depolanmaya devam eder ve 11. sürüm etkin şablon haline gelir.

Remote Config şablonunu silme

Remote Config şablonlarını Firebase konsolundan silebilirsiniz. Remote Config şablonunu silmek için:

1. Remote Config Parametreler sayfasında Değişiklik geçmişi'ni tıklayın.

  1. Silmek istediğiniz şablona geçin, Diğer'i tıklayın ve Sil'i seçin.

  2. Silme işlemini onaylamanız istendiğinde Sil'i tıklayın.

Remote Config şablonlarını indirip yayınlama

Remote Config şablonlarını indirip yayınlayarak bunları kaynak kontrolü ve derleme sistemlerinize entegre edin, yapılandırma güncellemelerini otomatikleştirin ve parametrelerle değerleri birden fazla projede senkronize tutun.

Şu anda etkin olan Remote Configşablonu Firebase konsolundan indirebilirsiniz. Ardından, dışa aktarılan JSON dosyasını güncelleyip aynı projede veya yeni ya da mevcut bir projede yayınlayabilirsiniz.

Yazılım geliştirme yaşam döngünüzün farklı aşamalarını temsil eden birden fazla projeniz olduğunu varsayalım (ör. geliştirme, test, hazırlık ve üretim ortamları). Bu durumda, hazırlık projenizden indirip üretim projenizde yayınlayarak hazırlık ortamınızdaki tam olarak test edilmiş bir şablonu üretim ortamınıza yükseltebilirsiniz.

Bu yöntemi, yapılandırmaları bir projeden diğerine taşımak veya yeni bir projeyi yerleşik bir projedeki parametreler ve değerlerle doldurmak için de kullanabilirsiniz.

Özellikle bir A/B Testing denemesindeki varyantlar 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:

  1. Mevcut Remote Config yapılandırma şablonunu indirin.
  2. Remote Config şablonunu doğrulayın.
  3. Remote Config şablonunu yayınlayın.

Mevcut Remote Config şablonunu indirme

Etkin Remote Config şablonunu JSON biçiminde indirmek için aşağıdakileri kullanın:

  1. Remote Config Parametreler veya Koşullar sekmesinde Menü'yü açın ve Mevcut yapılandırma dosyasını indir'i seçin.
  2. İstendiğinde Yapılandırma dosyasını indir'i tıklayın, dosyayı kaydetmek istediğiniz konumu seçin ve Kaydet'i tıklayın.

Remote Config şablonunu doğrulama

Sunucu şablonları, Firebase konsolundan yayınlamaya çalıştığınızda doğrulanır. Rastgele yüzdelik dilimdeki kullanıcı koşullarının içe aktarılabileceğini ancak desteklenmeyen koşulların yükleme sırasında hataya neden olacağını unutmayın. Başlangıçta bir istemci şablonundan dışa aktarılmış bir şablonu yayınlamaya çalışıyorsanız önce istemciye özel koşulları kaldırdığınızdan emin olun.

Remote Config şablonunu yayınlayın

Bir şablonu indirip JSON içeriğinde gerekli değişiklikleri yaptıktan ve doğruladıktan sonra şablonu bir projede yayınlayabilirsiniz.

Şablon yayınlamak, mevcut yapılandırma şablonunun tamamını güncellenmiş dosyayla değiştirir ve şablon sürümünü bir artırır. Yapılandırmanın tamamı değiştirildiğinden, bir parametreyi JSON dosyasından 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ızda ve kullanıcılarınızda hemen kullanılabilir. Gerekirse önceki bir sürüme geri dönebilirsiniz.

Şablonunuzu yayınlamak için aşağıdaki komutları kullanın:

  1. Remote ConfigParametreler veya Koşullar sekmesinde Menü'yü açın ve Dosyadan yayınla'yı seçin.
  2. İstendiğinde Göz at'ı tıklayın, yayınlamak istediğiniz Remote Config dosyasına gidin ve bu dosyayı seçin, ardından Seç'i tıklayın.
  3. Dosya doğrulanır ve başarılı olursa yapılandırmayı uygulamalarınızda ve kullanıcılarınızda hemen kullanılabilir hale getirmek için Yayınla'yı tıklayabilirsiniz.

Sonraki adımlar