Odwołanie do wyrażenia warunkowego Zdalnej konfiguracji

Ta strona zawiera informacje referencyjne na temat tworzenia wyrażeń warunkowych za pomocą Remote Configinterfejsów backendowych lub konsoli Firebase. Więcej informacji o konfigurowaniu i używaniu interfejsów API backendu znajdziesz w artykule Modyfikowanie zdalnej konfiguracji za pomocą kodu.

Elementy używane do tworzenia warunków

Interfejs API REST Remote Config obsługuje te same elementy, których możesz używać do tworzenia warunków podczas konfigurowania Remote Config w konsoli Firebase:

Element	Opis
`&&`	Służy do tworzenia logicznego „i” dla elementów, jeśli w warunku jest używanych więcej niż 1 element. Jeśli element jest używany w składni REST bez parametru `&&` , jest on traktowany jako warunek. Uwaga: przed i za symbolem „&” musi być spacja. Przykład: `element1 && element2`.
`app.build`	Wynik funkcji to `TRUE` lub `FALSE` w zależności od wartości numeru kompilacji aplikacji. Uwaga: funkcja dostępna tylko na urządzeniach Apple i Android. W przypadku Apple użyj wartości CFBundleVersion, a w przypadku Androida – wartości versionCode.
`app.version`	Wynik funkcji to `TRUE` lub `FALSE` w zależności od wartości numeru wersji aplikacji. Uwaga: w przypadku urządzeń z Androidem użyj wartości versionName, a w przypadku urządzeń Apple – wartości CFBundleShortVersionString.
`app.id`	Element na podstawie identyfikatora aplikacji Firebase.
`app.audiences`	Element, który przyjmuje wartość `TRUE` lub `FALSE` w zależności od tego, czy użytkownik znajduje się na co najmniej 1 liście odbiorców Analytics w Firebase.
`app.firstOpenTimestamp`	Element określający, czy użytkownik uruchomił aplikację po raz pierwszy. Dane pochodzą ze zdarzenia Google Analytics `first_open`. Używa formatu daty ISO z opcją określenia stałej strefy czasowej, np. `app.firstOpenTimestamp >= ('2022-10-31T14:37:47', 'America/Los_Angeles')`. Jeśli nie zostanie określona strefa czasowa, zostanie użyta strefa GMT.
`app.userProperty`	Element, który zwraca wartość `TRUE` lub `FALSE` w zależności od wartości liczbowej lub ciągu znaków właściwości użytkownika w Analytics dla Firebase.
`app.operatingSystemAndVersion`	Element oparty na systemie operacyjnym, na którym działa aplikacja. Wynik `TRUE`, gdy system operacyjny i jego wersja są zgodne z określonym celem. Uwaga: ta opcja jest dostępna tylko w przypadku aplikacji internetowych.
`app.browserAndVersion`	Element zależny od przeglądarki, w której działa aplikacja. Ocenia wartość `TRUE`, gdy przeglądarka i jej wersja są zgodne z określonym celem. Uwaga: ta opcja jest dostępna tylko w przypadku aplikacji internetowych.
`app.firebaseInstallationId`	Element oparty na identyfikatorach konkretnych instalacji na urządzeniu. Ta funkcja zwraca wartość `TRUE`, gdy identyfikator instalacji jest zgodny z jednym ze wskazanych identyfikatorów instalacji.
`device.country`	Element określający region lub kraj, w którym znajduje się urządzenie, zgodnie ze standardem ISO 3166-1 alfa-2 (np. US lub UK). Wynik funkcji to `TRUE`, gdy kraj jest zgodny z oczekiwanym kodem kraju.
`device.dateTime`	Element na podstawie czasu ostatniego pobierania przez urządzenie. Używa formatu daty ISO z opcją , aby określić stałą strefę czasową, na przykład `dateTime('2017-03-22T13:39:44', 'America/Los_Angeles')`.
`device.language`	Element na podstawie języka wybranego na urządzeniu. Język jest reprezentowany za pomocą tagu języka IETF, np. es-ES, pt-BR lub en-US. Ocenia element `TRUE`, gdy język jest zgodny z oczekiwanym kodem języka.
`device.os`	Element oparty na systemie operacyjnym używanym na urządzeniu (Apple lub Android). przyjmuje wartość `TRUE`, gdy system operacyjny urządzenia jest zgodny z oczekiwaniami;
`percent`	Funkcja `TRUE` jest oceniana na podstawie przypisania losowego ułamka procentowego (z wielkościami próby wynoszącymi nawet 0,000001%), w którym użytkownik jest uwzględniony.

Warunek jednoelementowy zawiera 3 pola:

dowolnie zdefiniowany name (maksymalnie 100 znaków)
wyrażenie warunkowe o wartości TRUE lub FALSE, złożone z elementów wymienionych powyżej;
(Opcjonalnie) tagColor, który może mieć wartość „BLUE”, „BROWN”, „CYAN”, „DEEP_ORANGE”, „GREEN”, „INDIGO”, „LIME”, „ORANGE”, „PINK”, „PURPLE” lub „TEAL”. Kolor jest nieistotny i wpływa tylko na sposób wyświetlania warunków w konsoli Firebase.

Obsługiwani operatorzy

Na przykład: app.build.notContains([123, 456]) zwraca TRUE, jeśli rzeczywista wersja aplikacji to 123 lub 492, ale zwraca FALSE, jeśli rzeczywista wersja aplikacji to 999. Na przykład: app.version.notContains([123, 456]) zwraca TRUE, jeśli rzeczywista wersja aplikacji to 123 lub 492, ale zwraca FALSE, jeśli rzeczywista wersja aplikacji to 999.

Element	Obsługiwani operatorzy	Opis
`app.audiences`	`.inAtLeastOne([...])`	Zwraca wartość `TRUE`, jeśli rzeczywista lista odbiorców zawiera co najmniej 1 nazwę listy odbiorców na liście. Na przykład: app.audiences.inAtLeastOne(['Audience 1', 'Audience 2'])
`app.audiences`	`.notInAtLeastOne([...])`	Zwraca wartość `TRUE`, jeśli rzeczywisty odbiorca nie pasuje do co najmniej jednej nazwy odbiorcy na liście.
`app.audiences`	`.inAll([...])`	Zwraca `TRUE`, jeśli rzeczywista lista odbiorców zawiera wszystkie nazwy list odbiorców na liście.
`app.audiences`	`.notInAll([...])`	Zwraca wartość `TRUE`, jeśli bieżąca lista odbiorców nie zawiera żadnego odbiorcy z listy.
`app.firstOpenTimestamp`	`<=, >`	Porównuje czas zdarzenia `first_open` ze wskazanym czasem w warunku i zwraca wartość `TRUE` lub `FALSE` w zależności od operatora. Przykład użycia: `app.firstOpenTimestamp >= ('2022-10-31T14:37:47', 'America/Los_Angeles')`. Aby określić zakres: `app.firstOpenTimestamp >= ('2022-11-01T00:00:00') && app.firstOpenTimestamp < ('2022-12-01T00:00:00')`Jeśli nie określisz strefy czasowej, zostanie użyta strefa GMT.
`app.userProperty`	`<`, `<=`, `==`, `!=`, `>=`, `>`	Zwraca wartość `TRUE`, jeśli rzeczywista właściwość użytkownika jest porównywana numerycznie do wartości określonej w sposób zgodny z operatorem.
`app.userProperty`	`.contains([...])`	Zwraca `TRUE`, jeśli którakolwiek z wartości docelowych jest podciągiem właściwości użytkownika.
`app.userProperty`	`.notContains([...])`	Zwraca `TRUE`, jeśli żadna z wartości docelowych nie jest podciągiem ciągu znaków w rzeczywistej właściwości użytkownika.
`app.userProperty`	`.exactlyMatches([...])`	Zwraca `TRUE`, jeśli rzeczywista właściwość użytkownika dokładnie pasuje (z uwzględnieniem wielkości liter) do dowolnej wartości docelowej na liście.
`app.userProperty`	`.matches([...])`	Zwraca `TRUE`, jeśli dowolne docelowe wyrażenie regularne na liście pasuje do podciągu znaków lub całej wartości. Aby wymusić dopasowanie całego ciągu znaków, poprzedz wyrażenie regularne znakiem „^”, a następnie zakończ je znakiem „$”. Użyj składni RE2.
`app.id`	`==`	Zwraca `TRUE`, jeśli określona wartość pasuje do identyfikatora aplikacji.
`app.build`	`<`, `<=`, `==`, `!=`, `>=`, `>`	Zwraca wartość `TRUE`, jeśli numeryczna wersja kompilacji aplikacji jest porównywana do wartości określonej w sposób pasujący do operatora.
`app.build`	`.contains([...])`	Zwraca `TRUE`, jeśli dowolna z wartości docelowych jest podciągiem ciągu znaków w rzeczywistym kompilacji aplikacji – np. „a” i „bc” są podciągiem ciągu znaków w „abc”.
`app.build`	`.notContains([...])`	Zwraca `TRUE`, jeśli żadna z wartości docelowych nie jest podciągiem ciągu znaków rzeczywistej wersji aplikacji.
`app.build`	`.exactlyMatches([...])`	Zwraca `TRUE`, jeśli rzeczywiste kompilacje aplikacji dokładnie pasują do dowolnej wartości docelowej na liście.
`app.build`	`.matches([...])`	Zwraca `TRUE`, jeśli dowolne docelowe wyrażenie regularne na liście dopasowuje się do podciągu znaków lub całej wartości. Aby wymusić dopasowanie całego ciągu znaków, poprzedz wyrażenie regularne znakiem „^”, a następnie zakończ je znakiem „$”. Użyj składni RE2.
`app.version`	`<`, `<=`, `==`, `!=`, `>=`, `>`	Zwraca `TRUE`, jeśli rzeczywista wersja aplikacji jest porównywana liczbowo do wartości określonej w sposób pasujący do operatora.
`app.version`	`.contains([...])`	Zwraca `TRUE`, jeśli którakolwiek z wartości docelowych jest podciągiem znaków rzeczywistej wersji aplikacji. Na przykład „a” i „bc” są podciągiem znaków ciągu „abc”.
`app.version`	`.notContains([...])`	Zwraca wartość `TRUE`, jeśli żadna z wartości docelowych nie jest podciągiem ciągu znaków rzeczywistej wersji aplikacji.
`app.version`	`.exactlyMatches([...])`	Zwraca `TRUE`, jeśli rzeczywista wersja aplikacji dokładnie pasuje do dowolnej wartości docelowej na liście.
`app.version`	`.matches([...])`	Zwraca `TRUE`, jeśli dowolne docelowe wyrażenie regularne na liście dopasowuje się do podciągu znaków lub całej wartości. Aby wymusić dopasowanie całego ciągu znaków, poprzedz wyrażenie regularne znakiem „^”, a następnie zakończ je znakiem „$”. Użyj składni RE2.
`app.operatingSystemAndVersion`	`.inOne([...])`	Zwraca wartość `TRUE`, jeśli system operacyjny i jego wersja są zgodne z dowolną z wartości docelowych na liście. Na przykład: app.operatingSystemAndVersion.inOne([operatingSystemName('Macintosh').version.==('10.15')])
`app.browserAndVersion`	`.inOne([...])`	Zwraca wartość `TRUE`, jeśli przeglądarka i jej wersja są zgodne z dowolną z wartości docelowych na liście. Na przykład: app.browserAndVersion.inOne([browserName('Chrome').anyVersion])
`app.firebaseInstallationId`	`in [...]`	Zwraca wartość `TRUE`, jeśli identyfikator instalacji jest zgodny z którymś z wymienionych na liście. Przykładowe użycie: `app.firebaseInstallationId in ['eyJhbGciOiJFUzI1N_iIs5', 'eapzYQai_g8flVQyfKoGs7']`
`device.country`	`in [...]`	Zwraca wartość `TRUE`, jeśli kraj urządzenia jest zgodny z dowolnym krajem na liście. Przykład użycia: `device.country in ['gb', 'us']`. Kod kraju urządzenia jest określany na podstawie adresu IP urządzenia w żądaniu lub kodu kraju określonego przez Firebase Analytics (jeśli dane Analytics są udostępniane Firebase).
`device.dateTime`	`<=`, `>`	Porównuje bieżący czas z docelowym czasem warunku i zwraca wartość `TRUE` lub `FALSE` w zależności od operatora. Przykład użycia: `dateTime < dateTime('2017-03-22T13:39:44')`.
`device.language`	`in [...]`	Zwraca wartość `TRUE`, jeśli którykolwiek z języków aplikacji pasuje do języka na liście. Przykład użycia: `device.language in ['en-UK', 'en-US']`.
`device.os`	`==`, `!=`	Zwraca `TRUE`, jeśli system operacyjny urządzenia porównuje do wartości w tym polu, która pasuje do operatora.
`percent`	`<=`, `>`, `between`	Zwraca `TRUE`, jeśli wartość w polu `percent` jest porównywana z wartością przypisaną losowo, która pasuje do operatora. Możesz podać wartość początkową, aby wybrać nową losowo przypisaną grupę instancji aplikacji dla danego zakresu procentowego, jak opisano w sekcji Typy reguł warunków. Aby to zrobić, przed operatorem podaj nazwę nasienia, jak w tym przykładzie: percent('keyName') <= 10 Aby skonfigurować określony zakres, możesz użyć operatora `between`. Aby skonfigurować zakres użytkowników od 20 do 60, używając wartości domyślnej: percent between 20 and 60 Aby skonfigurować zakres użytkowników od 60 do 80 z użyciem niestandardowego ziarna: percent('seedName') between 60 and 80