FB4D

FB4D-Perpustakaan OpenSource Cross-Platform untuk Firebase

Database Google Firebase Cloud digunakan dalam banyak aplikasi seluler dan web di seluruh dunia dan ada perpustakaan yang terdokumentasi dengan baik untuk banyak bahasa dan platform. Untuk Delphi, perpustakaan lintas platform FB4D mendukung basis data Firestore , basis data Firebase Realtime , penyimpanan Firebase (untuk penyimpanan file), fungsi Firebase (untuk memanggil fungsi server), dan Vision ML . Untuk otentikasi, FB4D saat ini mendukung otentikasi email/kata sandi dan login anonim.

Perpustakaan dibangun di atas Firebase REST-API dan menyediakan semua fungsionalitas dengan metode sinkron dan asinkron untuk penggunaan dalam aplikasi GUI, layanan, dan utas latar belakang. Baik kerangka kerja VCL dan Firemonkey didukung. Perpustakaan adalah pustaka kode sumber murni dan bergantung pada antarmuka kelas. Untuk kode aplikasi yang bersih dan pendek mendukung desain antarmuka yang lancar.

Wiki

Proyek ini menawarkan wiki. Tujuh aplikasi contoh lintas platform berdasarkan firemonkey dan tiga aplikasi sampel VCL dan mulai di Wiki akan membantu Anda untuk mulai bekerja dengan perpustakaan. Untuk pertanyaan yang lebih rinci, referensi antarmuka akan memberikan jawaban yang Anda butuhkan.

Anda dapat menemukan lebih banyak video pembelajaran di saluran YouTube berikut.

Log Perubahan Utama

Log ini menginformasikan tentang perubahan antarmuka dan peningkatan perpustakaan penting yang membutuhkan perhatian pengguna perpustakaan ini.

• Oktober 2024: Layanan Geminiai Ditambahkan, tab baru di aplikasi DEMOFB4D menunjukkan fungsionalitas;
• Agustus 2024: refactoring dan banyak perbaikan dalam aplikasi DEMOFB4D ;
• Juni 2024: Menambahkan TotdMapperOptions untuk mengontrol perilaku mapper objek-ke-doc. Aplikasi demo FMX sederhana FSOBJ2DOC menunjukkan mapper objek-ke-dokumen dan telah ditambahkan ke grup proyek sampel FB4D. Tambahkan IfIrestorewRitetRansAction.TransformDoc untuk setServerTime, kenaikan, maksimum, minimum;
• Februari 2024: bermigrasi ke Delphi Athene;
• Desember 2023: Objek untuk mendokumentasikan Mapper memungkinkan Anda dengan cepat menyinkronkan objek Pascal Anda ke database Firestore dengan menurunkan kelas Anda sendiri dari TFireStoredocument dan menambahkan variabel anggota. Semua variabel anggota secara otomatis ditulis ke dokumen dan dibaca dari dokumen. Aplikasi Sampel FSOBJ2DOC menunjukkan fungsionalitas;
• Oktober 2023: Firestore Database Write Transaction juga mendukung dokumen DELETE. Aplikasi demo AUTH_SELFREG_VCL menjelaskan semua opsi alur kerja pendaftaran diri;
• Juni 2023: Firestore Database mendukung transaksi menulis;
• Oktober 2022: Antarmuka untuk Layanan Visi ML Ditambahkan;
• April 2021: pendengar RT DB yang direvisi;
• Maret 2021: Cache opsional baru untuk mempercepat akses berulang ke objek penyimpanan. Metode tambahan ifireBasestorage.getAndDownload untuk menyederhanakan unduhan dari penyimpanan. Lihat detail lebih lanjut
  Opsi baru di FB4D.SelfegistrationFra Framework untuk mendukung masukkan nama tampilan dan unggah gambar profil saat mendaftarkan pengguna baru. Lihat detail lebih lanjut
  Pembuatan database waktu nyata telah berubah dalam konsol Firebase. ID Firebase tidak lagi cukup untuk mengakses RT DBS yang baru dibuat. URL Firebase sekarang diperlukan, yang juga dapat mencakup lokasi server. Lihat detail lebih lanjut.
  Pendengar baru mendeteksi perubahan dalam database Firestore tanpa mengumpulkan. Lihat detail lebih lanjut.

Prasyarat

Proyek sampel dikembangkan dan disiapkan untuk Delphi 12.2 Athena .

? Perpustakaan ini membutuhkan setidaknya Delphi 10.3 Rio Update 2 ?.

Petunjuk: Dukungan dari Delphi 10 Seattle ke Delphi 10.2 Tokyo telah dihentikan sejak diperkenalkannya pendengar Firestore pada Maret 2021. Delphi 10.3 UPDATE 1 dan versi sebelumnya tidak lagi didukung karena masalah di RTL.

Delphi adalah merek dagang terdaftar dari Embarcadero Technologies, Inc.

Platform yang didukung

FB4D dikembangkan di Pure Object Pascal dan dapat digunakan dengan firemonkey pada semua platform yang didukung. Perpustakaan dan proyek sampelnya saat ini diuji dengan Win64/Win32, Mac64/32, Linux64 dengan menggunakan FMXLinux, IOS64 dan Android. (Petunjuk ke platform seluler: TokenJWT untuk melakukan verifikasi token memerlukan pemasangan pustaka OpenSSL). Untuk informasi lebih lanjut tentang penggunaan OpenSSL, lihat pemasangan OpenSSL

Petunjuk untuk Windows

Di aplikasi DEMOFB4D , Browser Web Edge digunakan untuk menampilkan Markdown sebagai HTML dan PDF. Untuk melakukan ini, perlu menginstal WebView2 SDK atau setidaknya salin WebView2Loader.dll ke direktori yang dapat dieksekusi Anda. Baca lebih lanjut tentang WebView2 dan Twebbrowser di Wiki Embarcadero. Peningkatan ini hanya diperlukan di bawah Win32 dan Win64.

Batasan pada Android untuk VisionML

AnnotateFile hanya terbatas pada PDF, karena dukungan GIF tidak berfungsi karena RSP-17682, dan format gambar TIF belum didukung.

Batasan pada iOS untuk visionml

AnnotateFile hanya terbatas pada PDF, karena format gambar GIF dan TIF belum didukung oleh FMX.Graphics. Anda tidak dapat mengonversi tbitmap ke salah satu format gambar yang diperlukan oleh VisionML dengan pustaka standar.

Batasan pada Linux64

Tidak ada batasan saat menggunakan Delphi 11 Alexandria atau lebih tinggi.

Untuk versi yang lebih lama hingga 10.4.2, Anda harus mencatat RSP berikut: karena bug di Linux RTL, semua permintaan HTTP yang mentransfer data ke server dengan menggunakan metode patch tidak berfungsi. Metode put dan pasca bekerja. Ini mempengaruhi tambalan metode DB realtime dan metode insertorupdatedocument metode firestore untuk akses sinkron dan asinkron. Untuk informasi lebih lanjut, lihat RSP-33177.

Submodules

Catatan penting tentang perubahan jalur: Sejak diperkenalkannya Gemini AI (v1.6.5.631) Folder Jose dipindahkan ke submodules/Delphi-Jose-JWT karena submodule tambahan Delphi-Markup ditambahkan. Setelah Git Pull Harap perbarui kedua submodule dengan Git Bash Command git submodule update --remote --merge atau gunakan alat git favorit Anda untuk pembaruan ini.

Delphi-jose-jwt

Untuk verifikasi token otorisasi dan ekstraksi konten token perpustakaan ini menggunakan perpustakaan Delphi Jose JWT. Terima kasih, Paolo Rossi untuk perpustakaan Anda yang hebat!

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

Delphi-Markdown

Untuk mengonversi teks yang diformat penurunan harga menjadi HTML Perpustakaan ini menggunakan Delphi Markdown Library. Terima kasih, Grahame Grieve untuk perpustakaan yang hebat ini!

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