FB4D

FB4D-A biblioteca de plataforma cruzada OpenSource para Firebase

O banco de dados do Google Firebase Cloud é usado em muitos aplicativos móveis e da Web em todo o mundo e existem bibliotecas bem documentadas para muitos idiomas e plataformas. Para a Delphi, a biblioteca de plataformas cruzadas FB4D suporta o banco de dados Firestore , o banco de dados em tempo real do Firebase , o armazenamento do Firebase (para armazenamento de arquivos), funções do Firebase (para funções de servidor de chamadas) e Vision ML . Para autenticação, o FB4D atualmente suporta autenticação por email/senha e login anônimo.

A biblioteca se baseia no Firebase Rest-API e fornece toda a funcionalidade com métodos síncronos e assíncronos para o uso no aplicativo da GUI, serviços e threads em segundo plano. Ambas as estruturas VCL e Firemonkey são suportadas. A biblioteca é uma biblioteca de código -fonte pura e conta com interfaces de classe. Para um código de aplicativo limpo e curto, ele suporta design de interface fluente.

Wiki

Este projeto oferece um wiki. Sete aplicativos de exemplo de plataforma cruzada com base no Firemonkey e três aplicativos de amostra VCL e um iniciado no wiki ajudarão você a começar a trabalhar com a biblioteca. Para perguntas mais detalhadas, a referência da interface fornecerá as respostas necessárias.

Você pode encontrar mais vídeos de aprendizado no seguinte canal do YouTube.

Principais mudanças log

Este log informa sobre alterações de interface e importantes aprimoramentos da biblioteca que precisam da atenção dos usuários desta biblioteca.

• Outubro de 2024: o Serviço Geminiai adicionado, uma nova guia no aplicativo DemofB4D demonstra a funcionalidade;
• Agosto de 2024: refatoração e muitas melhorias no aplicativo Demofb4D ;
• Junho de 2024: Adicionando TOTDMAPPEROPTIONS para controlar o comportamento do mapeador Objeto a Doc. O aplicativo de demonstração FMX simples FSOBJ2DOC demonstra o mapeador Objeto a documento e foi adicionado ao grupo de projetos de amostras FB4D. Adicione IfirestoreWriteTransaction.TransFormDoc para setServertime, incremento, máximo, mínimo;
• Februar 2024: Migrar para Delphi Athene;
• Dezembro de 2023: O objeto para documentar o Mapper permite sincronizar rapidamente seus objetos Pascal com o banco de dados Firestore, derivando sua própria classe do TFIRestoredocument e adicionando variáveis de membros. Todas as variáveis de membro são escritas automaticamente no documento e lidas no documento. O aplicativo de amostra FSOBJ2DOC demonstra a funcionalidade;
• Outubro de 2023: A transação de gravação de banco de dados Firestore também suporta o Documento Excluir. O aplicativo de demonstração auth_self_selfreg_vcl explica todas as opções do fluxo de trabalho de auto -registro;
• Junho de 2023: O banco de dados Firestore suporta transações de gravação;
• Outubro de 2022: Interface para ML Vision Service adicionado;
• Abril de 2021: ouvinte revisado RT DB ;
• Março de 2021: Novo cache opcional para acelerar o acesso repetido a objetos de armazenamento. Método adicional do IFireBaseSestorage.GetAndDownload para simplificar o download do armazenamento. Veja mais detalhes
  Nova opção na estrutura do FB4D.SelSereDistrationFra para suportar o nome de exibição e upload da imagem do perfil ao registrar um novo usuário. Veja mais detalhes
  A criação do banco de dados em tempo real mudou no console do Firebase. O ID do Firebase não é mais suficiente para acessar o RT DBS recém -criado. Agora é necessário um URL do Firebase, que também pode incluir o local do servidor. Veja mais detalhes.
  Um novo ouvinte detecta alterações no banco de dados Firestore sem agrupamento. Veja mais detalhes.

Pré -requisitos

Os projetos de amostra são desenvolvidos e preparados para Delphi 12.2 Atenas .

? Esta biblioteca requer pelo menos Delphi 10.3 Rio Update 2 ?.

Dica: o suporte de Delphi 10 Seattle para Delphi 10.2 Tóquio foi descontinuado desde a introdução do ouvinte Firestore em março de 2021. Delphi 10.3 Atualização 1 e versão anterior não são mais suportadas devido a um problema no RTL.

Delphi é uma marca registrada da Embarcadero Technologies, Inc.

Plataformas suportadas

O FB4D é desenvolvido em Pascal Pure Object e pode ser usado com o Firemonkey em todas as plataformas suportadas. Atualmente, a biblioteca e seus projetos de amostra são testados com Win64/Win32, Mac64/32, Linux64 usando FMXLINUX, iOS64 e Android. (Dica nas plataformas móveis: o tokenjwt para executar a verificação do token requer a instalação das bibliotecas OpenSSL). Para obter mais informações sobre o uso do OpenSSL, consulte a instalação do OpenSSL

Dicas para Windows

No aplicativo Demofb4D , o navegador Edge é usado para exibir o Markdown como HTML e PDF. Para fazer isso, é necessário instalar o SDK do WebView2 ou pelo menos copiar o webview2loader.dll no seu diretório executável. Leia mais sobre WebView2 e TwebBrowser no Wiki de Embarcadero. Essa atualização é necessária apenas sob Win32 e Win64.

Limitação no Android para VisionML

O AnoTatefile é limitado apenas ao PDF, pois o suporte ao GIF não funciona devido ao RSP-17682 e o formato da imagem TIF ainda não é suportado.

Limitação no iOS para VisionML

O AnnoTateFile é limitado apenas a PDF, pois o formato de imagem GIF e TIF ainda não é suportado pelo FMX.Graphics. Você não pode converter um TBITMAP em um dos formatos de imagem exigidos pelo VisionML com a biblioteca padrão.

Limitação no Linux64

Não há restrições ao usar o Delphi 11 Alexandria ou superior.

Para versões mais antigas de até 10.4.2, você deve observar o seguinte RSP: devido a um bug no Linux RTL, todas as solicitações HTTP que transferem dados para o servidor usando o método do patch não estão funcionando. Os métodos de colocar e postar funcionam. Isso afeta o patch do método DB em tempo real e o método Firestore InserttorOpDatedocument para acessos síncronos e assíncronos. Para mais informações, consulte o RSP-33177.

Submódulos

Nota importante sobre as alterações do caminho: desde a introdução de Gemini AI (v1.6.5.631) a pasta Jose é movida para submódulos/Delphi-jose-jwt porque o submódulo adicional Delphi-Markup foi adicionado. Após o Git Pull, atualize os dois submódulos com a git submodule update --remote --merge ou use sua ferramenta Git favorita para esta atualização.

Delphi-jose-jwt

Para verificação de token de autorização e extração de conteúdo de token Esta biblioteca usa a biblioteca Delphi Jose JWT. Obrigado, Paolo Rossi pela sua excelente biblioteca!

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

Delphi-Markdown

Para converter o texto formatado em marcação em HTML, esta biblioteca usa a Biblioteca Delphi Markdown. Obrigado, Grahame Grieve por esta ótima biblioteca!

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