Instalação e instalação Configuração em plataformas Apple

O Firebase Realtime Database é um banco de dados hospedado na nuvem. Os dados são armazenados como JSON e sincronizados em tempo real para cada cliente conectado. Quando você cria aplicativos multiplataforma com nossos SDKs para Android, iOS e JavaScript, todos os seus clientes compartilham uma instância do Realtime Database e recebem automaticamente atualizações com os dados mais recentes.

O Firebase Realtime Database está disponível em todas as plataformas Apple, incluindo iOS, macOS, macOS Catalyst, tvOS e watchOS. Não está disponível para clipes de aplicativos. As instruções de configuração nesta página fazem referência ao iOS em exemplos específicos, mas são genéricas e funcionam para qualquer plataforma Apple alvo.

Pré-requisitos

  1. Instale o SDK do Firebase .
  2. Adicione seu aplicativo ao projeto do Firebase no console do Firebase .

Crie um banco de dados

  1. Navegue até a seção Realtime Database do console do Firebase . Você será solicitado a selecionar um projeto existente do Firebase. Siga o fluxo de trabalho de criação de banco de dados.

  2. Selecione um modo de inicialização para suas regras de segurança do Firebase:

    Modo de teste

    Bom para começar a usar as bibliotecas de cliente móvel e web, mas permite que qualquer pessoa leia e substitua seus dados. Após o teste, revise a seção Entenda as regras do Firebase Realtime Database .

    Para começar a usar o SDK da Web, Apple ou Android, selecione testmode.

    Modo bloqueado

    Nega todas as leituras e gravações de clientes móveis e da Web. Seus servidores de aplicativos autenticados ainda poderão acessar seu banco de dados.

  3. Escolha um local para o banco de dados.

    Dependendo da localização do banco de dados , a URL do novo banco de dados estará em um dos seguintes formatos:

    • DATABASE_NAME .firebaseio.com (para bancos de dados em us-central1 )

    • DATABASE_NAME . REGION .firebasedatabase.app (para bancos de dados em todos os outros locais)

  4. Clique em Concluído .

Ao ativar o Realtime Database, ele também ativa a API no Cloud API Manager .

Adicione o Firebase Realtime Database ao seu aplicativo

Use o Swift Package Manager para instalar e gerenciar dependências do Firebase.

  1. No Xcode, com o projeto do seu aplicativo aberto, navegue até File > Add Packages .
  2. Quando solicitado, adicione o repositório SDK das plataformas Apple do Firebase:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Escolha a biblioteca do Realtime Database.
  4. Adicione o sinalizador -ObjC à seção Outros sinalizadores de vinculador das configurações de compilação do seu destino.
  5. Quando terminar, o Xcode começará automaticamente a resolver e baixar suas dependências em segundo plano.

Configurar regras de segurança do Realtime Database

O Realtime Database fornece uma linguagem de regras declarativas que permite definir como seus dados devem ser estruturados, como devem ser indexados e quando seus dados podem ser lidos e gravados.

Configurar o Firebase Realtime Database

Você deve inicializar o Firebase antes de qualquer referência de aplicativo do Firebase ser criada ou usada. Se você já fez isso para outro recurso do Firebase, pode pular esta etapa.

  1. Importe o módulo FirebaseCore em seu UIApplicationDelegate , bem como quaisquer outros módulos Firebase que seu delegado de aplicativo usa. Por exemplo, para usar o Cloud Firestore e o Authentication:

    SwiftUI

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Rápido

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objetivo-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. Configure uma instância compartilhada FirebaseApp no ​​método application(_:didFinishLaunchingWithOptions:) delegado do seu aplicativo:

    SwiftUI

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Rápido

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Objetivo-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. Se estiver usando SwiftUI, você deve criar um delegado de aplicativo e anexá-lo à estrutura App por meio de UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor . Você também deve desativar o swizzling de delegado do aplicativo. Para obter mais informações, consulte as instruções do SwiftUI .

    SwiftUI

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
  4. Crie uma referência ao seu banco de dados e especifique o local onde deseja gravar.

    Rápido

    Observação: este produto do Firebase não está disponível no destino App Clip.
    var ref: DatabaseReference!

ref = Database.database().reference()

    Objetivo-C

    Observação: este produto do Firebase não está disponível no destino App Clip.
    @property (strong, nonatomic) FIRDatabaseReference *ref;

self.ref = [[FIRDatabase database] reference];

Próximos passos