Instalação e 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 apps multiplataforma com nossos SDKs para iOS, Android 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. Porém, não está disponível para Clipes de apps. 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 com qualquer destino da plataforma Apple.

Pré-requisitos

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

Criar um banco de dados

  1. Acesse a seção Realtime Database do console do Firebase: Aparecerá uma solicitação para selecionar um projeto atual do Firebase. Siga o fluxo de trabalho de criação do banco de dados.

  2. Selecione um modo inicial para as Firebase Security Rules:

    Modo de teste

    Esse modo é ideal para começar a usar as bibliotecas de cliente em dispositivos móveis e na Web, mas ele permite que qualquer pessoa leia e substitua os dados. Após o teste, leia a seção Noções básicas das regras do Firebase Realtime Database.

    Selecione o modo de teste para começar a usar o SDK para Android, Apple ou Web.

    Modo bloqueado

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

  3. Escolha um local para o banco de dados.

    Dependendo do local, o URL do novo banco de dados terá 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.

Quando você ativa o Realtime Database, ele também ativa a API no Gerenciador de APIs do Cloud.

Adicionar o Firebase Realtime Database ao app

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

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

Configurar o Realtime Database Security Rules

O Realtime Database oferece uma linguagem declarativa de regras para que você defina como os dados devem ser estruturados e indexados e quando podem ser lidos e gravados.

Configurar Firebase Realtime Database

Você deve inicializar o Firebase antes de criar ou usar qualquer referência para um app do Firebase. Caso já tenha feito isso para outro recurso do Firebase, pule essa etapa.

  1. Importe o módulo FirebaseCore no UIApplicationDelegate, assim como qualquer outro módulo do Firebase usado pelo delegado do app. Por exemplo, para usar Cloud Firestore, Authentication e:

    SwiftUI

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

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

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

    SwiftUI

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

    Swift

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

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. Se você estiver usando a SwiftUI, crie um delegado do aplicativo e o anexe ao struct App via UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor. Também é necessário desativar o swizzling do delegado do app. Para mais informações, consulte as instruções da 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 em que você quer gravar.

    Swift

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

ref = Database.database().reference()

    Objective-C

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

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

Próximas etapas