Repolode
Enviar
groue

groue/GRDB.swift

Toolkit Swift para bancos de dados SQLite, com persistência de registros, interface de consultas, migrações e observação do banco para desenvolvimento de apps.

Ver no GitHub
Estrelas
8,726
Forks
1,108
Issues abertas
13
Último commit
há 3 dias

O que é?

GRDB.swift é uma biblioteca Swift para salvar dados de aplicativos em bancos de dados SQLite. Ela permite mapear structs e classes Swift para tabelas e oferece métodos para buscar e persistir dados, evitando que você precise escrever SQL e lidar com linhas brutas nas operações comuns, sem deixar de permitir o uso de SQL puro quando necessário.

A biblioteca oferece uma interface de consultas Swift para montar requisições, um sistema de migrações para evoluir o schema entre versões do app e suporte a busca de texto completo. A observação do banco de dados envia notificações quando os valores armazenados mudam, com integração pronta para Swift concurrency, Combine e RxSwift. As conexões com o banco podem ser do tipo DatabaseQueue ou DatabasePool; o segundo usa o modo WAL para permitir leituras e gravações simultâneas.

GRDB é compatível com iOS, macOS, tvOS e watchOS e pode ser instalado pelo Swift Package Manager, CocoaPods ou manualmente. Bibliotecas complementares oferecem integração com SwiftUI e testes de snapshot do conteúdo do banco de dados.

Recursos principais

  • 01Mapeie structs e classes Swift para tabelas com métodos integrados de busca e persistência.
  • 02Interface de consultas Swift para montar requisições SQL, além de SQL puro com vinculação segura de argumentos.
  • 03Migrações de schema para evoluir o banco de dados entre versões do app.
  • 04Observação do banco de dados que notifica sobre alterações, com suporte a Combine, RxSwift e sequências assíncronas.
  • 05Tipos de conexão DatabaseQueue e DatabasePool, com modo WAL para leituras e gravações simultâneas.
  • 06Busca de texto completo e criptografia opcional com SQLCipher.

Casos de uso

  • Persistir dados de usuários e modelos em um app para iOS ou macOS.
  • Observar alterações no banco de dados para manter as views do SwiftUI ou UIKit atualizadas.
  • Gerenciar alterações de schema entre versões sucessivas do app com migrações.
  • Criar apps offline-first que armazenam dados localmente em SQLite.

Início rápido

  1. 1

    Adicione o GRDB ao seu projeto com o Swift Package Manager usando a URL do repositório

  2. 2

    Importe o GRDB e abra uma conexão com o banco de dados

Antes de usar

  • Tem como alvo as plataformas Apple (iOS, macOS, tvOS, watchOS) e requer Swift 6.1 ou posterior.
  • Carthage não é compatível, e não é possível publicar novas versões no CocoaPods; por isso, versões posteriores exigem uma solução alternativa com uma branch ou tag do git.

Em coleções

Apps open source para MacBancos de dados e ferramentas SQL

Tópicos

#sqlite#swift#orm#database-observation#sql-builder#ios#macos#database#grdb#spm

Perguntas frequentes

O que é GRDB.swift?
Toolkit Swift para bancos de dados SQLite, com persistência de registros, interface de consultas, migrações e observação do banco para desenvolvimento de apps. GRDB.swift é uma biblioteca Swift para salvar dados de aplicativos em bancos de dados SQLite. Ela permite mapear structs e classes Swift para tabelas e oferece métodos para buscar e persistir dados, evitando que você precise escrever SQL e lidar com linhas brutas nas operações comuns, sem deixar de permitir o uso de SQL puro quando necessário.
GRDB.swift é gratuito? Qual é a licença?
GRDB.swift é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
GRDB.swift ainda é mantido?
Manutenção ativa. O último commit de GRDB.swift foi em 5 de nov. de 2026.
Para que posso usar GRDB.swift?
Persistir dados de usuários e modelos em um app para iOS ou macOS. Observar alterações no banco de dados para manter as views do SwiftUI ou UIKit atualizadas. Gerenciar alterações de schema entre versões sucessivas do app com migrações. Criar apps offline-first que armazenam dados localmente em SQLite.
Como instalar GRDB.swift?
Adicione o GRDB ao seu projeto com o Swift Package Manager usando a URL do repositório Importe o GRDB e abra uma conexão com o banco de dados
Onde consigo GRDB.swift?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/groue/GRDB.swift

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados