Google est engagé à faire progresser l'équité raciale pour les communautés noires. Regarde comment.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

Paramètres et conditions de configuration à distance

Lorsque vous utilisez la console Firebase ou les API back - end Config à distance , vous définissez un ou plusieurs paramètres (paires clé-valeur) et de fournir des valeurs par défaut dans-application pour ces paramètres. Vous pouvez remplacer les valeurs par défaut en application en sélectionnant des valeurs de paramètres côté serveur. Touches de paramètres et les valeurs des paramètres sont des chaînes, mais les valeurs des paramètres peuvent être exprimés que d'autres types de données lorsque vous utilisez ces valeurs dans votre application.

Utilisation de la console Firebase ou l' API à distance Config REST , vous pouvez créer de nouvelles valeurs par défaut pour vos paramètres, ainsi que des valeurs conditionnelles qui sont utilisées pour les groupes cibles des instances d'application. Chaque fois que vous mettez à jour votre configuration dans la console theFirebase, Firebase crée et publie une nouvelle version de votre modèle de configuration à distance. La version précédente est stockée, vous permettant de récupérer ou rollback au besoin. Ces opérations sont également disponibles via l'API REST.

Ce guide explique les paramètres, les conditions, les règles, les valeurs conditionnelles, et comment les différentes valeurs des paramètres sont prioritaires sur la télécommande Config Server et dans votre application. Il fournit également des détails sur les types de règles utilisées pour créer des conditions.

Conditions, règles et valeurs conditionnelles

Une condition est utilisée pour cibler un groupe d'instances de l'application. Les conditions sont composées d'une ou plusieurs règles qui doivent tous être évalués à true pour la condition d'évaluer à true pour une instance d'application donnée. Si la valeur d'une règle est définie (par exemple, si aucune valeur est disponible), cette règle va évaluer à false .

Par exemple, un paramètre qui définit la page de démarrage d'une application peut afficher des images différentes en fonction du type OS en utilisant la règle simple if device_os = Android :

Ou, une condition de temps pourrait être utilisé pour contrôler quand votre application affiche des articles promotionnels spéciaux.

Un paramètre peut avoir plusieurs valeurs conditionnelles qui utilisent des conditions différentes, et les paramètres peuvent partager des conditions dans un projet.

Priorité valeur Paramètre

Un paramètre peut avoir plusieurs valeurs conditionnelles qui y sont associées. Les règles suivantes déterminent quelle valeur est extraite de la distance Config serveur, et dont la valeur est utilisée dans une instance d'application donnée à un moment donné dans le temps:

Les valeurs des paramètres côté serveur sont récupérés en fonction de la liste des priorités suivantes

  1. Tout d' abord, les valeurs conditionnelles sont appliquées, le cas échéant ont des conditions qui donnent des true pour une instance d'application donnée. Si plusieurs conditions sont évaluées à true , le premier ( en haut) , on montre dans l'interface utilisateur console Firebase a la priorité, et les valeurs conditionnelles associées à cette condition sont fournis lorsqu'une application va chercher les valeurs du back - end. Vous pouvez modifier la priorité des conditions par glisser-déposer des conditions dans l'onglet Conditions.

  2. S'il n'y a pas de valeurs conditionnelles avec des conditions qui évaluent à true , la valeur par défaut côté serveur est fourni lorsqu'une application va chercher les valeurs du back - end. Si un paramètre n'existe pas dans le backend, ou si la valeur par défaut est définie à la valeur Non, aucune valeur est fournie pour ce paramètre quand une application va chercher des valeurs.

Dans votre application, les valeurs des paramètres sont renvoyées par get méthodes en fonction de la liste des priorités suivantes

  1. Si une valeur a été récupérée à partir du back-end puis activé, l'application utilise la valeur récupérée. Les valeurs des paramètres activés sont persistants.
  2. Si aucune valeur a été extraite du backend, ou si les valeurs extraites de la n'a pas été activée back-end Config à distance, l'application utilise l'application en valeur par défaut.
  3. Si l'application n'utilise en application valeur par défaut a été définie, une valeur de type statique (comme 0 pour int et false pour boolean ).

Ce graphique résume la façon dont les valeurs des paramètres sont prioritaires dans le back-end de configuration à distance, et dans votre application:

Groupes de paramètres

Config à distance vous permet de paramètres de groupe ensemble pour un modèle interface utilisateur et mentale plus organisée.

Par exemple, disons que vous devez activer ou désactiver les trois différents types de auth tout en déployant une nouvelle fonctionnalité de connexion. Avec Config à distance, vous pouvez créer les trois paramètres pour permettre aux types comme vous le souhaitez, puis de les organiser dans un groupe nommé « Nouvelle connexion », sans avoir besoin d'ajouter des préfixes ou tri spécial.

Vous pouvez créer des groupes de paramètres à l'aide de la console Firebase ou de l'API à distance Config REST. Chaque groupe de paramètres vous créez un nom unique dans votre modèle de configuration à distance. Lors de la création de groupes de paramètres, garder à l'esprit:

  • Les paramètres peuvent être inclus dans un seul groupe à tout moment, et une clé de paramètre doit toujours être unique dans tous les paramètres.
  • Les noms des groupes de paramètres sont limités à 256 caractères.
  • Si vous utilisez à la fois l'API REST et la console Firebase, assurez-vous que toute la logique de l'API REST est mis à jour à des groupes de paramètres de poignée publier.

Créer ou modifier des groupes de paramètres en utilisant la console Firebase

Vous pouvez les paramètres du groupe dans le Paramètres onglet de la console Firebase. Pour créer ou modifier un groupe:

  1. Sélectionnez Gérer les groupes.
  2. Cochez les cases pour les paramètres que vous souhaitez ajouter et sélectionnez Déplacer vers le groupe.
  3. Sélectionnez un groupe existant ou créer un nouveau groupe en entrant un nom et une description, et en sélectionnant Créer un nouveau groupe. Après avoir enregistré un groupe, il est disponible à publier en utilisant le bouton Publish change.

Créer des groupes programme

L' API à distance Config REST fournit un moyen automatisé pour créer et publier des groupes de paramètres. En supposant que vous êtes familier avec REST et sont mis en place pour autoriser les demandes à l'API, vous pouvez effectuer ces étapes pour gérer les groupes programme:

  1. Récupérer le modèle en cours
  2. Ajouter des objets JSON pour représenter vos groupes de paramètres
  3. Publier les groupes de paramètres en utilisant une demande HTTP PUT.

Le parameterGroups objet contient des clés du groupe, avec une description imbriquée et la liste des paramètres regroupés. Notez que chaque touche de groupe doit être unique au monde.

Par exemple, voici un extrait d'une révision du modèle qui ajoute le groupe de paramètres « nouveau menu » avec un seul paramètre, 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."
        }
      }
    }
  }
}

types de règles Condition

Les types de règles suivants sont pris en charge dans la console Firebase. Une fonctionnalité équivalente est disponible dans l'API à distance Config REST, comme indiqué dans la référence de l' expression conditionnelle .

Type de règle Les opérateurs) Valeurs) Remarque
App == Choisissez parmi une liste d'ID App pour les applications associées à votre projet Firebase. Lorsque vous ajoutez une application à Firebase, vous entrez dans un paquet iOS nom du package ID ou Android qui définit un attribut qui est exposé comme ID d' application dans les règles Config à distance.

Utilisez cet attribut comme suit:
  • Pour iOS: utilisation de l'application CFBundleIdentifier . Vous pouvez trouver le Bundle Identifier dans l'onglet Général pour cible principale dans Xcode de votre application.
  • Pour Android: Utiliser de l'application applicationId . Vous pouvez trouver le applicationId dans votre niveau d'application build.gradle fichier.
Version de l'application Pour les valeurs de chaîne:
correspond exactement,
contient,
ne contient pas,
expression régulière

Pour les valeurs numériques:
=, ≠,>, ≥, <, ≤
Entrez une valeur pour spécifier une version spécifique (ou versions connexes) de votre application. Avant d' utiliser cette règle, vous devez utiliser une règle ID App pour sélectionner une application Android qui est associée à votre projet Firebase. Cet opérateur est disponible pour les applications Android seulement, et correspond à l'application Version nom. Les comparaisons de chaînes pour cette règle sont sensibles à la casse.

Lorsque vous utilisez les exactement matchs, contient, ne contient pas, ou opérateur d'expression régulière, vous pouvez sélectionner plusieurs valeurs.

Lorsque vous utilisez l'opérateur d'expression régulière, vous pouvez créer des expressions régulières dans RE2 format. Votre expression régulière peut correspondre à tout ou partie de la chaîne de version cible. Vous pouvez également utiliser les ^ et $ ancres pour correspondre au début, à la fin, ou totalité d'une chaîne cible.

Numéro de construction Pour les valeurs de chaîne:
correspond exactement,
contient,
ne contient pas,
expression régulière

Pour les valeurs numériques:
=, ≠,>, ≥, <, ≤
Entrez une valeur pour spécifier une version spécifique (ou versions connexes) de votre application. Avant d' utiliser cette règle, vous devez utiliser une règle ID App pour sélectionner une application iOS qui est associé à votre projet Firebase. Cet opérateur est disponible pour les applications iOS uniquement, et correspond à l'application de CFBundleVersion . Les comparaisons de chaînes pour cette règle sont sensibles à la casse.

Lorsque vous utilisez les exactement matchs, contient, ne contient pas, ou opérateur d'expression régulière, vous pouvez sélectionner plusieurs valeurs.

Lorsque vous utilisez l'opérateur d'expression régulière, vous pouvez créer des expressions régulières dans RE2 format. Votre expression régulière peut correspondre à tout ou partie de la chaîne de version cible. Vous pouvez également utiliser les ^ et $ ancres pour correspondre au début, à la fin, ou totalité d'une chaîne cible.

Type OS == iOS
Android
Date / Heure <=,> Une date et une heure, soit dans le fuseau horaire de l'appareil ou un fuseau horaire spécifié, tel que « (GMT + 11) heure de Sydney. » Compares l'heure actuelle à l'appareil le temps chercher.
Utilisateur dans percentile aléatoire <=,> 0-100

Utilisez ce champ pour appliquer un changement à un échantillon aléatoire d'instances d'applications (avec la taille des échantillons aussi petits que .0001%), en utilisant le <= et> les opérateurs à segmenter les utilisateurs (instances d'applications) en groupes.

Chaque instance d'application est constamment mis en correspondance avec un nombre entier ou d'une fraction aléatoire, selon une clé définie dans ce projet. Une règle utilisera la clé par défaut (présentée comme DEF dans la console Firebase) sauf si vous sélectionnez ou créer une autre clé. Vous pouvez retourner une règle à l' aide de la clé par défaut en effaçant les utilisateurs Randomize en utilisant ce domaine clé. Vous pouvez utiliser une seule clé dans les règles pour traiter systématiquement les mêmes instances d'application dans les fourchettes de pourcentage donné. Ou, vous pouvez sélectionner un nouveau groupe attribué au hasard des instances d'application pour une plage de pourcentage donné en créant une nouvelle clé.

Par exemple, pour créer deux conditions connexes que chaque appliquent à 5% des utilisateurs d'une application non-chevauchement, vous pourriez avoir une condition comprennent un <= règle des 5%, et une autre condition comprennent à la fois une> règle des 5% et <= règle des 10%. Pour permettre à certains utilisateurs apparaissent de façon aléatoire dans les deux groupes, utiliser des clés différentes pour les règles dans chaque condition.

L'utilisateur en audience == Sélectionnez un ou plusieurs d'une liste des publics Google Analytics que vous avez mis en place pour votre projet.

Cette règle exige une règle ID App pour sélectionner une application associée à votre projet Firebase.

Note: Parce que beaucoup Analytics publics sont définis par des événements ou des propriétés de l' utilisateur, qui peuvent être basées les actions des utilisateurs de l' application, il peut prendre un certain temps pour un utilisateur en règle d'audience pour prendre effet pour une instance d'application donnée.

Dispositif région / pays == Sélectionnez une ou plusieurs régions ou pays. Cette règle est évaluée à true pour une instance d'application donnée si l'instance est dans l' une des régions ou des pays énumérés. Le code de pays de l'appareil est déterminée en utilisant l'adresse IP de l'appareil dans la demande ou le code du pays déterminé par Firebase Analytics (si les données sont partagées avec Analytics Firebase).
Langue du terminal == Sélectionnez une ou plusieurs langues. Cette règle est évaluée à true pour une instance d'application donnée si cette instance d'application est installée sur un appareil qui utilise l' une des langues énumérées.
propriété de l'utilisateur Pour les valeurs de chaîne:
contient,
ne contient pas,
correspond exactement,
expression régulière

Pour les valeurs numériques:
=, ≠,>, ≥, <, ≤

Remarque: Le client, vous ne pouvez définir que les valeurs de chaîne pour les propriétés de l'utilisateur. Pour connaître les conditions qui utilisent les opérateurs numériques, Config à distance convertit la valeur de la propriété de l'utilisateur correspondant dans un entier / flottant.
Choisissez parmi une liste de propriétés utilisateur disponibles Google Analytics. Pour savoir comment vous pouvez utiliser les propriétés de l' utilisateur pour personnaliser votre application pour des segments très spécifiques de votre base d'utilisateurs, voir les propriétés à distance Config et de l' utilisateur .

Pour en savoir plus sur les propriétés de l'utilisateur, consultez les guides suivants:

Lorsque vous utilisez les exactement matchs, contient, ne contient pas ou opérateur d'expression régulière, vous pouvez sélectionner plusieurs valeurs.

Lorsque vous utilisez l'opérateur d'expression régulière, vous pouvez créer des expressions régulières dans RE2 format. Votre expression régulière peut correspondre à tout ou partie de la chaîne de version cible. Vous pouvez également utiliser les ^ et $ ancres pour correspondre au début, à la fin, ou totalité d'une chaîne cible.

Remarque: les propriétés utilisateur collectées automatiquement ne sont pas actuellement disponibles lors de la création des conditions Config à distance.

les paramètres et les conditions de recherche

Vous pouvez rechercher votre touches de paramètres du projet, les valeurs des paramètres et des conditions de la console Firebase en utilisant la boîte de recherche en haut de l'onglet Paramètres à distance Config.

Les limites des paramètres et conditions

Au sein d'un projet Firebase, vous pouvez avoir jusqu'à 2000 paramètres, et jusqu'à 500 conditions. Paramètre Les clés peuvent être jusqu'à 256 caractères de long, doit commencer par un caractère underscore ou lettre en anglais (AZ, az), et peut également inclure les numéros. La longueur totale des chaînes de valeur de paramètre dans un projet ne peut pas dépasser 800.000 caractères.

Prochaines étapes

Pour commencer la configuration de votre projet Firebase, voir Mise en place d' un projet à distance Firebase Config .