FB4D

FB4D-Die OpenSource-plattformübergreifende Bibliothek für Firebase

Die Google FireBase Cloud-Datenbank wird in vielen mobilen und Webanwendungen weltweit verwendet und es gibt gut dokumentierte Bibliotheken für viele Sprachen und Plattformen. Für Delphi unterstützt die plattformübergreifende Bibliothek FB4D die Firestore-Datenbank , die Firebase Echtzeitdatenbank , den Firebase Storage (für Dateispeicher), Firebase-Funktionen (für Anrufserver-Funktionen) und Vision ML . Für die Authentifizierung unterstützt FB4D derzeit die E -Mail-/Kennwortauthentifizierung und eine anonyme Login.

Die Bibliothek baut auf dem Firebase Rest-API auf und bietet alle Funktionen synchrone und asynchrone Methoden für die Verwendung in GUI-Anwendungen, Diensten und Hintergrund-Threads. Sowohl Frameworks VCL als auch Fironemonkey werden unterstützt. Die Bibliothek ist eine reine Quellcode -Bibliothek und stützt sich auf Klassenschnittstellen. Für sauberes und kurzes Anwendungscode unterstützt es das fließende Schnittstellendesign.

Wiki

Dieses Projekt bietet ein Wiki. Sieben Cross-Plattform-Beispielanwendungen, die auf FireMonkey- und drei VCL-Beispielanwendungen basieren, und mit dem Wiki mit dem Starten des Wiki können Sie mit der Bibliothek beginnen. Für detailliertere Fragen liefert die Schnittstellenreferenz die benötigten Antworten.

Weitere Lernvideos finden Sie auf dem folgenden YouTube -Kanal.

Hauptwechselprotokoll

Dieses Protokoll informiert über Schnittstellenänderungen und wichtige Bibliotheksverbesserungen, die die Aufmerksamkeit der Benutzer dieser Bibliothek erfordern.

• Oktober 2024: Geminiai -Dienst hinzugefügt, zeigt eine neue Registerkarte in der DemofB4D -App die Funktionalität.
• August 2024: Refactoring und viele Verbesserungen der DemofB4D -App;
• Juni 2024: Hinzufügen von TotdMapperoptions , um das Verhalten des Object-to-Doc-Mapper zu steuern. Die einfache FMX-Demo-Anwendung FSOBJ2DOC demonstriert den Objekt-zu-Dokument-Mapper und wurde der Projektgruppe FB4D-Proben hinzugefügt. Hinzufügen von ifirestoreWritetransaction.transformDoc für SetServertime, Inkrement, maximal, minimal;
• Februar 2024: Migration nach Delphi Athene;
• Dezember 2023: Mit dem Objekt zum Dokument -Mapper können Sie Ihre Pascal -Objekte schnell in die Firestore -Datenbank synchronisieren, indem Sie Ihre eigene Klasse von TFirEnDoredocument abgeben und Mitgliedervariablen hinzufügen. Alle Mitgliedsvariablen werden automatisch in das Dokument geschrieben und aus dem Dokument gelesen. Die Probenanwendung FSOBJ2DOC zeigt die Funktionalität;
• Oktober 2023: Firestore -Datenbank -Transaktion unterstützt auch Dokument löschen. Die Demo -Anwendung auth_selfreg_vcl erklärt alle Optionen des Selbstregistrierungs -Workflows.
• Juni 2023: Die Firestore -Datenbank unterstützt Schreibtransaktionen;
• Oktober 2022: Schnittstelle für ML Vision Service hinzugefügt;
• April 2021: Überarbeiteter RT DB -Hörer;
• März 2021: Neuer optionaler Cache, um den wiederholten Zugriff auf Speicherobjekte zu beschleunigen. Zusätzliche iFirebasestorage.getandDownload -Methode Um den Download aus dem Speicher zu vereinfachen. Weitere Informationen finden Sie weiter
  Neue Option in FB4D.SelfregistrationFRA Framework zur Unterstützung des Anzeigenamens und hochladen Sie das Profilbild beim Registrieren eines neuen Benutzers. Weitere Informationen finden Sie weiter
  Die Erstellung der Datenbankdatenbank hat sich innerhalb der Firebase -Konsole geändert. Die Firebase -ID reicht nicht mehr aus, um auf neu erstellte RT -DBs zuzugreifen. Eine Firebase -URL ist jetzt erforderlich, die auch den Serverort enthalten kann. Weitere Informationen finden Sie weiter.
  Ein neuer Hörer erkennt Änderungen in der Firestore -Datenbank ohne Bündelung. Weitere Informationen finden Sie weiter.

Voraussetzungen

Die Stichprobenprojekte werden für Delphi 12.2 Athen entwickelt und vorbereitet.

? Diese Bibliothek erfordert mindestens Delphi 10.3 Rio Update 2 ?

Tipp: Die Unterstützung von Delphi 10 Seattle nach Delphi 10.2 Tokio wurde seit der Einführung des Firestore -Hörers im März 2021 eingestellt. Delphi 10.3 Update 1 und frühere Version werden aufgrund eines Problems in der RTL nicht mehr unterstützt.

Delphi ist eine eingetragene Marke von Embarcadero Technologies, Inc.

Unterstützte Plattformen

FB4D wird in reinem Objektpascal entwickelt und kann mit Fironemonkey auf allen unterstützten Plattformen verwendet werden. Die Bibliothek und ihre Beispielprojekte werden derzeit mit Win64/Win32, Mac64/32, Linux64 unter Verwendung von FMXLINUX, iOS64 und Android getestet. (Hinweis auf mobile Plattformen: Das Tokenjwt zur Durchführung der Token -Überprüfung erfordert die Installation der OpenSSL -Bibliotheken). Weitere Informationen zur Verwendung von OpenSSL finden Sie in der Installation von OpenSSL

Hinweise für Windows

In der DemoFB4D -App wird der Edge -Webbrowser verwendet, um Markdown als HTML und PDF anzuzeigen. Dazu ist es erforderlich, das WebView2 SDK zu installieren oder zumindest das webView2loader.dll in Ihr ausführbares Verzeichnis zu kopieren. Lesen Sie mehr über WebView2 und Twebbrowser auf Embarcaderos Wiki. Dieses Upgrade ist nur unter Win32 und Win64 erforderlich.

Einschränkung auf Android für VisionML

AnnotateFile ist nur auf PDF beschränkt, da die GIF-Unterstützung nicht aufgrund von RSP-17682 funktioniert und das TIF-Bildformat noch nicht unterstützt wird.

Einschränkung auf iOS für VisionML

AnnotateFile ist nur auf PDF beschränkt, da das GIF- und TIF -Bildformat noch nicht von FMX.Graphics unterstützt wird. Sie können eine TBitmap nicht in eines der von VisionML geforderten Bildformate mit der Standardbibliothek konvertieren.

Einschränkung auf Linux64

Es gibt keine Einschränkungen bei der Verwendung von Delphi 11 Alexandria oder höher.

Für ältere Versionen bis 10.4.2 müssen Sie den folgenden RSP beachten: Aufgrund eines Fehlers im Linux RTL funktioniert alle HTTP -Anfragen, die Daten mithilfe der Patch -Methode über die Verwendung der Patch -Methode übertragen werden. Put- und Post -Methoden funktionieren. Dies wirkt sich auf das Echtzeit -DB -Methode -Patch und das Firestore -Methode -InsertorUpdatedocument für synchronen und asynchronen Zugriffe aus. Weitere Informationen finden Sie unter RSP-33177.

Submodules

Wichtiger Hinweis zu Pfadänderungen: Seit Einführung von Gemini AI (V1.6.5.631) wird der Ordner Jose in Submodules/Delphi-Jose-JWT verschoben, da der zusätzliche Submodul-Delphi-Markup hinzugefügt wurde. Nach Git Pull aktualisieren Sie beide Submodules mit dem Git Bash -Befehl git submodule update --remote --merge oder verwenden Sie Ihr bevorzugtes Git -Tool für dieses Update.

Delphi-jose-jwt

Für die Autorisierungs -Token -Überprüfung und Token -Inhaltsextraktion verwendet diese Bibliothek die Delphi Jose JWT -Bibliothek. Vielen Dank, Paolo Rossi für Ihre großartige Bibliothek!

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

Delphi-Markdown

Zum Konvertieren von Text -formatiertem Text in HTML verwendet diese Bibliothek die Delphi -Markdown -Bibliothek. Danke, Grahame trauert um diese großartige Bibliothek!

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