Google is committed to advancing racial equity for Black communities. See how.
Bu sayfa, Cloud Translation API ile çevrilmiştir.
Switch to English

Uzaktan Yapılandırma Parametreleri ve Koşulları

Firebase konsolu veya Remote Config arka uç API'lerini kullanırken , bir veya daha fazla parametre (anahtar / değer çiftleri) tanımlar ve bu parametreler için uygulama içi varsayılan değerler sağlarsınız. Sunucu tarafı parametre değerlerini tanımlayarak uygulama içi varsayılan değerleri geçersiz kılabilirsiniz. Parametre anahtarları ve parametre değerleri dizedir, ancak uygulamanızda bu değerleri kullandığınızda parametre değerleri diğer veri türleri olarak kullanılabilir.

Firebase konsolunu veya Remote Config REST API'sini kullanarak, parametreleriniz için yeni varsayılan değerler ve uygulama örneği gruplarını hedeflemek için kullanılan koşullu değerler oluşturabilirsiniz. Firebase konsolunda yapılandırmanızı her güncellediğinizde Firebase, Uzaktan Yapılandırma şablonunuzun yeni bir sürümünü oluşturur ve yayınlar. Önceki sürüm saklanır ve gerektiğinde geri almanıza veya geri almanıza olanak tanır. Bu işlemleri REST API'sı aracılığıyla da kullanabilirsiniz.

Bu kılavuzda parametreleri, koşulları, kuralları, koşullu değerleri ve Remote Config Server'da ve uygulamanızda çeşitli parametre değerlerinin nasıl önceliklendirildiği açıklanmaktadır. Ayrıca, koşul oluşturmak için kullanılan kural türleri hakkında ayrıntılar sağlar.

Koşullar, kurallar ve koşullu değerler

Bir grup uygulama örneğini hedeflemek için bir koşul kullanılır. Koşullar herkese değerlendirmek gerekir, bir veya daha fazla kural oluşur true durum için değerlendirmek için true bir verilen uygulama örneğine ait. Bir kuralın değeri tanımlanmamışsa (örneğin, hiçbir değer yoksa), bu kural false değerlendirilir.

Örneğin, bir uygulamanın açılış sayfasını tanımlayan bir parametre, if device_os = Android basit kuralı kullanarak OS türüne göre farklı görüntüler görüntüleyebilir:

Veya, uygulamanızın ne zaman özel promosyon öğeleri görüntülediğini kontrol etmek için bir zaman koşulu kullanılabilir.

Bir parametrenin farklı koşulları kullanan birden fazla koşullu değeri olabilir ve parametreler bir proje içindeki koşulları paylaşabilir.

Parametre değeri önceliği

Bir parametrenin kendisiyle ilişkilendirilmiş birkaç koşullu değeri olabilir. Aşağıdaki kurallar, Remote Config Server'dan hangi değerin getirileceğini ve belirli bir uygulama örneğinde belirli bir zamanda hangi değerin kullanılacağını belirler:

Sunucu tarafı parametre değerleri aşağıdaki öncelik listesine göre getirilir

  1. İlk olarak, eğer varsa, belirli bir uygulama örneği için true değerlendirilen koşullara sahip koşullu değerler uygulanır. Birden çok koşul true değerlendirilirse, Firebase konsolu kullanıcı arayüzünde gösterilen ilk (en üstteki) önceliğe sahiptir ve bir uygulama arka uçtan değerler aldığında bu koşulla ilişkili koşullu değerler sağlanır. Koşullar sekmesindeki koşulları sürükleyip bırakarak koşulların önceliğini değiştirebilirsiniz.

  2. Koşulları true değerlendiren koşullu değerler yoksa, bir uygulama arka uçtan değerler aldığında sunucu tarafı varsayılan değeri sağlanır. Arka uçta bir parametre yoksa veya varsayılan değer Hayır değeri olarak ayarlanmışsa, bir uygulama değerleri aldığında bu parametre için hiçbir değer sağlanmaz.

Uygulamanızda parametre değerleri, aşağıdaki öncelik listesine göre get yöntemleri ile döndürülür

  1. Arka uçtan bir değer getirilir ve sonra etkinleştirilirse uygulama getirilen değeri kullanır. Etkinleştirilen parametre değerleri kalıcıdır.
  2. Arka uçtan herhangi bir değer getirilmemişse veya Uzaktan Yapılandırma arka ucundan getirilen değerler etkinleştirilmemişse, uygulama uygulama içi varsayılan değerini kullanır.
  3. Uygulama iç varsayılan değer kümesi olmuşsa, uygulaması (örneğin statik tip değeri kullanır 0 için int ve false için boolean ).

Bu grafik, Uzaktan Yapılandırma arka ucunda ve uygulamanızda parametre değerlerinin nasıl önceliklendirildiğini özetler:

Parametre grupları

Uzaktan Yapılandırma, daha organize bir kullanıcı arayüzü ve zihinsel model için parametreleri birlikte gruplandırmanıza olanak tanır.

Örneğin, yeni bir giriş özelliğini kullanıma sunarken üç farklı kimlik doğrulama türünü etkinleştirmeniz veya devre dışı bırakmanız gerektiğini varsayalım. Remote Config ile, türleri istediğiniz gibi etkinleştirmek için üç parametre oluşturabilir ve bunları önek veya özel sıralama eklemeye gerek kalmadan "Yeni oturum açma" adlı bir grupta düzenleyebilirsiniz.

Firebase konsolunu veya Remote Config REST API'sini kullanarak parametre grupları oluşturabilirsiniz. Oluşturduğunuz her parametre grubunun Uzaktan Yapılandırma şablonunuzda benzersiz bir adı vardır. Parametre grupları oluştururken şunları unutmayın:

  • Parametreler her zaman yalnızca bir gruba dahil edilebilir ve bir parametre anahtarı tüm parametreler arasında benzersiz olmalıdır.
  • Parametre grubu adları 256 karakterle sınırlıdır.
  • Hem REST API'sini hem de Firebase konsolunu kullanıyorsanız, yayınlama sırasında parametre gruplarını işlemek için herhangi bir REST API mantığının güncellendiğinden emin olun.

Firebase konsolunu kullanarak parametre grupları oluşturun veya değiştirin

Parametreleri , Firebase konsolunun Parametreler sekmesinde gruplayabilirsiniz. Bir grup oluşturmak veya değiştirmek için:

  1. Grupları yönet'i seçin.
  2. Eklemek istediğiniz parametreler için onay kutularını seçin ve Gruba taşı'yı seçin.
  3. Mevcut bir grubu seçin veya bir ad ve açıklama girip Yeni grup oluştur'u seçerek yeni bir grup oluşturun . Bir grubu kaydettikten sonra, Değişiklikleri yayınla düğmesi kullanılarak yayınlanabilir.

Programlı olarak grup oluşturma

Remote Config REST API , parametre grupları oluşturmak ve yayınlamak için otomatik bir yol sağlar. REST'i bildiğinizi ve API'ya yönelik istekleri yetkilendirmek üzere ayarlandığınızı varsayarak, grupları programlı olarak yönetmek için şu adımları uygulayabilirsiniz:

  1. Geçerli şablonu al
  2. Parametre gruplarınızı temsil etmek için JSON nesneleri ekleyin
  3. Bir HTTP PUT isteği kullanarak parametre gruplarını yayınlayın.

parameterGroups nesnesi, iç içe bir açıklama ve gruplandırılmış parametrelerin listesi ile birlikte grup anahtarları içerir. Her grup anahtarının genel olarak benzersiz olması gerektiğini unutmayın.

Örneğin, burada "new menu" parametre grubunu bir parametre ile ekleyen bir şablon revizyonundan bir alıntı, pumpkin_spice_season :

{
  "parameters": {},
  "version": {
    "versionNumber": "1",

    …


  },
  "parameterGroups": {
    "new menu": {
      "description": "New Menu",
      "parameters": {
        "pumpkin_spice_season": {
          "defaultValue": {
            "value": "true"
          },
          "description": "Whether it's currently pumpkin spice season."
        }
      }
    }
  }
}

Koşul kuralı türleri

Firebase konsolunda aşağıdaki kural türleri desteklenir. Eşdeğer işlevsellik, koşullu ifade başvurusunda ayrıntılı olarak açıklandığı gibi, Remote Config REST API'sinde kullanılabilir.

Kural türü Operatörü (ler) Değer (ler) Not
Uygulama == Firebase projenizle ilişkili uygulamalar için Uygulama Kimlikleri listesinden seçim yapın. Firebase'e bir uygulama eklediğinizde, Uzaktan Yapılandırma kurallarında Uygulama Kimliği olarak gösterilen bir özelliği tanımlayan bir iOS paket kimliği veya Android paket adı girersiniz.

Bu özelliği aşağıdaki gibi kullanın:
  • Kullanım uygulamanın: iOS için CFBundleIdentifier . Paket Kimliğini , uygulamanızın Xcode'daki birincil hedefi için Genel sekmesinde bulabilirsiniz.
  • Android için: Uygulamanın applicationId'ini kullanın. Sen bulabilirsiniz applicationId uygulama düzeyinde de build.gradle dosyası.
Uygulama sürümü Dize değerleri için:
tam olarak eşleşir,
içerir
içermiyor,
Düzenli ifade

Sayısal değerler için:
=, ≠,>, ≥, <, ≤
Uygulamanızın belirli bir sürümünü (veya ilgili sürümlerini) belirtmek için bir değer girin. Bu kuralı kullanmadan önce, Firebase projenizle ilişkili bir Android uygulaması seçmek için bir Uygulama Kimliği kuralı kullanmanız gerekir. Bu operatör yalnızca Android uygulamaları için kullanılabilir ve uygulamanın sürüm adına karşılık gelir. Bu kural için dize karşılaştırmaları büyük / küçük harfe duyarlıdır.

Tam olarak eşleşir , içerir , içermez veya normal ifade işleci kullanırken, birden çok değer seçebilirsiniz.

Normal ifade operatörünü kullanırken, RE2 biçiminde normal ifadeler oluşturabilirsiniz. Normal ifadeniz, hedef sürüm dizesinin tamamı veya bir kısmı ile eşleşebilir. ^ Ve $ bağlantılarını hedef dizenin başlangıcı, sonu veya bütünüyle eşleştirmek için de kullanabilirsiniz.

Yapı numarası Dize değerleri için:
tam olarak eşleşir,
içerir
içermiyor,
Düzenli ifade

Sayısal değerler için:
=, ≠,>, ≥, <, ≤
Uygulamanızın belirli bir sürümünü (veya ilgili sürümlerini) belirtmek için bir değer girin. Bu kuralı kullanmadan önce, Firebase projenizle ilişkili bir iOS uygulaması seçmek için bir Uygulama Kimliği kuralı kullanmanız gerekir. Bu operatör yalnızca iOS uygulamaları için kullanılabilir ve uygulamanın CFBundleVersion sürümüne karşılık gelir. Bu kural için dize karşılaştırmaları büyük / küçük harfe duyarlıdır.

Tam olarak eşleşir , içerir , içermez veya normal ifade operatörünü kullanırken birden çok değer seçebilirsiniz.

Normal ifade operatörünü kullanırken, RE2 biçiminde normal ifadeler oluşturabilirsiniz. Normal ifadeniz, hedef sürüm dizesinin tamamı veya bir kısmı ile eşleşebilir. ^ Ve $ bağlantılarını hedef dizenin başlangıcı, bitişi veya tamamı ile eşleştirmek için de kullanabilirsiniz.

İşletim sistemi türü == iOS
Android
Tarih / Saat <=,> Cihaz saat diliminde veya "(GMT + 11) Sydney saati" gibi belirli bir saat diliminde belirtilen tarih ve saat. Geçerli saati aygıt getirme süresiyle karşılaştırır.
Kullanıcı rastgele yüzdelik <=,> 0-100

Kullanıcıları (uygulama örnekleri) gruplara ayırmak için <= ve > operatörlerini kullanarak uygulama örneklerinin rastgele bir örneğine (% .0001 kadar küçük örnek boyutları ile) bir değişiklik uygulamak için bu alanı kullanın.

Her uygulama örneği, o projede tanımlanan bir anahtara göre kalıcı olarak rastgele bir tam veya kesirli sayıya eşlenir. Bir kural, başka bir anahtar seçmez veya oluşturmazsanız varsayılan anahtarı (Firebase konsolunda DEF olarak gösterilir) kullanır. Bu anahtarı kullanarak kullanıcıları rastgele seç alanını temizleyerek varsayılan anahtarı kullanmaya bir kural döndürebilirsiniz. Belirli uygulama yüzdeleri içindeki aynı uygulama örneklerini tutarlı bir şekilde ele almak için kurallar arasında tek bir anahtar kullanabilirsiniz. Veya yeni bir anahtar oluşturarak belirli bir yüzde aralığı için rastgele atanmış yeni bir uygulama örneği grubu seçebilirsiniz.

Örneğin, her biri bir uygulamanın kullanıcılarının çakışmayan% 5'i için geçerli olan iki ilgili koşul oluşturmak için bir koşulun <=% 5 kuralı ve başka bir koşulun hem >% 5 kuralı hem de <= % 10 kural. Bazı kullanıcıların her iki grupta da rastgele görünmesini sağlamak için, her koşuldaki kurallar için farklı anahtarlar kullanın.

Kullanıcı kitleye == Projeniz için ayarladığınız Google Analytics kitleleri listesinden bir veya daha fazlasını seçin.

Bu kural, Firebase projenizle ilişkili bir uygulamayı seçmek için bir Uygulama Kimliği kuralı gerektirir.

Not: Birçok Analytics kitlesi, uygulama kullanıcılarının eylemlerini temel alabilecek etkinlikler veya kullanıcı özellikleri tarafından tanımlandığından , kitle içindeki bir Kullanıcının belirli bir uygulama örneği için geçerli olması biraz zaman alabilir.

Bölge / ülkede cihaz == Bir veya daha fazla bölge veya ülke seçin. Örnek listelenen bölgelerden veya ülkelerden birindeyse, bu kural belirli bir uygulama örneği için true değerlendirilir. Cihaz ülke kodu, istekte cihazın IP adresi veya Firebase Analytics tarafından belirlenen ülke kodu kullanılarak belirlenir (Analytics verileri Firebase ile paylaşılıyorsa).
Cihaz dili == Bir veya daha fazla dil seçin. Bu uygulama, listelenen dillerden birini kullanan bir cihaza yüklüyse, bu kural belirli bir uygulama örneği için true değerlendirilir.
Kullanıcı mülkü Dize değerleri için:
içerir
içermiyor,
tam olarak eşleşir,
Düzenli ifade

Sayısal değerler için:
=, ≠,>, ≥, <, ≤

Not: İstemcide, kullanıcı özellikleri için yalnızca dize değerleri ayarlayabilirsiniz. Sayısal işleçleri kullanan koşullar için, Remote Config karşılık gelen kullanıcı özelliğinin değerini bir tamsayı / kayan noktaya dönüştürür.
Kullanılabilir Google Analytics kullanıcı mülkleri listesinden seçim yapın. Uygulamanızı kullanıcı tabanınızın çok belirli bölümleri için özelleştirmek üzere kullanıcı özelliklerini nasıl kullanabileceğinizi öğrenmek için, bkz. Uzaktan Yapılandırma ve kullanıcı özellikleri .

Kullanıcı özellikleri hakkında daha fazla bilgi edinmek için aşağıdaki kılavuzlara bakın:

Tam olarak eşleşen , içeren , içermeyen veya normal ifade operatörünü kullanırken, birden çok değer seçebilirsiniz.

Normal ifade operatörünü kullanırken, RE2 biçiminde normal ifadeler oluşturabilirsiniz. Normal ifadeniz, hedef sürüm dizesinin tamamı veya bir kısmı ile eşleşebilir. ^ Ve $ bağlantılarını hedef dizenin başlangıcı, sonu veya bütünüyle eşleştirmek için de kullanabilirsiniz.

Not: Uzaktan Yapılandırma koşulları oluşturulurken otomatik olarak toplanan kullanıcı özellikleri şu anda kullanılamamaktadır.

Parametreleri ve koşulları arama

Uzaktan Yapılandırma Parametreleri sekmesinin üstündeki arama kutusunu kullanarak Firebase konsolundan projenizin parametre anahtarlarını, parametre değerlerini ve koşullarını arayabilirsiniz.

Parametreler ve koşullar üzerindeki limitler

Bir Firebase projesinde, 2000 parametreye ve 500 koşula kadar sahip olabilirsiniz. Parametre tuşları 256 karakter uzunluğunda olabilir, bir alt çizgi veya İngilizce harf karakteriyle (AZ, az) başlamalıdır ve ayrıca sayılar içerebilir. Bir proje içindeki parametre değeri dizelerinin toplam uzunluğu 800.000 karakteri aşamaz.

Sonraki adımlar

Firebase projenizi yapılandırmaya başlamak için bkz. Firebase Uzaktan Yapılandırma Projesi Kurma .