FB4D

FB4D - Firebase的OpenSource跨平台庫

Google Firebase Cloud數據庫用於全球許多移動和Web應用程序中，並且有許多語言和平台有據可查的庫。對於Delphi，跨平台庫FB4D支持Firestore數據庫， Firebase實時數據庫， Firebase存儲（用於文件存儲）， Firebase功能（用於調用服務器功能）和Vision ML 。對於身份驗證， FB4D當前支持電子郵件/密碼身份驗證和匿名登錄。

該庫構建在Firebase REST-API上，並提供所有功能，並使用GUI應用程序，服務和背景線程中使用的同步和異步方法。支持兩個框架VCL和FireMonKey 。該庫是一個純淨的源代碼庫，依賴類接口。對於清潔和短應用代碼，它支持流利的接口設計。

Wiki

該項目提供了Wiki。七個基於FiremonKey和三個VCL示例應用程序以及在Wiki上啟動的七個跨平台示例應用程序將幫助您開始使用庫。有關更詳細的問題，接口參考將提供您需要的答案。

您可以在以下YouTube頻道上找到更多學習視頻。

主要更改日誌

本日誌將接口更改和重要的庫增強介紹，這些更改需要該庫用戶的注意。

• 2024年10月： Geminiai服務添加了Demofb4d應用中的一個新標籤，演示了功能。
• 2024年8月： DeMofB4D應用程序的重構和許多改進；
• 2024年6月：添加TotdMapperOptions來控制對象映射器的行為。簡單的FMX演示應用程序FSOBJ2DOC演示了對象映射映射器，並已添加到FB4D樣本項目組中。添加ifirestoreWritEtransaction.transformDoc ，以進行setServertime，增量，最大值，最小值；
• 2024年2月：遷移到Delphi Athene；
• 2023年12月：記錄映射器的對象使您可以通過從tfirestoredocument派生自己的類並添加成員變量來快速將Pascal對象同步到Firestore數據庫。所有成員變量均自動寫入文檔並從文檔中讀取。樣本應用FSOBJ2DOC演示了功能。
• 2023年10月：Firestore數據庫寫入交易也支持刪除文檔。 Auth_SelfReg_vcl演示應用程序說明了自我註冊工作流的所有選項；
• 2023年6月：Firestore數據庫支持寫入交易；
• 2022年10月：添加了ML視覺服務的接口；
• 2021年4月：修訂後的RT DB聽眾；
• 2021年3月：新的可選緩存，以加速對存儲對象的重複訪問。其他ifirebasestorage.getanddownload方法，以簡化存儲的下載。查看更多詳細信息
  在註冊新用戶時，在FB4D.SelfRegistrationFra框架中進行了新的選項。查看更多詳細信息
  實時數據庫創建已在Firebase控制台內發生了變化。 Firebase ID不再足以訪問新創建的RT DB。現在需要firebase URL，還可以包括服務器位置。查看更多詳細信息。
  一個新的偵聽器檢測到Firestore數據庫中的變化而無需合併。查看更多詳細信息。

先決條件

為Delphi 12.2雅典開發並準備了樣本項目。

？該庫至少需要Delphi 10.3 Rio Update 2 ？ 。

提示：自2021年3月引入Firestore聽眾以來，Delphi 10西雅圖到Delphi 10.2東京的支持已停產。 Delphi10.3更新1和更早版本不再支持RTL中的問題。

Delphi是Embarcadero Technologies，Inc。的註冊商標。

支持的平台

FB4D是在純對象Pascal中開發的，可以在所有受支持平台上與Firemonkey一起使用。目前，使用FMXlinux，IOS64和Android對WIN64/WIN32，MAC64/32，Linux64進行了測試，該圖書館及其示例項目目前進行了測試。 （提示移動平台：執行令牌驗證的TokenJWT需要安裝OpenSSL庫）。有關使用OpenSSL的更多信息，請參見OpenSSL的安裝

Windows的提示

在Demofb4d應用程序中，Edge Web瀏覽器用於將標記顯示為HTML和PDF。為此，有必要安裝WebView2 SDK或至少將WebView2loader.dll複製到可執行的目錄中。在Embarcadero的Wiki上閱讀有關WebView2和Twebbrowser的更多信息。此升級僅在Win32和Win64下才有必要。

Android for VisionMl的限制

AntotateFile僅限於PDF，因為GIF支持由於RSP-17682而無效，並且尚未支持TIF圖像格式。

iOS的限制for VisionMl

AnnotateFile僅限於PDF，因為fmx.graphics尚未支持GIF和TIF圖像格式。您不能將TBITMAP轉換為帶有標準庫的VisionML所需的圖像格式之一。

Linux64的限制

使用Delphi 11 Alexandria或更高版本時，沒有限制。

對於較舊的版本，最高為10.4.2，您必須注意以下RSP：由於Linux RTL中的錯誤，所有HTTP請求都使用補丁方法不起作用將數據傳輸到服務器的所有HTTP請求。放置和發布方法工作。這會影響實時DB方法補丁和用於同步和異步訪問的Firestore方法插入圖表。有關更多信息，請參見RSP-33177。

子模型

有關路徑變化的重要說明：自從引入Gemini AI（v1.6.5.631）以來，該文件夾將jose移至subpodules/delphi-jose-jwt，因為添加了附加的subpodule delphi-markup。 Git Pull之後，請使用git bash命令git submodule update --remote --merge更新兩個子模型，或使用您喜歡的GIT工具進行此更新。

delphi-jose-jwt

為了授權令牌驗證和令牌內容提取，該庫使用Delphi Jose JWT庫。謝謝，保羅·羅西（Paolo Rossi），您的圖書館很棒！

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

Delphi-Markdown

為了將Markdown格式化文本轉換為HTML，此庫使用Delphi Markdown庫。謝謝，格雷厄姆（Grahame）為這個很棒的圖書館而感到悲傷！

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