Si vous êtes un utilisateur Parse à la recherche d'un autre backend en tant qu'utilisateur Firebase peut être la solution idéale pour votre application iOS.
Ce guide explique comment intégrer des services spécifiques dans votre application. Pour instructions de configuration de base de Firebase, reportez-vous à la page de configuration d'iOS+ .
Google Analytics
Google Analytics est une solution de mesure des applications gratuite qui fournit des insights sur l'utilisation de l'application et l'engagement utilisateur. Analytics s'intègre aux fonctionnalités de Firebase et vous offre un accès illimité des rapports pour un maximum de 500 événements distincts que vous pouvez définir à l'aide du SDK Firebase.
Pour en savoir plus, consultez la documentation sur Google Analytics.
Stratégie de migration suggérée
L'utilisation de différents fournisseurs de solutions d'analyse est un scénario courant qui s'applique facilement Google Analytics Il vous suffit de l'ajouter à votre application pour bénéficier d'événements et de propriétés utilisateur Analytics collecte automatiquement des données comme la première ouverture, les mises à jour d'applis, le modèle de l'appareil et l'âge.
Pour les événements personnalisés et les propriétés utilisateur, vous pouvez appliquer une stratégie de double écriture à l'aide de analyser et Google Analytics pour consigner les événements et les propriétés, ce qui vous permet de : pour déployer progressivement la nouvelle solution.
Comparaison de code
Analyse des données analytiques
// Start collecting data
[PFAnalytics trackAppOpenedWithLaunchOptions:launchOptions];
NSDictionary *dimensions = @{
// Define ranges to bucket data points into meaningful segments
@"priceRange": @"1000-1500",
// Did the user filter the query?
@"source": @"craigslist",
// Do searches happen more often on weekdays or weekends?
@"dayType": @"weekday"
};
// Send the dimensions to Parse along with the 'search' event
[PFAnalytics trackEvent:@"search" dimensions:dimensions];
Google Analytics
// Obtain the AppMeasurement instance and start collecting data
[FIRApp configure];
// Send the event with your params
[FIRAnalytics logEventWithName:@"search" parameters:@{
// Define ranges to bucket data points into meaningful segments
@"priceRange": @"1000-1500",
// Did the user filter the query?
@"source": @"craigslist",
// Do searches happen more often on weekdays or weekends?
@"dayType": @"weekday"
}];
Firebase Realtime Database
Firebase Realtime Database est une base de données NoSQL hébergée dans le cloud. Les données sont stockées au format JSON synchronisées en temps réel à chaque client connecté.
Pour en savoir plus, consultez la documentation sur Firebase Realtime Database.
Différences avec les données analysées
Objets
Dans Parse, vous stockez un PFObject, ou une sous-classe de celui-ci, qui contient des paires clé-valeur de données compatibles avec le format JSON. Les données sont sans schéma, ce qui signifie que vous n'avez pas besoin de spécifier les clés existantes sur chaque PFObject.
Toutes les données Firebase Realtime Database sont stockées en tant qu'objets JSON, et il n'y a pas d'équivalent pour
PFObject; il suffit d'écrire dans les valeurs de l'arborescence JSON des types qui correspondent
aux types JSON disponibles.
Voici un exemple de la façon dont vous pouvez enregistrer les meilleurs scores d'un match.
Analyser
PFObject *gameScore = [PFObject objectWithClassName:@"GameScore"];
gameScore[@"score"] = @1337;
gameScore[@"playerName"] = @"Sean Plott";
gameScore[@"cheatMode"] = @NO;
[gameScore saveInBackgroundWithBlock:^(BOOL succeeded, NSError *error) {
if (succeeded) {
// The object has been saved.
} else {
// There was a problem, check error.description
}
}];
Firebase
// Create a reference to the database
FIRDatabaseReference *ref = [[FIRDatabase database] reference];
NSString *key = [[ref child:@"scores"] childByAutoId].key;
NSDictionary *score = @{@"score": @1337,
@"playerName": @"Sean Plott",
@"cheatMode": @NO};
[key setValue:score withCompletionBlock:^(NSError *error, FIRDatabaseReference *ref) {
if (error) {
// The object has been saved.
} else {
// There was a problem, check error.description
}
}];
Relations entre les données
Un PFObject peut avoir une relation avec un autre PFObject: n'importe quelle
peut utiliser d'autres objets comme valeurs.
Dans Firebase Realtime Database, les relations sont mieux exprimées à l'aide de structures de données plates qui divisent les données en chemins distincts, afin qu'elles puissent être téléchargées efficacement dans des appels distincts.
L'exemple suivant montre comment vous pouvez structurer la relation entre les messages d'une et leurs auteurs.
Analyser
// Create the author
PFObject *myAuthor = [PFObject objectWithClassName:@"Author"];
myAuthor[@"name"] = @"Grace Hopper";
myAuthor[@"birthDate"] = @"December 9, 1906";
myAuthor[@"nickname"] = @"Amazing Grace";
// Create the post
PFObject *myPost = [PFObject objectWithClassName:@"Post"];
myPost[@"title"] = @"Announcing COBOL, a New Programming Language";
// Add a relation between the Post and the Author
myPost[@"parent"] = myAuthor;
// This will save both myAuthor and myPost
[myPost saveInBackground];
Firebase
// Create a reference to the database
FIRDatabaseReference *ref = [[FIRDatabase database] reference];
// Create the author
NSString *myAuthorKey = @"ghopper";
NSDictionary *author = @{@"name": @"Grace Hopper",
@"birthDate": @"December 9, 1906",
@"nickname": @"Amazing Grace"};
// Save the author
[[ref child:myAuthorKey] setValue:author]
// Create and save the post
NSString *key = [[ref child:@"posts"] childByAutoId].key;
NSDictionary *post = @{@"author": myAuthorKey,
@"title": @"Announcing COBOL, a New Programming Language"};
[key setValue:post]
La disposition de données suivante en est le résultat.
{
// Info about the authors
"authors": {
"ghopper": {
"name": "Grace Hopper",
"date_of_birth": "December 9, 1906",
"nickname": "Amazing Grace"
},
...
},
// Info about the posts: the "author" fields contains the key for the author
"posts": {
"-JRHTHaIs-jNPLXOQivY": {
"author": "ghopper",
"title": "Announcing COBOL, a New Programming Language"
}
...
}
}Lire les données
Dans Parse, vous lisez des données en utilisant l'ID d'un objet Parse spécifique, ou
en exécutant des requêtes à l'aide de PFQuery.
Dans Firebase, vous récupérez des données en joignant un écouteur asynchrone à une référence de base de données. L'écouteur est déclenché une fois pour l'état initial des données et une fois lorsque les données changent. Vous n'avez donc pas besoin d'ajouter de code pour déterminer si les données ont changé.
Voici un exemple de la façon dont vous pouvez récupérer les scores d'un joueur particulier, en fonction de l'exemple présenté dans la section Objets.
Analyser
PFQuery *query = [PFQuery queryWithClassName:@"GameScore"];
[query whereKey:@"playerName" equalTo:@"Dan Stemkoski"];
[query findObjectsInBackgroundWithBlock:^(NSArray *objects, NSError *error) {
if (!error) {
for (PFObject *score in objects) {
NSString *gameScore = score[@"score"];
NSLog(@"Retrieved: %@", gameScore);
}
} else {
// Log details of the failure
NSLog(@"Error: %@ %@", error, [error userInfo]);
}
}];
Firebase
// Create a reference to the database
FIRDatabaseReference *ref = [[FIRDatabase database] reference];
// This type of listener is not one time, and you need to cancel it to stop
// receiving updates.
[[[[ref child:@"scores"] queryOrderedByChild:@"playerName"] queryEqualToValue:@"Dan Stemkoski"]
observeEventType:FIRDataEventTypeChildAdded withBlock:^(FIRDataSnapshot *snapshot) {
// This will fire for each matching child node.
NSDictionary *score = snapshot.value;
NSString gameScore = score[@"score"];
NSLog(@"Retrieved: %@", gameScore);
}];
Stratégie de migration suggérée
Repensez vos données
Le Firebase Realtime Database est optimisé pour synchroniser les données en quelques millisecondes sur toutes les et que la structure des données qui en résulte est différente de celle de l'analyse des données principales. Cela signifie que La première étape de votre migration consiste à réfléchir aux modifications requises par vos données, y compris:
- Comment mapper vos objets Parse sur les données Firebase
- Si vous avez des relations parent-enfant, comment répartir vos données sur différents chemins vous pouvez le télécharger dans des appels distincts.
Migration de vos données
Une fois que vous avez décidé de la structure de vos données dans Firebase, vous devez planifier la gestion de la période pendant laquelle votre application doit écrire dans les deux bases de données. Vous disposez des options suivantes :
Synchronisation en arrière-plan
Dans ce scénario, vous disposez de deux versions de l'application: l'ancienne qui utilise Parse et la nouvelle utilisant Firebase. Les synchronisations entre les deux bases de données sont gérées par Parse Cloud Code (Parse à Firebase), en écoutant votre code avec les modifications apportées sur Firebase et en les synchronisant avec Parse. Avant de pouvoir utiliser la nouvelle version, vous devez :
- Convertissez vos données Parse existantes en nouvelle structure Firebase, puis écrivez-les dans Firebase Realtime Database.
- Écrire des fonctions Cloud Code d'analyse qui utilisent l'API REST Firebase pour écrire dans le Modifications apportées à Firebase Realtime Database dans "Parse Data" (Analyser les données) par d'anciens clients.
- Rédiger et déployer du code qui écoute les modifications effectuées sur Firebase et les synchronise avec l'API Parse base de données.
Ce scénario garantit une séparation claire entre l'ancien et le nouveau code, et simplifie la tâche des clients. La les défis de ce scénario sont la gestion de grands ensembles de données lors de l'exportation initiale et la garantie que la synchronisation bidirectionnelle ne génère pas de récursion infinie.
Double écriture
Dans ce scénario, vous écrivez une nouvelle version de l'application qui utilise à la fois Firebase et Parse, à l'aide de la commande suivante : Analyser Cloud Code pour synchroniser les modifications apportées par d'anciens clients depuis "Parse Data" (Analyser les données) Firebase Realtime Database Lorsqu'un nombre suffisant d'utilisateurs est passé de la version "Analyse uniquement" de l'application, peut supprimer le code d'analyse de la version en double écriture.
Ce scénario ne nécessite aucun code côté serveur. L'inconvénient est que les données n'est pas migrée et que la taille de votre application est augmentée par l'utilisation des deux SDK.
Firebase Authentication
Firebase Authentication peut authentifier les utilisateurs à l'aide de mots de passe et de fournisseurs d'identité fédérés populaires tels que Google, Facebook et Twitter. Il fournit également des bibliothèques d'UI pour vous éviter nécessaire pour implémenter et gérer une expérience d'authentification complète pour votre application sur toutes les plates-formes.
Pour en savoir plus, consultez la documentation sur Firebase Authentication.
Différences avec Parse Auth
Parse fournit une classe d'utilisateur spécialisée appelée PFUser qui gère automatiquement
les fonctionnalités requises pour
la gestion des comptes utilisateur. PFUser est une sous-classe de
PFObject, ce qui signifie que les données utilisateur sont disponibles dans "Analyser les données" et peuvent être étendues avec
des champs supplémentaires comme n'importe quel autre PFObject.
Un FIRUser dispose d'un ensemble fixe de propriétés de base (un ID unique, une adresse e-mail principale, un nom et une URL de photo) stockées dans la base de données d'utilisateurs d'un projet distinct. Ces propriétés peuvent être modifiées par l'utilisateur. Vous ne pouvez pas ajouter directement d'autres propriétés à l'objet FIRUser.
À la place, vous pouvez stocker les propriétés supplémentaires dans Firebase Realtime Database.
L'exemple suivant montre comment vous pouvez inscrire un utilisateur et ajouter un champ de numéro de téléphone.
Analyser
PFUser *user = [PFUser user];
user.username = @"my name";
user.password = @"my pass";
user.email = @"email@example.com";
// other fields can be set just like with PFObject
user[@"phone"] = @"415-392-0202";
[user signUpInBackgroundWithBlock:^(BOOL succeeded, NSError *error) {
if (!error) {
// Hooray! Let them use the app now.
} else {
// Something went wrong
NSString *errorString = [error userInfo][@"error"];
}
}];
Firebase
[[FIRAuth auth] createUserWithEmail:@"email@example.com"
password:@"my pass"
completion:^(FIRUser *_Nullable user, NSError *_Nullable error) {
if (!error) {
FIRDatabaseReference *ref = [[FIRDatabase database] reference];
[[[[ref child:@"users"] child:user.uid] child:@"phone"] setValue:@"415-392-0202"
} else {
// Something went wrong
NSString *errorString = [error userInfo][@"error"];
}
}];
Stratégie de migration suggérée
Migrer les comptes
Pour migrer des comptes utilisateur de Parse vers Firebase, exportez votre base de données utilisateur vers
un fichier JSON ou CSV, puis importez-le dans votre projet Firebase à l'aide de la méthode
auth:import de la CLI Firebase
.
Commencez par exporter votre base de données d'utilisateurs depuis la console Parse ou votre système auto-hébergé base de données. Par exemple, un fichier JSON exporté depuis la console Parse peut avoir l'apparence suivante : comme suit:
{ // Username/password user "bcryptPassword": "$2a$10$OBp2hxB7TaYZgKyTiY48luawlTuYAU6BqzxJfpHoJMdZmjaF4HFh6", "email": "user@example.com", "username": "testuser", "objectId": "abcde1234", ... }, { // Facebook user "authData": { "facebook": { "access_token": "ABCDEFGHIJKLMNOPQRSTUVWXYZ", "expiration_date": "2017-01-02T03:04:05.006Z", "id": "1000000000" } }, "username": "wXyZ987654321StUv", "objectId": "fghij5678", ... }
Transformez ensuite le fichier exporté au format requis par la CLI Firebase. Utilisez l'objectId de vos utilisateurs Parse comme localId de vos utilisateurs Firebase. Vous pouvez aussi encoder en base64
Valeurs bcryptPassword issues de Parse et utilisez-les dans passwordHash
. Exemple :
{ "users": [ { "localId": "abcde1234", // Parse objectId "email": "user@example.com", "displayName": "testuser", "passwordHash": "JDJhJDEwJE9CcDJoeEI3VGFZWmdLeVRpWTQ4bHVhd2xUdVlBVTZCcXp4SmZwSG9KTWRabWphRjRIRmg2", }, { "localId": "fghij5678", // Parse objectId "displayName": "wXyZ987654321StUv", "providerUserInfo": [ { "providerId": "facebook.com", "rawId": "1000000000", // Facebook ID } ] } ] }
Enfin, importez le fichier transformé avec la CLI Firebase, en spécifiant bcrypt. que l'algorithme de hachage:
firebase auth:import account_file.json --hash-algo=BCRYPT
Migrer les données utilisateur
Si vous stockez des données supplémentaires pour vos utilisateurs, vous pouvez les migrer vers Firebase Realtime Database à l'aide des stratégies décrites dans la section Migration de données. Si vous migrez en suivant la procédure décrite dans la section Migration des comptes, Les comptes Firebase ont les mêmes identifiants que vos comptes Parse, ce qui vous permet de migrer et de reproduire facilement toute relation associée à l'identifiant de l'utilisateur.
Firebase Cloud Messaging
Firebase Cloud Messaging (FCM) est une solution de messagerie multiplate-forme qui vous permet envoyer des messages et des notifications sans frais. L'outil de création de notifications est un service sans frais conçu sur Firebase Cloud Messaging, qui permet aux développeurs d'applications mobiles d'envoyer des notifications ciblées aux utilisateurs.
Pour en savoir plus, consultez la documentation Firebase Cloud Messaging.
Différences avec l'analyse des notifications push
Chaque application Parse installée sur un appareil enregistré pour les notifications dispose d'un
Installation, dans lequel vous stockez toutes les données nécessaires pour cibler les notifications.
Installation est une sous-classe de PFUser, ce qui signifie que vous pouvez ajouter
toutes les données supplémentaires souhaitées sur vos instances Installation.
L'outil de création de notifications fournit des segments d'utilisateurs prédéfinis en fonction d'informations telles que l'application, la version de l'application et l'appareil. langue. Vous pouvez créer des segments d'utilisateurs plus complexes à l'aide des événements et propriétés Google Analytics pour créer des audiences. Voir les audiences pour en savoir plus. Ces informations de ciblage ne sont pas visibles dans le Firebase Realtime Database.
Stratégie de migration suggérée
Migrer des jetons d'appareil
Alors que Parse utilise des jetons d'appareil APN pour cibler les installations de notifications, FCM utilise des jetons d'enregistrement FCM mappés sur les jetons d'appareil APN. Ajoutez simplement FCM vers votre application Apple, qui récupérera automatiquement un jeton FCM.
Migration des chaînes vers FCM sujets
Si vous utilisez des canaux Parse pour envoyer des notifications, vous pouvez migrer vers des sujets FCM, qui fournissent le même modèle éditeur-abonné. Pour gérer la transition de Parse vers FCM, vous pouvez écrire une nouvelle version de l'application qui utilise le SDK Parse pour se désabonner des chaînes Parse et le SDK FCM pour s'abonner à les sujets FCM correspondants.
Par exemple, si votre utilisateur est abonné au groupe "Giants" vous ferez quelque chose comme:
PFInstallation *currentInstallation = [PFInstallation currentInstallation];
[currentInstallation removeObject:@"Giants" forKey:@"channels"];
[currentInstallation saveInBackgroundWithBlock:^(BOOL succeeded, NSError *error) {
if (succeeded) {
[[FIRMessaging messaging] subscribeToTopic:@"/topics/Giants"];
} else {
// Something went wrong unsubscribing
}
}];
Cette stratégie vous permet d'envoyer des messages à la fois au canal Parse et au canal FCM, pour aider les utilisateurs de l'ancienne et de la nouvelle version. Lorsque suffisamment d'utilisateurs ont migré depuis Vous pouvez arrêter la version de l'application analysée uniquement et commencer à l'envoyer à l'aide de FCM uniquement.
Consultez le Documentation sur FCM sujets pour en savoir plus.
Firebase Remote Config
Firebase Remote Config est un service cloud qui vous permet de modifier le comportement et l'apparence de votre application sans que les utilisateurs aient à télécharger une mise à jour. Lorsque vous utilisez Remote Config, vous créez des valeurs par défaut qui contrôlent le comportement et l'apparence de votre application. Vous pouvez ensuite utiliser console Firebase afin de remplacer les valeurs par défaut dans l'application pour tous les utilisateurs de l'application ou pour certains segments de votre base d'utilisateurs.
Firebase Remote Config peut être très utile lors de la migration si vous souhaitez tester différentes solutions et pouvoir transférer dynamiquement plus de clients vers un autre fournisseur. Par exemple, Si une version de votre application utilise à la fois Firebase et Parse pour les données, vous pouvez utiliser un de centile aléatoire afin de déterminer quels clients lisent des données depuis Firebase, puis augmentez progressivement le pourcentage.
Pour en savoir plus sur Firebase Remote Config, consultez les Remote Config
Différences avec la configuration d'analyse
Avec la configuration Parse, vous pouvez ajouter des paires clé/valeur à votre application dans le tableau de bord de configuration de l'analyse, puis
récupérer le PFConfig sur le client. Chaque instance PFConfig que vous
"get" est toujours immuable. Lorsque vous récupérez un nouveau PFConfig à partir du
réseau, il ne modifie aucune instance PFConfig existante, mais
créez-en une et rendez-la disponible via currentConfig.
Avec Firebase Remote Config, vous créez les valeurs par défaut dans l'application pour des paires clé/valeur que vous pouvez remplacer de la console Firebase, et vous pouvez utiliser des règles et des conditions pour proposer des variantes l'expérience utilisateur à différents segments de votre base d'utilisateurs. Firebase Remote Config implémente un singleton qui rend les paires clé/valeur disponibles pour votre application. Initialement, le singleton renvoie les valeurs par défaut que vous définissez dans l'application. Vous pouvez récupérer un nouvel ensemble de valeurs sur le serveur à tout le moment opportun pour votre application ; une fois le nouvel ensemble récupéré, vous pouvez choisir quand l'activer pour que les nouvelles valeurs soient disponibles pour l'application.
Stratégie de migration suggérée
Vous pouvez passer à Firebase Remote Config en copiant les paires clé/valeur de votre configuration Parse à la console Firebase, puis déployer une nouvelle version de l'application qui utilise Firebase Remote Config.
Si vous souhaitez tester à la fois Parse Config et Firebase Remote Config, vous pouvez déployer Une nouvelle version de l'application qui utilise les deux SDK jusqu'à ce qu'un nombre suffisant d'utilisateurs aient migré depuis la version "Analyse uniquement".
Comparaison de code
Analyser
[PFConfig getConfigInBackgroundWithBlock:^(PFConfig *config, NSError *error) {
if (!error) {
NSLog(@"Yay! Config was fetched from the server.");
} else {
NSLog(@"Failed to fetch. Using Cached Config.");
config = [PFConfig currentConfig];
}
NSString *welcomeMessage = config[@"welcomeMessage"];
if (!welcomeMessage) {
NSLog(@"Falling back to default message.");
welcomeMessage = @"Welcome!";
}
}];
Firebase
FIRRemoteConfig remoteConfig = [FIRRemoteConfig remoteConfig];
// Set defaults from a plist file
[remoteConfig setDefaultsFromPlistFileName:@"RemoteConfigDefaults"];
[remoteConfig fetchWithCompletionHandler:^(FIRRemoteConfigFetchStatus status, NSError *error) {
if (status == FIRRemoteConfigFetchStatusSuccess) {
NSLog(@"Yay! Config was fetched from the server.");
// Once the config is successfully fetched it must be activated before newly fetched
// values are returned.
[self.remoteConfig activateFetched];
} else {
NSLog(@"Failed to fetch. Using last fetched or default.");
}
}];
// ...
// When this is called, the value of the latest fetched and activated config is returned;
// if there's none, the default value is returned.
NSString welcomeMessage = remoteConfig[@"welcomeMessage"].stringValue;