FB4D

FB4D - La bibliothèque optimale OpenSource pour Firebase

La base de données Cloud Google Firebase est utilisée dans de nombreuses applications mobiles et Web dans le monde et il existe des bibliothèques bien documentées pour de nombreuses langues et plateformes. Pour Delphi, la bibliothèque multiplateforme FB4D prend en charge la base de données Firestore , la base de données Firebase Realtime , le stockage de la base de feu (pour le stockage de fichiers), les fonctions Firebase (pour l'appel des fonctions du serveur) et la vision ML . Pour l'authentification, FB4D prend actuellement en charge l'authentification par e-mail / mot de passe et la connexion anonyme.

La bibliothèque s'appuie sur le Firebase Rest-API et fournit toutes les fonctionnalités avec des méthodes synchrones et asynchrones pour l'utilisation dans l'application, les services et les threads d'arrière-plan de l'interface graphique. Les frameworks VCL et FiremonKey sont pris en charge. La bibliothèque est une bibliothèque de code source pure et s'appuie sur les interfaces de classe. Pour le code d'application propre et court, il prend en charge la conception de l'interface fluide.

Wiki

Ce projet offre un wiki. Sept applications d'exemples croisées basées sur FiremonKey et trois applications d'échantillons VCL et un démarrage sur le wiki vous aideront à commencer à travailler avec la bibliothèque. Pour des questions plus détaillées, la référence de l'interface fournira les réponses dont vous avez besoin.

Vous pouvez trouver plus de vidéos d'apprentissage sur la chaîne YouTube suivante.

Journal de changement majeur

Ce journal s'informe sur les modifications de l'interface et les améliorations importantes de la bibliothèque qui nécessitent l'attention des utilisateurs de cette bibliothèque.

• Octobre 2024: Service Geminiai ajouté, un nouvel onglet dans l'application Demofb4d démontre la fonctionnalité;
• Août 2024: refactoring et de nombreuses améliorations de l'application Demofb4d ;
• Juin 2024: Ajout de TotDmapperOptions pour contrôler le comportement du mappeur objet-dooc. La simple application de démonstration FMX FSOBJ2DOC démontre le mappeur d'objet à document et a été ajoutée au groupe de projet FB4D Samples. Ajouter IFirestoreWriteTransAction.TransformDoc pour SetServerTime, Incrément, maximum, minimum;
• Février 2024: Migrez vers Delphi Athene;
• Décembre 2023: L'objet de document de document vous permet de synchroniser rapidement vos objets Pascal avec la base de données Firestore en dérivant votre propre classe de TFirestoreDocument et en ajoutant des variables membre. Toutes les variables membres sont automatiquement écrites dans le document et lues à partir du document. L'exemple d'application FSOBJ2DOC démontre la fonctionnalité;
• Octobre 2023: La transaction d'écriture de la base de données Firestore prend également en charge le document Supprimer. L'application de démonstration AUTH_SELOLDREG_VCL explique toutes les options du flux de travail d'auto-enregistrement;
• Juin 2023: la base de données Firestore prend en charge les transactions d'écriture;
• Octobre 2022: Interface pour ML Vision Service ajouté;
• Avril 2021: Écouteur RT DB révisé;
• Mars 2021: Nouveau cache facultatif pour accélérer l'accès répété aux objets de stockage. Méthode supplémentaire ifireBasestorage.getandDownload afin de simplifier le téléchargement à partir du stockage. Voir plus de détails
  Nouvelle option dans FB4D.SelfRegistrationFRA Framework pour prendre en charge ENTER le nom d'affichage et télécharger l'image du profil lors de l'enregistrement d'un nouvel utilisateur. Voir plus de détails
  La création de la base de données en temps réel a changé dans la console Firebase. L'ID Firebase n'est plus suffisant pour accéder à RT DBS nouvellement créé. Une URL de base de feu est désormais requise, qui peut également inclure l'emplacement du serveur. Voir plus de détails.
  Un nouvel auditeur détecte les modifications dans la base de données Firestore sans mise en commun. Voir plus de détails.

Condition préalable

Les échantillons de projets sont développés et préparés pour Delphi 12.2 Athènes .

? Cette bibliothèque nécessite au moins Delphi 10.3 Rio Update 2 ?.

Astuce: le support de Delphi 10 Seattle à Delphi 10.2 Tokyo a été interrompu depuis l'introduction de l'auditeur de Firestore en mars 2021. Delphi 10.3 La mise à jour 1 et la version antérieure ne sont plus prises en charge en raison d'un problème dans le RTL.

Delphi est une marque déposée d'Embarcadero Technologies, Inc.

Plates-formes prises en charge

FB4D est développé dans Pure Object Pascal et peut être utilisé avec FiremonKey sur toutes les plates-formes prises en charge. La bibliothèque et ses exemples de projets sont actuellement testés avec Win64 / Win32, Mac64 / 32, Linux64 en utilisant FMXLINUX, IOS64 et Android. (Astuce sur les plates-formes mobiles: le tokenjwt pour effectuer la vérification du jeton nécessite l'installation des bibliothèques OpenSSL). Pour plus d'informations sur l'utilisation d'OpenSSL, consultez l'installation d'OpenSSL

Conseils pour Windows

Dans l'application Demofb4d , le navigateur Web Edge est utilisé pour afficher Markdown comme HTML et PDF. Pour ce faire, il est nécessaire d'installer le SDK WebView2 ou au moins de copier le webView2Loader.dll dans votre répertoire exécutable. En savoir plus sur WebView2 et TwebBrowser sur le wiki d'Embarcadero. Cette mise à niveau n'est nécessaire que sous Win32 et Win64.

Limitation sur Android pour VisionML

AnnotateFile est limité à PDF uniquement, car le support GIF ne fonctionne pas en raison du RSP-17682, et le format d'image TIF n'est pas encore pris en charge.

Limitation sur iOS pour VisionML

AnnotateFile est limité à PDF uniquement, car le format d'image GIF et TIF n'est pas encore pris en charge par FMX.Graphics. Vous ne pouvez pas convertir un tbitmap en l'un des formats d'image requis par VisionML avec la bibliothèque standard.

Limitation de Linux64

Il n'y a aucune restriction lors de l'utilisation de Delphi 11 Alexandrie ou plus.

Pour les anciennes versions jusqu'à 10.4.2, vous devez noter le RSP suivant: En raison d'un bogue dans le Linux RTL, toutes les demandes HTTP qui transfèrent les données vers le serveur en utilisant la méthode Patch ne fonctionnent pas. Mettre et publier des méthodes fonctionnent. Cela affecte le correctif de la méthode DB en temps réel et la méthode Firestore INSERTORUPDADADECUMENT pour les accès synchrones et asynchrones. Pour plus d'informations, voir RSP-33177.

Sous-modules

Remarque importante sur les changements de chemin: Depuis l'introduction de Gemini AI (V1.6.5.631), le dossier Jose est déplacé vers des sous-modules / Delphi-Jose-JWT car le sous-module supplémentaire Delphi-Markup a été ajouté. Après Git Pull, veuillez mettre à jour les deux sous-modules avec la git submodule update --remote --merge ou utilisez votre outil GIT préféré pour cette mise à jour.

Delphi-Jose-Jwt

Pour la vérification des jetons d'autorisation et l'extraction de contenu de jeton, cette bibliothèque utilise la bibliothèque Delphi Jose JWT. Merci, Paolo Rossi pour votre grande bibliothèque!

https://github.com/paolo-rossi/delphi-jose-jwt

Delphi-Markdown

Pour convertir le texte formaté Markdown en HTML, cette bibliothèque utilise la bibliothèque de Markdown Delphi. Merci, Grahame Grieve pour cette grande bibliothèque!

https://github.com/grahamegrieve/delphi-markdown