FB4D

FB4D-La biblioteca de plataforma cruzada de OpenSource para Firebase

La base de datos de Google Firebase Cloud se utiliza en muchas aplicaciones móviles y web en todo el mundo y hay bibliotecas bien documentadas para muchos idiomas y plataformas. Para Delphi, la biblioteca multiplataforma FB4D admite la base de datos Firestore , la base de datos de Firebase Real Time , el almacenamiento de Firebase (para almacenamiento de archivos), las funciones de Firebase (para llamar a las funciones del servidor) y Vision ML . Para la autenticación, FB4D actualmente admite autenticación de correo electrónico/contraseña e inicio de sesión anónimo.

La biblioteca se basa en Firebase REST-API y proporciona toda la funcionalidad métodos sincrónicos y asincrónicos para el uso dentro de la aplicación GUI, los servicios y los hilos de fondo. Se admiten ambos marcos VCL y Firememonkey . La biblioteca es una biblioteca de código fuente puro y se basa en interfaces de clase. Para un código de aplicación limpio y corto, admite el diseño de interfaz fluida.

Wiki

Este proyecto ofrece un wiki. Siete aplicaciones de ejemplo de plataforma cruzada basadas en aplicaciones de muestra de Firemonkey y tres VCL y un inicio en el wiki lo ayudará a comenzar a trabajar con la biblioteca. Para preguntas más detalladas, la referencia de interfaz proporcionará las respuestas que necesita.

Puede encontrar más videos de aprendizaje en el siguiente canal de YouTube.

Registro de cambio importante

Este registro informa sobre los cambios en la interfaz y las importantes mejoras de la biblioteca que necesitan la atención de los usuarios de esta biblioteca.

• Octubre de 2024: Servicio Geminiai agregado, una nueva pestaña en la aplicación DemOfB4D demuestra la funcionalidad;
• Agosto de 2024: Refactorización y muchas mejoras en la aplicación DemOfB4D ;
• Junio de 2024: Agregar TOTDMapperOptions para controlar el comportamiento del mapeador de objeto a doc. La simple aplicación de demostración de FMX FSOBJ2DOC demuestra el mapeador de objeto a documento y se ha agregado al grupo de proyectos de muestras FB4D. Agregue ifirestoreWriteTransaction.transformdoc para setservertime, incremento, máximo, mínimo;
• Februar 2024: migra a Delphi Athene;
• Diciembre de 2023: El objeto para documentar mapper le permite sincronizar rápidamente sus objetos Pascal a la base de datos Firestore derivando su propia clase de tfirestoredOcument y agregando variables miembros. Todas las variables de los miembros se escriben automáticamente en el documento y se leen del documento. La aplicación de muestra FSOBJ2DOC demuestra la funcionalidad;
• Octubre de 2023: la transacción de escritura de la base de datos Firestore también admite Delete Document. La aplicación de demostración Auth_Selfreg_VCl explica todas las opciones del flujo de trabajo de registro automático;
• Junio de 2023: la base de datos Firestore admite transacciones de escritura;
• Octubre de 2022: interfaz para el servicio de visión ML agregado;
• Abril de 2021: oyente revisado de RT DB ;
• Marzo de 2021: Nuevo caché opcional para acelerar el acceso repetido a los objetos de almacenamiento. Método adicional ifirebaseStorage.getanddownload para simplificar la descarga del almacenamiento. Ver más detalles
  Nueva opción en FB4D.SelfEgistrationFra Framework para admitir Ingrese el nombre de la pantalla y la imagen de perfil de carga al registrar un nuevo usuario. Ver más detalles
  La creación de bases de datos en tiempo real ha cambiado dentro de la consola Firebase. La identificación de Firebase ya no es suficiente para acceder a RT DBS recién creado. Ahora se requiere una URL de Firebase, que también puede incluir la ubicación del servidor. Ver más detalles.
  Un nuevo oyente detecta cambios dentro de la base de datos Firestore sin agrupar. Ver más detalles.

Requisitos previos

Los proyectos de muestra se desarrollan y preparan para Delphi 12.2 Atenas .

? Esta biblioteca requiere al menos Delphi 10.3 Rio Update 2 ?

Sugerencia: el soporte de Delphi 10 Seattle a Delphi 10.2 Tokio ha sido descontinuado desde la introducción del oyente de Firestore en marzo de 2021. Delphi 10.3 La actualización 1 y la versión anterior ya no son compatibles con un problema en el RTL.

Delphi es una marca registrada de Embarcadero Technologies, Inc.

Plataformas compatibles

FB4D se desarrolla en Pure Object Pascal y se puede usar con Firemonkey en todas las plataformas compatibles. La biblioteca y sus proyectos de muestra se prueban actualmente con Win64/Win32, Mac64/32, Linux64 usando FMXLinux, iOS64 y Android. (Sugerencia a las plataformas móviles: el tokenjwt para realizar la verificación del token requiere la instalación de las bibliotecas OpenSSL). Para obtener más información sobre el uso de OpenSSL, consulte la instalación de OpenSSL

Sugerencias para Windows

En la aplicación DemoFB4D , el navegador web Edge se usa para mostrar Markdown como HTML y PDF. Para hacer esto, es necesario instalar el SDK de WebView2 o al menos copiar webView2Loader.dll en su directorio ejecutable. Lea más sobre WebView2 y Twebbrowser en Wiki de Embarcadero. Esta actualización solo es necesaria bajo Win32 y Win64.

Limitación en Android para VisionML

AnnotateFile se limita solo a PDF, ya que el soporte de GIF no funciona debido a RSP-17682, y el formato de imagen TIF aún no es compatible.

Limitación de iOS para visión de visión

AnnotateFile se limita solo a PDF, ya que el formato de imagen GIF y TIF aún no es compatible con FMX.Graphics. No puede convertir un TBITMAP a uno de los formatos de imagen requeridos por VisionML con la biblioteca estándar.

Limitación en Linux64

No hay restricciones al usar Delphi 11 Alexandria o superior.

Para versiones anteriores de hasta 10.4.2, debe observar el siguiente RSP: Debido a un error en el Linux RTL, todas las solicitudes HTTP que transfieren datos al servidor utilizando el método de parche no funcionan. Los métodos de poner y publicar funcionan. Esto afecta el parche del método DB en tiempo real y el método Firestore InsertorUpdatedOcument para accesos sincrónicos y asincrónicos. Para más información, consulte RSP-33177.

Submódulos

Nota importante sobre los cambios de ruta: desde la introducción de Gemini AI (V1.6.5.631) la carpeta Jose se mueve a submódulos/Delphi-Jose-JWT porque se agregó el submódulo adicional Delphi-Markup. Después de Git Pull, actualice ambos submódulos con el comando BASH BASH git submodule update --remote --merge o use su herramienta Git favorita para esta actualización.

Delphi-jose-jwt

Para la autorización de verificación del token y extracción de contenido de token Esta biblioteca utiliza la biblioteca Delphi Jose JWT. ¡Gracias, Paolo Rossi por su gran biblioteca!

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

Delphi-Markdown

Para convertir el texto formateado por Markdown en HTML, esta biblioteca utiliza la biblioteca de Delphi Markdown. ¡Gracias, Grahame Grieve por esta gran biblioteca!

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